The 12-Factor App in 2025: What Still Applies and What's Changed

The 12-Factor App Was Written in 2012 Heroku's original 12-factor methodology is still widely referenced. Some factors are timeless. Others need updating for container-first, serverless, and cloud-native development. Here's an honest look at each factor in 2025. The Timeless Factors I. Codebase One codebase tracked in version control, many deploys. Still true. One repo, multiple environments (staging, production) via branches or tags. git flow: main → production, develop → staging # Or trunk-based: main → production directly II. Dependencies Explicitly declare and isolate dependencies. // package.json: explicit versions { "dependencies": { "express": "4.18.2", "prisma": "5.7.0" } } Docker extends this: FROM node:20-alpine pins the runtime too. III. Config Store config in the environment. // Never: const apiKey = 'sk-prod-abc123'; // Always: const apiKey = process.env.STRIPE_SECRET_KEY; Now validated with Zod at startup — smarter than raw process.env. IV. Backing Services Treat backing