Template Starter

Your new app foundation is ready

This repository ships with CI/CD workflows, Terraform infrastructure, Docker Compose, and a sample Next.js + Postgres app. Use this page as your initial handoff checklist. Includes blue-green deployment.

1. Initialize this repository

Set project metadata and baseline defaults.

scripts/init-template.sh --project-name your-project-slug

2. Configure GitHub settings

Required secret:

  • AWS_ROLE_ARN

Required variables:

  • AWS_HOSTED_ZONE_ID
  • DOMAIN_NAME

3. Run locally

cp .env.example .env
docker compose up --build

4. Deploy

Push to main to run provision-and-deploy.yml, or run manual-deploy.yml for an on-demand deploy.

Full bootstrap guide: docs/REPO_BOOTSTRAP.md

5. Explore the sample app

The original TODO demo is available at /demo so this root page can stay focused on template onboarding.

6. God speed soldier!

Now get to work on your product! This template is ready to go, but you'll need to add your own UI and API endpoints.

Recommended next edits

  • Replace sample TODO UI/API under src/
  • Update this page with product-specific onboarding
  • Adjust infra defaults in terraform/infrastructure/