Skip to content

Production environment templates

Problem

Only .env.local.template files existed for local dev. No documentation of which secrets are required per production environment. New team members or CI/CD setup requires reverse-engineering from Zod schemas.

Proposal

Add .env.production.template to each app listing all required production vars (values redacted), grouped by category, with REQUIRED markers.

Acceptance criteria

  • apps/lms/.env.production.template created
  • apps/cms/.env.production.template created
  • Variables grouped by category (Auth, Database, CMS, Rate Limiting, Email, Storage)
  • REQUIRED markers on mandatory vars
  • Pool tuning vars included with recommended defaults

Out of scope

  • Deployment automation / scripts
  • Vercel project linking CLI commands

Notes / decisions log

  • 2026-07-07: Proposed. Templates should document the production env surface area; vars not needed in production (like AUTH_TEST_MODE) remain omitted.
  • 2026-07-09: Deferred — moved to tickets/deferred/; no active implementation planned.