Conventions
The practices this codebase follows — read before building any feature
Short, prescriptive rules with the grep gates to run before declaring work done. Last reconciled with the code 2026-07-02 — verify a claim against current code before acting on it.
Frontend conventions
Any change in apps/web — structure, data fetching, forms, UI tokens, auth, tests.
Backend conventions
Any change in apps/back or apps/scraper — layering, authorization, errors, types, logging.
Copy, don't invent
On the frontend these patterns are all live in the codebase — copy an existing feature (deals is the reference). On the backend, parts of the existing code don't follow the rules yet (see the plan) — new and edited code must; don't copy the legacy patterns.
Verification gates
Run before declaring any task done:
pnpm --filter @marketplace/web lint && pnpm --filter @marketplace/web exec tsc --noEmit
pnpm --filter @marketplace/web test
pnpm --filter @marketplace/web build # hermetic: falls back to empty sections if the API is unreachablepnpm --filter back lint && pnpm --filter back exec tsc --noEmit
pnpm --filter back test && pnpm --filter back buildEach conventions page lists the grep gates that must be clean in files you touched.