gadget/gadget-code/AGENTS.md
2026-04-28 09:20:37 -04:00

35 lines
1.1 KiB
Markdown

# AGENTS.md
## Quick Commands
```bash
pnpm dev:backend # Backend on https://localhost:3443
pnpm dev:frontend # Frontend on https://localhost:5174
pnpm build # Build backend -> dist/ + frontend
pnpm test # Vitest unit tests
npx playwright test # E2E tests (requires running backend + frontend)
```
## Prerequisites
- Node.js 22+, pnpm 10+
- MongoDB on localhost:27017
- Redis on localhost:6379
- SSL certificates in `ssl/` directory
## Path Aliases
`@/*` maps to `src/*` (defined in tsconfig.json)
## Test quirks
- Vitest runs unit tests in `tests/**/*.test.ts` excluding `tests/e2e/`
- Playwright e2e tests target `https://code-dev.g4dge7.com:5174` (requires running dev servers)
## Build output
- Backend compiles to `dist/` (TypeScript)
- Frontend builds to `frontend/dist/`
## TypeScript strictness
strict, noUnusedLocals, noUnusedParameters, noUncheckedIndexedAccess all enabled
## Architecture
- Backend: Express 5 + Socket.io + Mongoose + Redis sessions
- Frontend: React 19 + Vite 8 + Tailwind CSS 4
- Entry points: `src/web-app.ts` (backend), `frontend/src/main.tsx` (frontend)