06.1 Workspace manifest
Workspace.proj structure—identity, members, overrides, registries."
Workspace manifest
Workspace.proj is the umbrella manifest for multi-project repos. It does not replace per-project Project.proj files—it coordinates them.
Building blocks
Section titled “Building blocks”workspace { ... }— workspace identity and resolver policymember "<label>" { path = "..." }— adds a project atpathoverride "<dep>" { version = "..." }— shared version policy (forward-looking as registry deps mature)registry "<name>" { url = "..." }— centralized registry endpoints
Why bother
Section titled “Why bother”| Without workspace | With workspace |
|---|---|
| Each project owns conflicting dep policy | Shared overrides |
| CI scripts special-case every folder | One lock/resolution story |
| ”Which Project.proj?” roulette | Explicit members |
Minimal mental picture
Section titled “Minimal mental picture”flowchart TD W[Workspace.proj] --> M1[member app] W --> M2[member lib] M1 --> P1[Project.proj] M2 --> P2[Project.proj]