Promotion flow

End-to-end path

feature branch
    |  PR targeting staging
    |  required GitHub checks (CI gate)
    |  Amplify PR preview URL
    v
staging  -->  https://staging.<app-id>.amplifyapp.com
    |  PR targeting main
    |  same required checks
    v
main     -->  https://main.<app-id>.amplifyapp.com

Close

Responsibilities

Actor	Role
Developer	Branch, PR, respond to review
GitHub Actions	Lint / tests - CI gateCI gate GitHub Actions checks plus branch protection - required before merge. Amplify does not wait for CI by itself; it builds on push. before merge
Branch protection	Blocks merge until checks are green
AmplifyAmplify AWS Amplify Hosting - builds and hosts front-end apps from a Git repository with branch and PR preview URLs. Amplify Hosting docs	Builds on push/PR from amplify.ymlamplify.yml Root amplify.yml file that tells Amplify how to install, build, and which artifact directory to publish.; hosts dist/

Note

Amplify and GitHub Actions run in parallel on a push. Protection rules are what stop a red build from reaching staging or main.

Sample vs this docs site

Site	Host	Domain in this project
Walkthrough (you are reading it)	GitHub Pages	amplify-astro-cicd-walkthrough.johna.kiwi
Sample Astro app	Amplify	*.amplifyapp.com only

Next: Prerequisites.