SnapQuote

SnapQuote is a field-first quoting app for owner-operators and small trade crews.

Core promise:

Quote the job before you drive off.

It is built for the jobs where office software usually fails:

• weak-signal basements, crawlspaces, and job sites
• dirty hands where voice is faster than typing
• rough or broken English that still needs to become a clean customer quote

Current status

As of 2026-03-10, this repository is in "private beta ready" territory.

Validated locally:

• pnpm lint
• pnpm test
• pnpm test:e2e
• pnpm build
• pnpm start
• pnpm smoke:deploy --base-url=http://127.0.0.1:3000

Not yet proven enough for broad paid launch:

• full browser E2E coverage
• live third-party smoke tests across all integrations
• production-grade launch playbook

See:

• Beta launch readiness
• Market positioning

Core workflows

• Voice notes -> transcript -> structured estimate
• PDF preview and send flow
• Offline capture with local storage and later sync
• Payment-ready quotes with Stripe
• Follow-up and usage controls for paid plans

Tech stack

Area	Stack
Frontend	Next.js 16, React 18, TypeScript, Tailwind CSS
Local-first	IndexedDB via idb, service worker
Backend	Supabase Auth, Postgres, Edge Functions
AI	OpenAI and optional Gemini provider fallback
Documents	@react-pdf/renderer
Payments	Stripe + Stripe Connect
Messaging	Resend and optional Twilio

Quick start

1. Install dependencies.

pnpm install

2. Copy the example environment file and fill in the required values.

cp .env.example .env.local

3. Start the app.

pnpm dev

Open http://localhost:3000.

Environment variables

Use .env.example as the source of truth.

Required for the core quote flow:

• NEXT_PUBLIC_SUPABASE_URL
• NEXT_PUBLIC_SUPABASE_ANON_KEY
• SUPABASE_SERVICE_ROLE_KEY
• OPENAI_API_KEY

Required for billing:

• STRIPE_SECRET_KEY
• STRIPE_WEBHOOK_SECRET
• STRIPE_BILLING_WEBHOOK_SECRET
• STRIPE_BILLING_PRICE_STARTER_MONTHLY
• STRIPE_BILLING_PRICE_PRO_MONTHLY
• STRIPE_BILLING_PRICE_TEAM_MONTHLY

Required for email and operational alerts:

• RESEND_API_KEY
• OPS_ALERT_EMAIL

Optional but recommended:

• CRON_SECRET
• RATE_LIMIT_PROVIDER=upstash
• UPSTASH_REDIS_REST_URL
• UPSTASH_REDIS_REST_TOKEN
• TWILIO_ACCOUNT_SID
• TWILIO_AUTH_TOKEN
• TWILIO_FROM_NUMBER
• GEMINI_API_KEY

Supabase Auth setup

OAuth and magic-link redirects must point at a domain that actually resolves. If sign-in lands on snapquote.app with DNS_PROBE_FINISHED_NXDOMAIN, either connect DNS for that domain or replace it in Supabase with the real production URL.

In Supabase Dashboard -> Authentication -> URL Configuration:

• Set Site URL to the real production app URL.
• Add Redirect URLs for production, local development, and Vercel previews:
  • https://<production-domain>/**
  • http://localhost:3000/**
  • https://*-<vercel-team-or-account-slug>.vercel.app/**

In Authentication -> Providers -> Google:

• Enable Google.
• Add the Google Client ID and Client Secret.
• In Google Cloud, set the authorized redirect URI to the Supabase callback URL: https://<project-ref>.supabase.co/auth/v1/callback.

If custom Supabase email templates are enabled, make sure magic-link templates use {{ .RedirectTo }} rather than hard-coding {{ .SiteURL }} so the app's /auth/callback redirect is honored.

Useful commands

pnpm dev
pnpm lint
pnpm test
pnpm test:e2e
pnpm build
pnpm start
pnpm validate:env --preset=beta
pnpm smoke:deploy --base-url=http://127.0.0.1:3000

Project structure

app/
  api/                     API routes for AI, billing, messaging, sync, analytics
  landing/                 Marketing landing page
  new-estimate/            Core field quote builder
  pricing/                 Self-serve pricing page

components/
  audio-recorder.tsx       Voice capture UI
  estimate-pdf.tsx         PDF document renderer
  pdf-preview-modal.tsx    Quote preview and download

lib/
  db.ts                    IndexedDB stores
  estimates-storage.ts     Local quote persistence helpers
  rate-limit.ts            Memory and Upstash rate limiting
  server/                  Auth, billing, usage quota helpers

Documentation

• Product requirements
• Master specification
• Automation expansion PRD
• Development status
• Beta launch readiness
• Market positioning

License

MIT