Frontend

Stack

• Next.js App Router with React 18 and TypeScript.
• @tanstack/react-query for client-side authenticated flows.
• Tailwind CSS and shadcn/ui components.
• next-themes, Sonner, and toast helpers for RTL UI and notifications.

Environment

Copy .env.sample to .env.

Required variables:

• NEXT_PUBLIC_API_BASE_URL
• NEXT_PUBLIC_SITE_URL

Development

npm install
npm run dev

The local dev server runs on http://localhost:8080.

Production build

npm run build
npm run start

The production runtime serves on port 3000 inside Docker. Dockerfiles live only in guilan-ace-deployment.

Routes

• Public SEO pages: /, /about, /blog, /blog/[slug], /events, /events/[slug]
• Client-heavy flows: /auth, /profile, /logout, /payments/result, /reset-password/*, /verify-email/*
• Admin: /admin/*

Validation

npm run lint
npm run build