Overview
The AWS CDK Starter Kit gives you a production-ready baseline for building, testing, and deploying AWS infrastructure with the AWS Cloud Development Kit (CDK). Everything stays consistent and auditable as your team scales.
Mermaid diagram loading.Repository Structure Deployment Flow
Why teams choose it
- Single-file configuration via
.projenrc.ts- Projen keeps every generated file in sync with your desired defaults - Branch-based ephemeral environments - preview infrastructure changes safely before merging
- Secure GitHub Actions deployments - OpenID Connect (OIDC) instead of long-lived IAM credentials
- Clear separation of reusable constructs and deployable stacks for maintainable codebases
- Multi-account, multi-region friendly configuration driven from a single source of truth
What's inside
| Component | Description |
|---|---|
| Projen scaffold | Reproducible project setup with generated npm scripts and workflows |
| Project structure | Opinionated layout for constructs, stacks, and app assets under src/ |
| GitHub Actions | OIDC-based secure deploys with no long-lived secrets |
| Branch previews | Ephemeral environments for every feature branch |
| Environment matrix | Multi-account configuration from .projenrc.ts |
Who is this for
Developers who want a batteries-included CDK starter that standardizes CI/CD, environments, and project layout. Focus on building infrastructure, not wiring.
What you'll learn
- How to scaffold a new project and deploy your first stack
- How CI/CD and OIDC are wired for secure, automated deployments
- How to structure constructs and manage environments across stages
Documentation map
| Section | What you'll find |
|---|---|
| Install | Prerequisites, first deploy, and CI/CD setup |
| Guides | Local workflows, CI/CD behavior, branch-based previews |
| Configuration | Project structure, environment matrix, customization |
| Reference | Deep dives into constructs, aspects, helpers, stacks |
Ready to get hands-on? Start with the Install guide.