Skip to main content

Deployment and Environments

This guide defines the environment-level information worth publishing for developers evaluating the starter kit.

It should answer how the product is separated across local, preview, and production-style environments without turning into a maintainer-only runbook.

Public Documentation Scope​

  • environment purpose and expectations
  • deployment surfaces in the repo
  • high-level domain and URL shape
  • what changes between starter evaluation and production-ready setup
  • where deeper operational docs live

Keep These Internal​

  • secret management procedures
  • incident response steps
  • recovery and rollback runbooks
  • provider-specific maintenance commands

Those belong in docs/dev.

Repo-Level Pointers​

  • apps/marketing for the public marketing surface
  • apps/app for authenticated product surfaces
  • apps/docs for the published docs site
  • packages/backend for Convex backend logic