Production-ready AWS CDK TypeScript starter kit with secure OIDC authentication, automated CI/CD, and branch-based deployments. Deploy infrastructure to AWS in minutes with projen-powered configuration.
- ⚡ Rapid Setup: Jumpstart your project within minutes by tweaking a single configuration file (projen)
- Preconfigured TypeScript with optimized compiler settings in tsconfig.json
- Pre-configured linting & formatting with biome.jsonc for code quality
- Clean project structure for easy management of constructs and stacks
- 🛡️ Seamless Security: OIDC authentication for keyless AWS deployments - no stored credentials or long-lived secrets required
- 🤖 Automated CI/CD: Out-of-the-box GitHub Actions workflows with multi-account support for enterprise-ready deployments
- 💬 Automated CDK Diff on PRs: CDK diff outputs are automatically posted to your pull requests for easy infrastructure change reviews
- 💻 Branch-based Deployments: Deploy multiple CDK stacks to the same AWS environments based on Git branch for an improved multi-developer workflow
- 📦 Automated Dependency Management: Dependabot creates grouped PRs with auto-approval for passing checks, streamlining updates while maintaining stability
Tip
Stop AWS bill surprises from happening.
Most infrastructure changes look harmless until you see next month's AWS bill. CloudBurn prevents this by analyzing the cost impact of your AWS CDK changes directly in GitHub pull requests, catching expensive mistakes during code review when fixes are quick, not weeks later when they're costly and risky.
💰 Set it up once, then never be surprised by AWS costs again
- First install the free CDK Diff PR Commenter GitHub Action in your repository where you build your AWS CDK infrastructure
- Then install the CloudBurn GitHub App on the same repository
What happens now:
Whenever you open a PR with infrastructure changes, the GitHub Action comments with your CDK diff analysis. CloudBurn reads that diff and automatically adds a separate comment with a detailed cost report showing:
- Monthly cost impact – Will this change increase or decrease your AWS bill? By how much?
- Per-resource breakdown – See exactly which resources are driving costs (old vs. new monthly costs)
- Region-aware pricing – We pick the right AWS pricing based on the region where your infrastructure is deployed
Your team can now validate cost impact alongside infrastructure changes during code review. Essentially, this shifts FinOps left where you optimize costs as you code, not weeks later when context is lost and production adjustments require more time and carry added risk.
CloudBurn will be free during beta. After launch, a free Community plan (1 repository with unlimited users) will always be available.
This project requires at least Node.js version 22.
To get started, follow these steps:
-
Click the green "Use this template" button to create a new repository based on this starter kit.
-
Install the project dependencies using:
npm ci -
Customize the AWS Region and Account IDs in the .projenrc.ts file to match your AWS setup.
-
Run
npx projento generate the GitHub Actions workflow files. -
Ensure you're logged into an AWS Account via the AWS CLI.
-
Deploy the CDK toolkit stack with
cdk bootstrapif it's not already set up. -
Deploy the GitHub OIDC Stack to enable GitHub Actions workflow permissions for AWS deployments.
-
Commit and push your changes to the
mainbranch to trigger the CDK deploy pipeline in GitHub.
Congratulations! You've successfully set up your project.
For detailed setup instructions, architecture explanations, and advanced usage guides, visit the → official documentation.
A heartfelt thank you to the creators of projen. This starter kit stands on the shoulders of giants, made possible by their pioneering work in simplifying cloud infrastructure projects!
