Quickstart

Resonance Quickstart

Spin up the Resonance stack, stream live phase and latency metrics, and deploy updates confidently with this end-to-end checklist.

1. Prerequisites

  • Node.js 18 or newer
  • Access to your Resonance Vercel (frontend) and Render (agent) deployments
  • Agent API key (`RESONANCE_API_KEY`) and optional intake key
  • Stripe publishable + secret keys for checkout flows
  • Redis URL (Upstash or self-hosted) if rate limiting is enabled

2. Clone & Install

git clone https://github.com/stringerc/resonance-runtime-landing.git
cd resonance-runtime-landing
npm install

3. Configure Environment

Create .env.local with the required configuration:

NEXTAUTH_URL=https://resonance.syncscript.app
NEXTAUTH_SECRET=generate-a-random-secret
DATABASE_URL=postgres://...
RESONANCE_AGENT_URL=https://syncscript-backend.onrender.com
RESONANCE_AGENT_VERSION=v1.0.0
RESONANCE_RELEASE_CHANNEL=stable
RESONANCE_API_KEY=your-agent-key
NEXT_PUBLIC_INTERCOM_APP_ID=...

4. Database Setup (Optional Demo Data)

npx prisma migrate deploy
npx prisma db seed

5. Run Locally

npm run dev

Visit http://localhost:3000, sign in, and follow the onboarding checklist to enable adaptive mode, stream phase samples, and report latency percentiles.

6. Deploy Updates

  • Push to main for Vercel to rebuild the frontend.
  • Tag agent releases (e.g. git tag agent-v1.0.0 && git push --tags) to trigger GitHub Actions for desktop binaries.
  • Redeploy Render (`syncscript-backend`) after agent changes.

7. Verify Metrics

  • /dashboard/canary for live R(t) and compliance.
  • /dashboard/resonance-calculus for deep analysis and AI insights.
  • Dashboard status strip for agent version, channel, and uptime.