Introducing atmos init and atmos scaffold: Get Started in Seconds
We're excited to announce two new commands that dramatically simplify getting started with Atmos: atmos init and atmos scaffold. These commands eliminate the manual setup process and help you bootstrap new Atmos projects or generate infrastructure code in seconds.
The Problem: Setup Friction
Setting up a new Atmos project has traditionally required several manual steps:
- Creating the project directory structure (
components/,stacks/,schemas/) - Writing a complete
atmos.yamlconfiguration file - Understanding the recommended patterns and conventions
- Setting up initial stack files and component configurations
For new users, this process could take hours and required deep knowledge of Atmos conventions. Even experienced users found themselves repeatedly creating similar boilerplate for new projects or infrastructure components.
The Solution: Instant Project Creation
atmos init: Bootstrap New Projects
The atmos init command creates a complete Atmos project from built-in templates with a single command:
# Interactive mode - guided setup with prompts
$ atmos init
? Select a template:
❯ simple - Basic Atmos project structure
atmos - Complete Atmos project with full configuration
? Enter project name: my-infrastructure
? Enter Terraform version: 1.5.0
? Enter default AWS region: us-west-2
? Enter target directory: ./my-infrastructure
Initializing my-infrastructure in ./my-infrastructure
✓ atmos.yaml
✓ README.md
✓ stacks/.gitkeep
✓ components/terraform/.gitkeep
Initialized 4 files.
For automation and CI/CD, use non-interactive mode:
$ atmos init atmos ./my-project \
--set project_name=my-infra \
--set terraform_version=1.5.0 \
--set aws_region=us-east-1 \
--no-interactive
atmos scaffold: Generate Infrastructure Code
The atmos scaffold commands help you generate infrastructure code from templates:
# Generate from a local scaffold template
$ atmos scaffold generate vpc-component ./components/terraform/vpc \
--set vpc_name=main \
--set cidr_block=10.0.0.0/16
Generating vpc-component in ./components/terraform/vpc
✓ main.tf
✓ variables.tf
✓ outputs.tf
✓ versions.tf
Initialized 4 files.
List available scaffold templates:
$ atmos scaffold list
Available scaffold templates:
Name Source Version Description