ci-verification

CI Verification with act

This project uses act to run GitHub Actions workflows locally before pushing, so build/test failures are caught before CD runs on GitHub.

Prerequisites

• Docker (OrbStack supported) must be running
• act must be installed: brew install act
• ~/.actrc must contain --container-architecture linux/amd64

Environment Setup (OrbStack)

If DOCKER_HOST is not set, export it first:

export DOCKER_HOST="unix://${HOME}/.orbstack/run/docker.sock"

To make this permanent, append to ~/.actrc:

echo "--env DOCKER_HOST=unix://${HOME}/.orbstack/run/docker.sock" >> ~/.actrc

Workflow Files

Commands

List available jobs

act --list

Run PR CI (full: type check → build → E2E)

DOCKER_HOST="unix://${HOME}/.orbstack/run/docker.sock" \
  act pull_request \
  --container-architecture linux/amd64

Run only the e2e job (faster feedback)

DOCKER_HOST="unix://${HOME}/.orbstack/run/docker.sock" \
  act pull_request -j e2e \
  --container-architecture linux/amd64

Debug output

DOCKER_HOST="unix://${HOME}/.orbstack/run/docker.sock" \
  act pull_request -j e2e \
  --container-architecture linux/amd64 \
  -v

Pre-PR Checklist

Before creating a pull request, verify all of the following pass locally:

1. pnpm build — production build succeeds (no bundler errors)
2. pnpm exec tsc --noEmit — no TypeScript errors
3. act pull_request -j e2e ... — CI green locally

Design Rationale

• The e2e.yml CI workflow runs pnpm build before E2E tests. This ensures bundler errors (e.g. invalid manualChunks format for rolldown) are caught at PR review time, not after merging when deploy.yml runs.
• deploy.yml runs independently on push to main and is not replicated in CI to avoid redundancy.

Known Pitfalls