Boilerplate Supabase

GitHub Repository

Boilerplate minimale per abbonamenti Next.js + Supabase + Dodo Payments

Live Demo

Esplora la demo distribuita

Panoramica

Un boilerplate pronto per la produzione per gli abbonamenti che utilizza Next.js 15, React 19, Supabase, Drizzle ORM e Dodo Payments. Include Google OAuth, il checkout degli abbonamenti, la gestione dei webhook, lo schema del database e una dashboard di base.

Se ti servono solo i route handler per un’app esistente, consulta gli adaptor dedicati: Adaptor Next.js e Adaptor Express.

Prerequisiti

Node.js 18+ (o Bun 1.0+)
Progetto Supabase (URL, chiave Anon, chiave del ruolo Service, URL del database)
Account Dodo Payments (chiave API, segreto del Webhook)
Client OAuth Google Cloud (ID client e segreto)

Avvio rapido

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

Crea un progetto Supabase e copia:

NEXT_PUBLIC_SUPABASE_URL
NEXT_PUBLIC_SUPABASE_ANON_KEY
SUPABASE_SERVICE_ROLE_KEY
DATABASE_URL (stringa di connessione)

Configure Google OAuth

Imposta l’URI di reindirizzamento su: https://[your-project-ref].supabase.co/auth/v1/callback in Google Cloud, quindi abilita il provider Google in Supabase Auth utilizzando il tuo ID client e il tuo segreto.

Configure Dodo Payments

Genera una chiave API e un segreto del Webhook dalla dashboard di Dodo. Imposta l’ambiente su test_mode durante lo sviluppo.

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

Non eseguire mai il commit dei segreti. Usa le variabili d’ambiente negli ambienti di deployment.

Provision database schema

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

Tabelle create: 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

Imposta l’URL dell’endpoint su:

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

Seleziona gli eventi di pagamento e di abbonamento.

Create products and features

Nella dashboard di Dodo → Products → Create Product. Facoltativamente, aggiungi i metadati:

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

L’interfaccia dei prezzi legge questo array features e lo visualizza dinamicamente.

Run the dev server

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

Apri http://localhost:3000.

Cosa è incluso

Autenticazione tramite Supabase (Google OAuth configurato)
Checkout degli abbonamenti tramite Dodo Payments
Supabase Edge Function per i webhook (dodo-webhook)
Schema e migrazioni di Drizzle ORM
Dashboard con fatture, stato dell’abbonamento e funzionalità del piano

Mantieni DODO_PAYMENTS_ENVIRONMENT come test_mode finché non completi i test end-to-end.

File e percorsi principali

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

Variabili d’ambiente

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=

Verifica e risoluzione dei problemi

Webhook signature invalid (401)

Assicurati che DODO_WEBHOOK_SECRET corrisponda al valore nella dashboard di Dodo
Conferma di aver distribuito la funzione dodo-webhook più recente
Verifica che il nome dell’header sia corretto nella tua funzione (Dodo-Signature)

Database push fails

Controlla la sintassi di DATABASE_URL e l’uscita di rete di Supabase
Attendi circa 2–3 minuti dopo la creazione del progetto prima del primo push

OAuth redirect mismatch

L’URI di reindirizzamento deve essere https://[ref].supabase.co/auth/v1/callback
Assicurati che sia lo stesso in Google Cloud e nel provider Supabase Auth

Ora hai uno scheletro SaaS per abbonamenti funzionante, realizzato con Supabase e Dodo Payments.

Repository originale e passaggi dettagliati: dodo-supabase-subscription-starter.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

GitHub Repository

Live Demo

Panoramica

Prerequisiti

Avvio rapido

Cosa è incluso

File e percorsi principali

Variabili d’ambiente

Verifica e risoluzione dei problemi

GitHub Repository

Live Demo

​Panoramica

​Prerequisiti

​Avvio rapido

​Cosa è incluso

​File e percorsi principali

​Variabili d’ambiente

​Verifica e risoluzione dei problemi

Panoramica

Prerequisiti

Avvio rapido

Cosa è incluso

File e percorsi principali

Variabili d’ambiente

Verifica e risoluzione dei problemi