Paddle SaaS Starter Kit

Launch a production-ready Paddle SaaS in minutes.

Generate billing pages, checkout flows, webhook handling, subscription management, usage limits, team billing, customer portals, route protection, onboarding, and a SaaS dashboard from a single CLI.

Distributed through the paddle-checkout-accelerator npm package.

Launch a SaaS in 3 Commands

npm install paddle-checkout-accelerator

npx paddle-checkout-accelerator activate

npx paddle-checkout-accelerator setup

Then:

npm run dev

You instantly get:

✅ Pricing page
✅ Billing dashboard
✅ Customer portal routes
✅ Paddle webhooks
✅ Subscription sync
✅ Feature gating
✅ Usage limits
✅ Team billing foundation
✅ SaaS dashboard
✅ Team, usage, settings, billing and onboarding pages
✅ Protected API examples
✅ Production build validation


---

What Gets Built

Billing Infrastructure

Paddle checkout integration

Subscription synchronization

Customer portal access

Webhook verification

Customer lookup

Subscription repair tools

Billing events


Access Control

Plan protection

Feature protection

Usage limits

Entitlements


Team Billing

Team creation

Seat limits

Team roles

Member management

Seat usage tracking


SaaS Foundation

Pricing page

Billing dashboard

Revenue dashboard

Usage dashboard

Team dashboard

Settings dashboard

Onboarding checklist

Protected APIs

Auth detection

Route protection



---

Quick Start

Install:

npm install paddle-checkout-accelerator

Activate your license:

npx paddle-checkout-accelerator activate

Run setup:

npx paddle-checkout-accelerator setup

Build:

npm run build


---

Recommended Installation Flow

npm install paddle-checkout-accelerator

npx paddle-checkout-accelerator activate

npx paddle-checkout-accelerator setup

npm run build

setup runs the complete production setup flow:

1. Generates billing infrastructure


2. Connects Paddle


3. Generates premium SaaS UI


4. Runs final verification




---

What Gets Generated

Running:

npx paddle-checkout-accelerator setup

creates and configures:

src/lib/billing.ts
src/lib/billing-user.ts
src/lib/require-user.ts
src/lib/require-plan.ts

src/app/api/paddle/webhook/route.ts
src/app/api/paddle/portal-session/route.ts
src/app/api/paddle/refresh-subscription/route.ts
src/app/api/paddle/repair-by-email/route.ts

src/app/api/demo/protected-generation/route.ts

src/app/billing/pricing/page.tsx
src/app/billing/dashboard/page.tsx
src/app/billing/customer-repair/page.tsx
src/app/billing/protected-api/page.tsx
src/app/billing/success/page.tsx

src/app/(saas)/layout.tsx
src/app/(saas)/dashboard/page.tsx
src/app/(saas)/team/page.tsx
src/app/(saas)/usage/page.tsx
src/app/(saas)/settings/page.tsx
src/app/(saas)/billing/page.tsx
src/app/(saas)/onboarding/page.tsx

src/components/paddle-launch/sidebar.tsx
src/components/paddle-launch/topbar.tsx

.env.local


---

Problems It Solves

User paid but account did not unlock

Subscription state out of sync

Webhook failed or arrived late

Need customer portal access

Need feature-level access control

Need usage limits

Need team seat management

Need billing dashboards

Need pricing pages

Need reusable SaaS infrastructure



---

CLI Commands

Setup

npx paddle-checkout-accelerator setup

Runs the full setup flow:

Generates billing infrastructure

Connects Paddle

Generates SaaS dashboard

Runs verification



---

Activate

npx paddle-checkout-accelerator activate

Activates your commercial license and unlocks premium commands.


---

Complete

npx paddle-checkout-accelerator complete

Generates billing infrastructure, Paddle routes, billing pages, auth helpers, and environment configuration.


---

Launch

npx paddle-checkout-accelerator launch

Generates SaaS dashboard, sidebar navigation, billing workspace, team pages, usage pages, settings pages, onboarding, and protected layouts.


---

Connect

npx paddle-checkout-accelerator connect

Connects Paddle and updates local environment configuration.

Depending on available Paddle API access, it can:

Create Paddle products

Create Paddle prices

Create client tokens

Create notification destinations

Update .env.local

Verify installation



---

Doctor

npx paddle-checkout-accelerator doctor

Checks:

Environment variables

Generated routes

Billing configuration

Installation completeness



---

Verify

npx paddle-checkout-accelerator verify

Checks:

Paddle API connectivity

Products

Prices

Billing readiness


Returns a readiness score.


---

Auth

npx paddle-checkout-accelerator auth

Detects:

Clerk

Auth.js / NextAuth

Supabase

Firebase


Generates billing helpers automatically.


---

Prisma

npx paddle-checkout-accelerator prisma

Adds Paddle billing models to an existing Prisma schema.


---

Verified Installation

Verified on fresh Next.js 16 applications.

npm install paddle-checkout-accelerator

npx paddle-checkout-accelerator activate

npx paddle-checkout-accelerator setup

npm run build

Expected result:

✅ Billing scaffold generated
✅ Paddle routes generated
✅ SaaS dashboard generated
✅ Environment configuration generated
✅ Production build passes


---

Core Usage

Protect plans:

await protectPlan(userId, "pro");

Protect features:

await protectFeature(userId, "api_access");

Protect usage:

await protectUsage(userId, "ai_generation");

Refresh subscriptions:

await refreshSubscriptionFromPaddle(subscriptionId);

Repair customer access:

await repairSubscriptionByEmail(email);


---

Team Billing

Create teams:

await createTeam({
  teamId: "team_1",
  name: "Acme",
  ownerId: userId,
});

Add members:

await addTeamMember({
  teamId: "team_1",
  userId: "user_2",
});

Check seat usage:

await getSeatUsage("team_1");


---

Ideal For

AI SaaS

Developer tools

API products

Membership platforms

B2B SaaS

Startup MVPs

Internal tools

Agencies



---

Adapter Support

Included:

Memory adapter

Prisma adapter


Planned:

Supabase adapter

PostgreSQL adapter



---

Testing

npm run test
npm run lint
npm run build
npm run build:package
npm run release-check


---

Commercial License

Copyright © Namah.

Paddle SaaS Starter Kit is commercial software.

Permission is granted to licensed customers to use the software for building and operating their own applications.

The following actions are prohibited without written permission from Namah:

Redistribution of source code

Resale of source code

Republishing source code

Sublicensing source code

Creating competing starter kits, boilerplates, templates, SDKs, or developer products derived from this software

Offering the software as a service whose primary purpose is redistribution of the software itself


Each purchased license is valid for a single developer unless otherwise specified.

This software is provided "as is" without warranty of any kind.