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, /notifications, /logout, /payments/result, /reset-password
• Admin: /admin/*

Validation

npm run lint
npm run build

Project-local design skills

Clone this repository to get the frontend skills in .agents/skills/. The set includes design-taste-frontend, vercel-react-best-practices, web-design-guidelines, ui-ux-pro-max, emil-design-eng, animate, entrance-motion, review-animations, playwright, and impeccable. Keep each skill's complete directory, including its references and scripts.

Shared team guidance is also vendored in .agents/skills/: grill-me, grilling, planning-and-task-breakdown, documentation-and-adrs, and git-workflow-and-versioning.

Impeccable also installs a GitHub Copilot copy in .github/skills/impeccable and design hook manifests in .codex/hooks.json and .github/hooks/impeccable.json. Its portable launcher downloads a verified platform binary on first use; downloaded binaries are ignored by Git. In Codex, approve the project hook through /hooks after cloning. The shared hook setting is in .impeccable/config.json.