ADR-001: Monorepo Applications

Status

Accepted

Context

Admin, Resident, and documentation experiences have distinct routes and deployment needs, while the project is still early enough to avoid premature shared abstractions.

Decision

Use npm workspaces and Turborepo to coordinate three applications: apps/admin, apps/resident, and apps/docs. Keep reusable packages out of the repository until a real, stable shared need exists; packages/db is the first shared boundary.

Consequences

Each application can run and validate independently, while root commands coordinate the complete workspace. The database dependency boundary is shared, while cross-application code remains in its owning app until a genuine shared boundary is known.

Date

2026-09-17