AWS CDK Starter Kit

Start here to understand the AWS CDK Starter Kit, why teams adopt it, and where to go next.


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). Use it to understand the architecture, tooling, and workflows that keep projects consistent and auditable as your team scales.

Why teams choose it

  • Single-file configuration via .projenrc.ts so Projen keeps every generated file in sync with your desired defaults
  • Branch-based ephemeral environments that make it easy to preview infrastructure changes safely
  • Secure GitHub Actions deployments using OpenID Connect (OIDC) instead of long-lived IAM credentials
  • Clear separation of reusable constructs and deployable stacks for maintainable codebases

What’s inside

  • Projen-powered CDK project scaffold and reproducible tasks
  • Opinionated project structure for constructs, stacks, and app assets under src
  • GitHub Actions with OIDC for secure deploys (no long‑lived secrets)
  • Branch-based ephemeral environments for easy previews
  • Multi-account, multi-region friendly configuration driven from .projenrc.ts

Who is this for

Developers who want a batteries‑included CDK starter that standardizes CI/CD, environments, and project layout so teams can focus on building infrastructure and applications instead of 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

  • Install — prerequisites, first deploy, and how to unlock CI/CD
  • Guides — local workflows, CI/CD behavior, and branch-based previews
  • Configuration — structure, environment matrix, and project customization
  • Reference — deep dives into constructs, aspects, helpers, and stack behaviors

Ready to get hands-on? Head straight to the Install guide, work through the Guides for daily workflows, then use the Configuration pages as you tailor the starter kit to your AWS accounts.