Rental-operations-platform/CONTRIBUTING.md

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

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:

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.