# frontend/

## Files

| File | What | When to read |
| ---- | ---- | ------------ |
| `README.md` | Frontend quickstart and patterns | Getting started with frontend development |
| `package.json` | Dependencies and npm scripts | Adding dependencies, understanding build |
| `tsconfig.json` | TypeScript configuration | Compiler settings, path aliases |
| `vite.config.ts` | Vite build configuration | Build optimization, plugins |
| `eslint.config.js` | ESLint configuration | Linting rules, code style |
| `jest.config.ts` | Jest test configuration | Test setup |
| `tailwind.config.js` | Tailwind CSS configuration | Styling, theme customization |
| `index.html` | HTML entry point | SPA shell, meta tags |
| `nginx.conf` | Nginx server configuration | Production serving, SPA routing |
| `Dockerfile` | Container build definition | Docker builds, deployment |

## Subdirectories

| Directory | What | When to read |
| --------- | ---- | ------------ |
| `src/` | Application source code | Any frontend development |
| `public/` | Static assets (images, docs) | Adding static files |
| `cypress/` | E2E test definitions | End-to-end testing |
| `docs/` | Frontend-specific documentation | Frontend patterns, guidelines |
| `test/` | Test utilities and mocks | Test setup, mock data |
| `scripts/` | Frontend utility scripts | Automation scripts |
