init project

2026-06-25 19:06:59 -04:00
parent c5dfee6efb
commit 5d017f533a
349 changed files with 31330 additions and 0 deletions
@@ -0,0 +1,39 @@
+# Contributing to RentalDriveGo Web
+
+## Required runtime
+
+Use Node.js `24.17.0` and pnpm `11.9.0`. Exact dependency versions and the frozen lockfile are part of the architecture contract, not optional decoration.
+
+## Before editing
+
+1. Read `docs/PHASE_12_HANDOFF_v1.0.md` for component rules.
+2. Check `docs/IMPLEMENTATION_ISSUE_REGISTER_v1.1.csv` before adding copy, routes, claims, destinations, integrations, or evidence.
+3. Preserve `contracts/phase9` byte-for-byte.
+4. Consume component-facing tokens from `src/styles/component-tokens.css`.
+5. Use translation resources and route IDs rather than hard-coded visible copy or paths.
+
+## Required checks
+
+```bash
+pnpm install --frozen-lockfile
+pnpm validate
+pnpm format:check
+pnpm lint
+pnpm typecheck
+pnpm test:unit
+SITE_ORIGIN=http://127.0.0.1:3000 PUBLIC_RELEASE_APPROVED=false pnpm build
+pnpm test:e2e
+```
+
+Before packaging a reviewed release candidate:
+
+```bash
+pnpm manifest:generate
+pnpm validate:package
+```
+
+Do not regenerate visual snapshots merely to silence a failure. A consistently wrong screenshot is still wrong, just more organized.
+
+## Architecture changes
+
+Changes to routing, localization loading, token authority, theme persistence, CSP, styling system, state management, metadata generation, or the server/client boundary require an ADR before implementation.