first commit

frontend/README.md

@@ -0,0 +1,40 @@
+# Desi Clans — Frontend
+
+React + Vite foundation for the public site and (later) admin UI.
+
+## Stack
+
+- React (JSX), Vite, Tailwind CSS v3, React Router, Axios, GSAP, Lucide React
+
+## Setup
+
+```bash
+cd frontend
+cp .env.example .env   # optional; empty VITE_API_URL uses dev proxy
+npm install
+npm run dev
+```
+
+App: [http://localhost:5173](http://localhost:5173)
+
+## Scripts
+
+| Command | Description |
+|---------|-------------|
+| `npm run dev` | Development server with HMR |
+| `npm run build` | Production build to `dist/` |
+| `npm run preview` | Preview production build |
+| `npm run lint` | Oxlint |
+
+## Structure
+
+See [../docs/ARCHITECTURE.md](../docs/ARCHITECTURE.md) for the target `src/` layout.
+
+## Design system
+
+Reusable primitives live in `src/components/` (barrel: `src/components/index.js`).
+
+- Home (mock marketing): [http://localhost:5173/](http://localhost:5173/)
+- Event detail (mock): [http://localhost:5173/events/rang-barse-palace-grounds-2026](http://localhost:5173/events/rang-barse-palace-grounds-2026)
+- Design system catalog: [http://localhost:5173/system](http://localhost:5173/system)
+