gadget/gadget-code/AGENTS.md

AGENTS.md

Quick Commands

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)