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.
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.