The Twelve-Factor App
Twelve factors for building software-as-a-service applications that are portable, declarative and ready to scale, written at Heroku from experience operating hundreds of thousands of apps.
Canonical text: https://12factor.net/.
The twelve factors
- Codebase. One codebase tracked in revision control, many deploys.
- Dependencies. Explicitly declare and isolate dependencies.
- Config. Store config in the environment.
- Backing services. Treat backing services as attached resources.
- Build, release, run. Strictly separate build and run stages.
- Processes. Execute the app as one or more stateless processes.
- Port binding. Export services via port binding.
- Concurrency. Scale out via the process model.
- Disposability. Maximize robustness with fast startup and graceful shutdown.
- Dev/prod parity. Keep development, staging and production as similar as possible.
- Logs. Treat logs as event streams.
- Admin processes. Run admin and management tasks as one-off processes.
Facts
- Maintainer
- Adam Wiggins, Heroku
- Repository
- https://github.com/heroku/12factor
- First published
- 2011
- Status of the text
- stable
- Listing
- listed, not yet claimed
Read with
- claimed
12-Factor AI-enabled CLI
Twelve testable factors for a command-line tool whose operator may be a human or an AI agent, from machine-readable capabilities to meaningful exit codes, with a conformance gate.
v0.1 Agentic Stack -
12-Factor Agents
Principles for building LLM-powered software reliable enough to put in front of production customers, modelled on the Twelve-Factor App and maintained in the open.
Badge
[](https://manifesto.md/12-factor-app/) Maintainers claim a listing with a pull request setting listing: claimed, or a yes on the listing issue.