# 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.