An open-source, multi-lingual web application dedicated to the history, traditions, and celebrations of the Persian New Year.
(Lion and Sun Flag)
Our goal is to build a beautiful, fast, and informative platform for people around the world to learn about Nowruz.
- Scaffolding & Architecture: Initialize Next.js 16 App Router.
- Design System: Establish a premium UI using Shadcn and Tailwind CSS V4, themed with the Nowruz palette (Green, Gold, Red, Cream). Build custom SVG React components for the Haft-sin items with Framer Motion animations.
- Internationalization (i18n): Implement a robust
next-intlfoundation. Set up the English (en) locale structure as the baseline. - AI Accessibility: Build a dedicated API route (
/api/content?page=[name]) that outputs clean, semantic Markdown data for AI web scrapers. - Production Build: Fix all TypeScript strict type checks and ESLint warnings.
- Content Expansion: Write detailed markdown articles for the History, Traditions, and Sizdah Bedar pages.
- Multi-lingual Support: Add Persian/Farsi (RTL) and other LTR languages (French, Spanish, Dutch) simply by extending the JSON dictionaries.
- Dynamic Content Management: Consider migrating from static markdown strings to an integrated MDX system for richer content formatting.
- Framework: Next.js 16 (App Router, Server Components)
- Styling: Tailwind CSS v4
- UI Components: Shadcn UI
- Animations: Framer Motion
- Icons: Lucide React
- Internationalization: next-intl
- Theming:
next-themes(Dark/Light mode support)
To run the project locally on your machine:
-
Clone the repository:
git clone https://github.com/thek1/nowruz.wiki.git cd nowruz.wiki -
Install dependencies:
npm install
-
Start the development server:
npm run dev
-
Open http://localhost:3000 with your browser to explore the traditions.
This project is optimized for deployment on Vercel with a custom domain managed by Cloudflare.
- Connect your GitHub repository to Vercel.
- Vercel will automatically detect the Next.js framework and handle the build process.
- Configure your Cloudflare DNS with the provided Vercel A/CNAME records.
Built with ❤️ for the Nowruz community.