Developer Guide

Three-step journey for Astrolock developers.

---

Step 1: Provision AWS Backend

One-time setup per AWS account. Creates shared infrastructure for all your sites.

What You'll Create

• S3 bucket for Terraform state
• DynamoDB table for state locking
• ECR registry for Docker images
• IAM groups for access control (backend, sites, deployers)

Guide: Backend Setup Time: ~10 minutes Required: Admin AWS credentials

---

Step 2: Provision Site Infrastructure

Per-site setup. Creates hosting infrastructure for each Astrolock site.

What You'll Create

• S3 bucket for site files
• CloudFront CDN distribution
• SSL certificate (ACM)
• DNS records (optional Route53)
• Deployer IAM user with limited permissions

Guides:

• Site Provisioning - Create infrastructure
• Deploying Content - Deploy your site
• CI/CD Automation - GitHub Actions

Time: ~30 minutes (SSL cert validation) Required: Site provisioner credentials (from Step 1)

---

Step 3: Develop Astrolock

Modify Astrolock itself. Change the generator, add features, customize behavior.

What You'll Learn

• Install Astrolock for development
• Understand the dual-system architecture (Bashly CLI + Astro)
• Make common changes (styles, components, CLI commands)
• Test your modifications
• Build Docker images

Guides:

• Development Setup - Install and configure
• Making Changes - Common workflows
• Testing - Verify your changes
• Docker - Build images

Reference:

• Architecture - System design
• Directory Structure - File organization

---