Development

Prerequisites

• Node.js 20+
• pnpm
• Vercel CLI
• Slack app credentials
• Redis configured for development

Setup

pnpm install

pnpm dlx vercel@latest login
pnpm dlx vercel@latest switch
pnpm dlx vercel@latest link --yes
pnpm dlx vercel@latest env pull .env --environment=development

If your team account requires an explicit Vercel scope, add --scope <team-slug> to the link and env pull commands.

Run

pnpm dev

Common checks

pnpm test
pnpm typecheck
pnpm skills:check
pnpm docs:check

Slack tunnel

cloudflared tunnel --url http://localhost:3000

Set Event Subscriptions and Interactivity URL to:

https://<tunnel-host>/api/webhooks/slack

Next step

Run focused checks from Testing, then verify behavior in Verify & Troubleshoot.