deploy-dashboard

Deploying dashboard: $ARGUMENTS

Deploy a completed PolicyEngine dashboard to production. Run this AFTER merging your feature branch into main.

Precondition: The user should be on the main branch with a clean working tree and the dashboard code merged.

Skills Used

• policyengine-tools — Vercel frontend deployment (all dashboards) and Modal backend deployment (only if custom-modal pattern)

Step 1: Verify Prerequisites

# Check we're on main
git branch --show-current

# Check for clean working tree
git status

# Verify build passes
bun install --frozen-lockfile && bun run build && bunx vitest run

If not on main: Tell the user to merge their feature branch first:

You're currently on branch {branch}. Please merge into main first:

git checkout main
git merge {branch}
git push

Then run /deploy-dashboard again.

If build fails: Report the error and STOP. Do not deploy broken code.

Step 2: Read the Plan

cat plan.yaml

Extract:

• dashboard.name — for Vercel project and Modal app names
• dashboard.zone_path — for multi-zone host rewrite verification
• data_pattern — determines if Modal deploy is needed (custom-modal needs it; precomputed, precomputed-csv, and policyengine-api do not)
• tech_stack.framework — should be react-nextjs (env var prefix: NEXT_PUBLIC_*)
• embedding.register_in_apps_json — determines if apps.json update is needed
• embedding.slug — the URL slug for policyengine.org

2a. Pre-flight: check for existing host rewrites (informational)

If this dashboard has deployed before, the host (policyengine-app-v2/website/next.config.ts) may already have rewrites pointing at it. Check so we know whether Step 5 needs to add them or they're already in place.

# Clone or pull the host repo
if [ ! -d /tmp/policyengine-app-v2 ]; then
  gh repo clone PolicyEngine/policyengine-app-v2 /tmp/policyengine-app-v2
fi
(cd /tmp/policyengine-app-v2 && git checkout main && git pull)

# Invoke the multi-zone validator in host-only mode to check all rewrite structure at once
# (beforeFiles placement, route + asset rewrite counts, destination format)