Configuration

Configure environments, structure your project, and customize the CDK starter kit for your organization.


Overview

This section shows you how the repository is laid out and how to configure multi-account deployments, including branch-based previews. Everything flows from .projenrc.ts - your single source of truth.

Pages in this section

PageWhat you'll learn
Project StructureDirectory layout, where to add constructs, stacks, and application code
EnvironmentsAccount/region matrix, branch deploys, environment variables
CI/CD WorkflowsWhat happens on push, environment chaining, monitoring runs
Usage ExamplesAnnotated snippets for extending stacks and constructs

Quick reference

Change environments? Edit environmentConfigs in .projenrc.ts, then run npx projen.

Add a new stack? Create the file in src/stacks/, export from index.ts, instantiate in src/main.ts.

Looking for stack details? See the Stacks reference for FoundationStack and StarterStack usage.