Skip to content
Amplify Astro CI/CD

Create Amplify app

Create the app in the Console

Section titled “Create the app in the Console”
  1. Open the AWS Console → AWS Amplify
  2. Create new app → Host web app
  3. Choose GitHub as the repository provider
  4. Authorize / install the Amplify GitHub App
    Amplify GitHub App - OAuth install that lets Amplify clone your repo and receive push/PR webhooks without a long-lived personal access token.     for your user or organization
  5. Select the amplify-astro-cicd repository
  6. Connect branch main first and confirm Amplify detected amplify.yml
    Root amplify.yml file that tells Amplify how to install, build, and which artifact directory to publish.
  7. Save and deploy - wait until the main job succeeds
  8. Open https://main.<app-id>.amplifyapp.com and confirm the Astro page loads

Record your app id (visible in the Console URL and default domain). You will need it for staging and preview URLs.

Add the staging branch

Section titled “Add the staging branch”
  1. In the Amplify app → Branch / hosting overview → Connect branch
  2. Select Git branch staging
  3. Use the same build settings (amplify.yml)
  4. Deploy and open https://staging.<app-id>.amplifyapp.com

Verify build settings

Section titled “Verify build settings”

Under build settings, confirm:

  • App root is repository root
  • Build uses amplify.yml
  • Artifact directory is dist

Screenshots to capture (for your notes)

Section titled “Screenshots to capture (for your notes)”

When documenting your own run, capture:

  1. GitHub App install confirmation
  2. Successful main deploy
  3. Successful staging deploy

This walkthrough stays on default Amplify domains - no custom domain step.

Next: Previews and auto-delete.