Codebase One Per App
One app, one repo. If you have two apps in one repo, split them. If you have one app in two repos, merge them.
$ prime install @backend-architecture/principle-codebase-one-per-app Projection
Always in _index.xml · the agent never has to ask for this.
CodebaseOnePerApp [principle] v1.0.0
A 12-factor app is tracked in a single codebase under version control. One codebase maps to many deploys (production, staging, every developer's laptop). Multiple apps sharing code is a violation — extract the shared code into a library that each app depends on.
One app, one repo. If you have two apps in one repo, split them. If you have one app in two repos, merge them.
Loaded when retrieval picks the atom as adjacent / supporting.
CodebaseOnePerApp [principle] v1.0.0
A 12-factor app is tracked in a single codebase under version control. One codebase maps to many deploys (production, staging, every developer's laptop). Multiple apps sharing code is a violation — extract the shared code into a library that each app depends on.
One app, one repo. If you have two apps in one repo, split them. If you have one app in two repos, merge them.
Applies To
- Each deployable service has exactly one source repository.
- All deploys (prod, staging, dev) build from the same codebase at different revisions.
- Shared code lives in a separate library, depended on like any other package.
Loaded when retrieval picks the atom as a focal / direct hit.
CodebaseOnePerApp [principle] v1.0.0
A 12-factor app is tracked in a single codebase under version control. One codebase maps to many deploys (production, staging, every developer's laptop). Multiple apps sharing code is a violation — extract the shared code into a library that each app depends on.
One app, one repo. If you have two apps in one repo, split them. If you have one app in two repos, merge them.
Applies To
- Each deployable service has exactly one source repository.
- All deploys (prod, staging, dev) build from the same codebase at different revisions.
- Shared code lives in a separate library, depended on like any other package.
Source
prime-system/examples/backend-architecture/primes/compiled/@backend-architecture/principle-codebase-one-per-app/atom.yaml