Frontend Setup

The React frontend is in the frontend/ directory.

1. Install Dependencies

cd frontend
npm install

2. Environment Configuration

Create a .env file (or copy the example):

VITE_API_URL=http://localhost:8000

This tells the frontend where the backend API is running.

3. Start Development Server

npm run dev

The frontend is now available at http://localhost:5173.

4. Build for Production

npm run build

The static build output goes to frontend/dist/. Serve this directory from any web server, CDN, or S3 bucket — no Node.js server needed in production.

Project Structure

frontend/src/
├── pages/            # Route pages (auth, org, admin, custom)
├── components/       # Reusable React components
│   └── ui/           # Shadcn UI primitives
├── stores/           # Zustand state stores
├── hooks/            # Custom React hooks
├── lib/              # Utilities (axios, etc.)
├── types/            # TypeScript type definitions
├── custom/           # Your custom routes & nav items
├── config/           # Theme presets, app config
├── App.tsx           # Main router
└── main.tsx          # Entry point