Overview
The AWS Terraform Starter Kit provides a production-ready baseline for building, testing, and deploying AWS infrastructure. Use it to understand the architecture, tooling, and workflows that keep projects consistent and auditable.
Key features
| Feature | Description |
|---|---|
| One-command setup | make setup automates S3 backend with native state locking (Terraform 1.10+) and GitHub OIDC |
| Multi-environment | Isolated state files and environment-specific deployments |
| Secure CI/CD | GitHub Actions with OIDC (no long-lived credentials) |
| Security scanning | TFLint and Checkov for code quality and vulnerability detection |
| Modular architecture | Reusable OIDC provider module for maintainable infrastructure |
What's inside
- Automated backend bootstrap - S3 state storage with encryption and native state locking (Terraform 1.10+)
- Makefile-powered commands - Validation, deployment, and cleanup workflows
- GitHub Actions with OIDC - Secure deploys without long-lived secrets
- Multi-environment configuration - Test, staging, and production support
- Reusable OIDC module - GitHub Actions authentication in a single module
- TFLint and Checkov - Comprehensive code quality and security checks
Who is this for
Infrastructure engineers and DevOps teams who want a batteries-included Terraform starter. It standardizes CI/CD, state management, and security best practices so you can focus on building infrastructure.
Documentation map
| Section | What you'll learn |
|---|---|
| Install | Prerequisites, setup wizard, and first deployment |
| Guides | Local workflows, CI/CD behavior, and multi-environment management |
| Configuration | Project structure, environment setup, and customization |
| Reference | Makefile commands, modules, and security scanning |
Get started
Head to the Install guide to set up your first environment. Then work through the Guides for daily workflows, and use Configuration as you tailor the starter kit to your AWS accounts.