Supabase Boilerplate

GitHub Repository

Minimal Next.js + Supabase + Dodo Payments boilerplate för prenumerationer

Live Demo

Utforska den distribuerade demon

Översikt

En produktionsklar boilerplate för prenumerationer med Next.js 15, React 19, Supabase, Drizzle ORM och Dodo Payments. Den levereras med Google OAuth, checkout för prenumerationer, webhook-hantering, databasschema och en grundläggande dashboard.

Om du endast behöver route handlers för en befintlig app kan du se de dedikerade adaptrarna: Next.js Adaptor och Express Adaptor.

Förutsättningar

Node.js 18+ (eller Bun 1.0+)
Supabase-projekt (URL, Anon key, Service role key, Database URL)
Dodo Payments-konto (API key, Webhook secret)
Google Cloud OAuth-klient (Client ID och Secret)

Snabbstart

Clone and install

git clone https://github.com/dodopayments/dodo-supabase-subscription-starter.git
cd dodo-supabase-subscription-starter
# choose one
bun install
# or
npm install
# or
pnpm install

Create Supabase project

Skapa ett Supabase-projekt och kopiera:

NEXT_PUBLIC_SUPABASE_URL
NEXT_PUBLIC_SUPABASE_ANON_KEY
SUPABASE_SERVICE_ROLE_KEY
DATABASE_URL (Connection string)

Configure Google OAuth

Ange redirect-URI:n till: https://[your-project-ref].supabase.co/auth/v1/callback i Google Cloud och aktivera sedan Google-provider i Supabase Auth med ditt Client ID och Secret.

Configure Dodo Payments

Generera en API key och Webhook secret från dashboarden för Dodo. Ange miljön till test_mode under utveckling.

Create .env.local

# Supabase
NEXT_PUBLIC_SUPABASE_URL=https://your-project-ref.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-service-role

# Database
DATABASE_URL=postgresql://postgres:[password]@db.[project-ref].supabase.co:5432/postgres

# Dodo Payments
DODO_PAYMENTS_API_KEY=your-dodo-api-key
DODO_WEBHOOK_SECRET=your-webhook-secret
DODO_PAYMENTS_ENVIRONMENT=test_mode

Commita aldrig hemligheter. Använd miljövariabler i distributionsmiljöer.

Provision database schema

bun run db:push
# or
npm run db:push
# or
pnpm run db:push

Skapade tabeller: users, subscriptions, payments.

Deploy webhook function

# login (one-time)
bunx supabase login
# or
npx supabase login

# deploy the edge function
bun run deploy:webhook --project-ref [your-project-ref]
# or
npm run deploy:webhook -- --project-ref [your-project-ref]
# or
pnpm run deploy:webhook --project-ref [your-project-ref]

cURL

curl -X POST \
  'https://[your-project-ref].supabase.co/functions/v1/dodo-webhook' \
  -H 'Content-Type: application/json' \
  -H 'Dodo-Signature: <signature>' \
  -d '{"type":"payment.succeeded","data":{}}'

Add webhook in Dodo Payments

Ange endpoint-URL till:

https://[your-project-ref].supabase.co/functions/v1/dodo-webhook

Välj betalnings- och prenumerationshändelser.

Create products and features

I dashboarden för Dodo → Products → Create Product. Lägg eventuellt till metadata:

{
  "features": ["Feature 1", "Feature 2", "Feature 3"]
}

Prisgränssnittet läser denna features-array och återger den dynamiskt.

Run the dev server

bun run dev
# or
npm run dev
# or
pnpm run dev

Öppna http://localhost:3000.

Detta ingår

Autentisering via Supabase (Google OAuth konfigurerat)
Checkout för prenumerationer via Dodo Payments
Supabase Edge Function för webhooks (dodo-webhook)
Drizzle ORM-schema och migreringar
Dashboard med fakturor, prenumerationsstatus och planfunktioner

Behåll DODO_PAYMENTS_ENVIRONMENT som test_mode tills du har slutfört tester från början till slut.

Viktiga filer och sökvägar

Edge Function
Next.js routes
Database (Drizzle)

supabase/functions/dodo-webhook/
  index.ts            # webhook handler verifying signatures
  deno.json           # permissions

app/(marketing)/*     # landing + pricing UI
app/(dashboard)/*     # protected pages
app/api/*             # server actions & helpers

lib/db/schema.ts      # users, subscriptions, payments
lib/db/index.ts       # client

Miljövariabler

Supabase

NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=
SUPABASE_SERVICE_ROLE_KEY=
DATABASE_URL=

Dodo Payments

DODO_PAYMENTS_API_KEY=
DODO_WEBHOOK_SECRET=
DODO_PAYMENTS_ENVIRONMENT=test_mode|live_mode

Google OAuth

GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=

Verifiering och felsökning

Webhook signature invalid (401)

Kontrollera att DODO_WEBHOOK_SECRET matchar värdet från dashboarden för Dodo
Bekräfta att du distribuerade den senaste funktionen dodo-webhook
Kontrollera att headernamnet är korrekt i din funktion (Dodo-Signature)

Database push fails

Kontrollera DATABASE_URL-syntaxen och Supabase-nätverkets utgående trafik
Vänta cirka 2–3 minuter efter att projektet skapats innan den första pushen

OAuth redirect mismatch

Redirect-URI:n måste vara https://[ref].supabase.co/auth/v1/callback
Kontrollera att samma URI används i Google Cloud och Supabase Auth-provider

Nu har du en fungerande SaaS-prenumerationsgrund byggd med Supabase och Dodo Payments.

Ursprungligt repository och detaljerade steg: dodo-supabase-subscription-starter.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

GitHub Repository

Live Demo

Översikt

Förutsättningar

Snabbstart

Detta ingår

Viktiga filer och sökvägar

Miljövariabler

Verifiering och felsökning

GitHub Repository

Live Demo

​Översikt

​Förutsättningar

​Snabbstart

​Detta ingår

​Viktiga filer och sökvägar

​Miljövariabler

​Verifiering och felsökning

Översikt

Förutsättningar

Snabbstart

Detta ingår

Viktiga filer och sökvägar

Miljövariabler

Verifiering och felsökning