A modern, minimal web application for reading Persian poetry, built with Next.js 14 and TypeScript.

• Modern Design: Clean, minimal interface with RTL support
• Persian Typography: Beautiful Estedad and DoranFaNum fonts
• Smart Navigation: Search-enabled poets dropdown with famous poets section
• Mobile Optimized: Responsive design with mobile-specific dropdown behavior
• Performance Optimized: API caching, lazy loading, and Core Web Vitals monitoring
• SEO Ready: Comprehensive meta tags, sitemap, and structured data
• Enhanced UX: Expandable descriptions, category icons, and improved mobile experience
• Client-Side Features: View history, bookmarks, and font size control without user login
• Accessibility: Font size controls, keyboard shortcuts, and ARIA labels
• Offline-Ready: Local storage for user preferences and data persistence

• View History: Automatically tracks recently viewed poems (last 50 items)
• Bookmarks: Save favorite poems locally with search and filtering
• Font Size Control: Adjustable text size for better accessibility
• User Preferences: Persistent settings for theme, font size, and display options
• Performance Monitoring: Real-time tracking of Core Web Vitals and custom metrics
• Offline Storage: All user data stored locally using localStorage and IndexedDB

• Next.js 14 with App Router
• TypeScript for type safety
• Tailwind CSS v4 for styling
• Supabase for fast poem database (6 famous poets, 15K+ poems)
• Hybrid API - Supabase + Ganjoor API fallback
• next-themes for dark/light mode
• IndexedDB for view history storage
• localStorage for user preferences and bookmarks

For the easiest development experience, use our automated setup:

# One-click development setup
npm run dev:setup

# Or use the simple script
./dev-start.sh

If you prefer manual setup:

# Install dependencies
npm install

# Start development server
npm run dev

We provide several development scripts for different scenarios:

# Automated setup with error handling
npm run dev:setup

# Simple development start
npm run dev:simple

# Clean and reset everything
npm run dev:clean

# Full reset (nuclear option)
npm run dev:reset

# Build verification
npm run build:check

Open http://localhost:3000 with your browser to see the result.

Visit https://www.ganj.directory to see the live application.

• Hybrid API: Supabase for famous poets (10x faster) + Ganjoor API fallback
• Database Caching: 15,000+ poems cached in Supabase (50-200ms load time)
• Smart Fallback: Automatic fallback to Ganjoor API for comprehensive coverage
• API Caching: Smart caching with TTL and request deduplication
• Error Handling: Exponential backoff retry logic
• Canvas Optimization: Performance-optimized particle backgrounds
• Bundle Optimization: Tree shaking and lazy loading
• SEO Optimization: Dynamic sitemap generation and meta tags

The app uses a hybrid approach for optimal performance:

• Famous Poets (Supabase): Hafez, Saadi, Molavi, Ferdowsi, Attar, Nezami
• Other Poets (Ganjoor API): 200+ additional poets with fallback
• Performance: 10x faster loading for famous poets (50-200ms vs 800-2000ms)

See SUPABASE.md for complete setup and usage guide.

The application is deployed on Vercel and automatically updates on push to the main branch.

This project is open source and contributions are welcome!