Architecture Overview

Projects adopted from this starter should default to a modular monolith.

Core Expectations

• backend domain logic stays separate from infrastructure concerns
• interfaces remain thin
• dependency directions are explicit and documented
• cross-module coordination is intentional rather than accidental

Default Repository Shape

• core/backend/ for the NestJS backend workspace
• core/frontend/ for the React frontend workspace
• docs-site/ for curated docs
• docs/ for deeper implementation references
• infra/ for deployment and runtime contracts

Decision Rule

Use the default architecture unless there is a concrete reason to change it. If there is, explain the mismatch and ask before switching.