मुख्य सामग्री पर जाएं

GitHub Repository

न्यूनतम Next.js + Supabase + Dodo Payments सब्सक्रिप्शन बॉयलरप्लेट

Live Demo

तैनात डेमो का अन्वेषण करें

​
अवलोकन

Next.js 15, React 19, Supabase, Drizzle ORM, और Dodo Payments का उपयोग करके सब्सक्रिप्शन के लिए एक प्रोडक्शन-रेडी बॉयलरप्लेट। इसमें Google OAuth, सब्सक्रिप्शन चेकआउट, वेबहुक हैंडलिंग, डेटाबेस स्कीमा, और एक बुनियादी डैशबोर्ड शामिल है।
यदि आपको एक मौजूदा ऐप के लिए केवल रूट हैंडलर की आवश्यकता है, तो समर्पित अडैप्टर्स देखें: Next.js Adaptor और Express Adaptor।

​
पूर्वापेक्षाएँ

  • Node.js 18+ (या Bun 1.0+)
  • Supabase प्रोजेक्ट (URL, Anon key, Service role key, Database URL)
  • Dodo Payments खाता (API key, Webhook secret)
  • Google Cloud OAuth क्लाइंट (Client ID और Secret)

​
त्वरित प्रारंभ

1

क्लोन और इंस्टॉल

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
2

Supabase प्रोजेक्ट बनाएं

एक Supabase प्रोजेक्ट बनाएं और कॉपी करें:
  • NEXT_PUBLIC_SUPABASE_URL
  • NEXT_PUBLIC_SUPABASE_ANON_KEY
  • SUPABASE_SERVICE_ROLE_KEY
  • DATABASE_URL (कनेक्शन स्ट्रिंग)
3

गूगल OAuth कॉन्फ़िगर करें

Google Cloud में रीडायरेक्ट URI सेट करें: https://[your-project-ref].supabase.co/auth/v1/callback फिर अपने Client ID और Secret का उपयोग करके Supabase Auth में Google प्रदाता को सक्षम करें।
4

Dodo Payments कॉन्फ़िगर करें

Dodo डैशबोर्ड से एक API कुंजी और Webhook सीक्रेट उत्पन्न करें। विकास के दौरान पर्यावरण को test_mode पर सेट करें।
5

.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
कभी भी सीक्रेट्स को कमिट न करें। तैनाती वातावरण में पर्यावरण चर का उपयोग करें।
6

डेटाबेस स्कीमा प्रदान करें

bun run db:push
# or
npm run db:push
# or
pnpm run db:push
बनाई गई तालिकाएँ: users, subscriptions, payments।
7

वेबहुक फ़ंक्शन तैनात करें

# 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":{}}'
8

Dodo Payments में वेबहुक जोड़ें

एंडपॉइंट URL को सेट करें:
https://[your-project-ref].supabase.co/functions/v1/dodo-webhook
भुगतान और सब्सक्रिप्शन घटनाओं का चयन करें।
9

उत्पाद और सुविधाएँ बनाएं

Dodo डैशबोर्ड → उत्पाद → उत्पाद बनाएं। वैकल्पिक रूप से मेटाडेटा जोड़ें:
{
  "features": ["Feature 1", "Feature 2", "Feature 3"]
}
मूल्य निर्धारण UI इस features ऐरे को पढ़ता है और इसे गतिशील रूप से प्रस्तुत करता है।
10

डेव सर्वर चलाएँ

bun run dev
# or
npm run dev
# or
pnpm run dev
http://localhost:3000 खोलें।

​
क्या शामिल है

  • Supabase के माध्यम से प्रमाणीकरण (गूगल OAuth कॉन्फ़िगर किया गया)
  • Dodo Payments के माध्यम से सदस्यता चेकआउट
  • वेबहुक के लिए Supabase Edge Function (dodo-webhook)
  • Drizzle ORM स्कीमा और माइग्रेशन
  • चालान, सदस्यता स्थिति, और योजना सुविधाओं के साथ डैशबोर्ड
जब तक आप एंड-टू-एंड परीक्षण पूरा नहीं कर लेते, DODO_PAYMENTS_ENVIRONMENT को test_mode के रूप में बनाए रखें।

​
प्रमुख फ़ाइलें और पथ

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

​
पर्यावरण चर

NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=
SUPABASE_SERVICE_ROLE_KEY=
DATABASE_URL=

DODO_PAYMENTS_API_KEY=
DODO_WEBHOOK_SECRET=
DODO_PAYMENTS_ENVIRONMENT=test_mode|live_mode

GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=

​
सत्यापन और समस्या निवारण

  • सुनिश्चित करें कि DODO_WEBHOOK_SECRET Dodo डैशबोर्ड से प्राप्त मान से मेल खाता है
  • पुष्टि करें कि आपने नवीनतम dodo-webhook फ़ंक्शन को तैनात किया है
  • अपने फ़ंक्शन में हेडर नाम सही है (Dodo-Signature) यह सुनिश्चित करें
  • DATABASE_URL सिंटैक्स और Supabase नेटवर्क आउटबाउंड की जाँच करें
  • पहले पुश से पहले प्रोजेक्ट निर्माण के बाद ~2–3 मिनट प्रतीक्षा करें
  • रीडायरेक्ट URI को https://[ref].supabase.co/auth/v1/callback होना चाहिए
  • Google Cloud और Supabase Auth प्रदाता में समान सुनिश्चित करें
आपके पास अब Supabase और Dodo Payments के साथ एक कार्यशील सब्सक्रिप्शन SaaS है।
मूल भंडार और विस्तृत चरण: dodo-supabase-subscription-starter।