Smoke test preview deploys

​

The tests

fileType: momentic/test/v2
id: signup-smoke
labels: [smoke]
steps:
  - navigate: /signup
  - act:
      goal: Complete the new-user signup flow using a fresh email
      postcondition: The welcome screen is visible

​

The workflow

name: Preview smoke

on:
  deployment_status:

jobs:
  test:
    if: >-
      github.event.deployment_status.state == 'success' &&
      github.event.deployment.environment == 'Preview'
    runs-on: ubuntu-latest
    timeout-minutes: 15
    env:
      MOMENTIC_API_KEY: ${{ secrets.MOMENTIC_API_KEY }}
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22.12.0
      - run: npm install
      - run: npx momentic install-browsers chromium

      - name: Smoke test the preview
        run: |
          npx momentic run --labels smoke -y --upload-results \
            --url-override "${{ github.event.deployment_status.environment_url }}" \
            --custom-headers \
              "x-vercel-protection-bypass=${{ secrets.VERCEL_AUTOMATION_BYPASS_SECRET }}" \
              "x-vercel-set-bypass-cookie=true"

• deployment_status fires for Vercel and any provider that posts a GitHub deployment. environment_url is the preview URL. For providers that do not post deployments, poll for the URL first: see the Next.js on Vercel guide for the wait-for-preview variant.
• deployment.environment == 'Preview' restricts this job to previews. Match the environment names your provider posts (Vercel uses Preview and Production).
• --url-override replaces each test’s url and each environment’s baseUrl.
• Drop the --custom-headers pair when the preview is public. For protection-bypass details, see Vercel preview auth.

​

Decisions

• --labels smoke is a fixed list; --ai-select picks tests from the diff. Use the label for a fast universal gate, selection when the suite is large, or both.
• A smoke test is an end-to-end happy path that finishes in minutes. If the preview job takes longer than a reviewer waits, it is doing regression work. Move those tests to the nightly suite.
• Make the check required in branch protection to block a merge when the preview test fails. It does not roll the deployment back. For post-deploy rollback gating, see the deploy-gate workflow in Common CI setups.

​

Related

• Common CI setups
• Next.js on Vercel
• Vercel preview auth
• Gate pull requests on critical flows