What Is Codapult
Codapult is a production-ready SaaS boilerplate for Next.js 16. It gives you 70+ removable modules — authentication, billing, teams, AI chat, admin panel, blog, help center, and more — so you can ship a SaaS product in days instead of months.
Every module is self-contained and independently removable. Run the interactive setup wizard (npx @codapult/cli setup) to strip out what you don't need, and you're left with a clean codebase tailored to your product.
See License and Permitted Use for project limits, client work, hosted SaaS, and what you may not resell.
Key Differentiators
Adapter Pattern
Auth, payments, storage, background jobs, and notification transports all use a unified adapter interface. Switch providers by changing a single environment variable — no code changes:
| Adapter | Providers | Env Var |
|---|---|---|
| Auth | Better-Auth (default), Kinde, None | AUTH_PROVIDER |
| Payments | Stripe (default), LemonSqueezy | PAYMENT_PROVIDER |
| Storage | Local (default), S3, R2 | STORAGE_PROVIDER |
| Background Jobs | In-memory (default), BullMQ (Redis) | JOB_PROVIDER |
| Notifications | Poll (default), SSE, WebSocket | NOTIFICATION_TRANSPORT |
| Embeddings | OpenAI (default), Ollama | EMBEDDING_PROVIDER |
| Vector Store | SQLite (default), In-memory | VECTOR_STORE_PROVIDER |
Plugin System
A first-class plugin architecture lets you extend Codapult with nav items, settings panels, API routes, and event hooks. Four premium plugins are available separately:
- AI Kit — AI gateway, prompt management, tool framework, guardrails
- CRM — Companies, contacts, deal pipeline, AI lead scoring
- Helpdesk — Support tickets, SLA tracking, AI auto-resolve via RAG
- Email Marketing — Subscriber lists, segmentation, broadcast campaigns
Enterprise-Grade Features
- Authentication — email/password, OAuth, magic links, TOTP 2FA, enterprise SAML SSO
- Billing — tiered plans, add-ons, multi-line checkout, Stripe Connect marketplace
- Infrastructure as Code — Terraform (HCL), Pulumi (TypeScript), and Helm chart included
- API layers — tRPC v11 for type-safe procedures, optional GraphQL (graphql-yoga)
- Interactive API docs — OpenAPI 3.1 spec with a built-in explorer
- A/B testing — weighted variants with conversion tracking
- Multi-region database — Turso read replicas with automatic routing
- Performance monitoring — Core Web Vitals reporter with in-app dashboard
Tech Stack
| Layer | Technology |
|---|---|
| Framework | Next.js 16 (App Router, Server Components, Turbopack) |
| Language | TypeScript (strict mode) |
| Database | Turso (LibSQL) + Drizzle ORM |
| Styling | Tailwind CSS v4 + shadcn/ui + Radix UI |
| React | React 19 |
| Type-safe API | tRPC v11 + TanStack React Query |
| AI | Vercel AI SDK + OpenAI / Anthropic |
| Resend + React Email | |
| i18n | next-intl (URL path-prefix routing, 5 locales) |
| Analytics | PostHog |
| Error Monitoring | Sentry (client, server, edge) |
| Testing | Vitest (unit) + Playwright (E2E) |
| Auth | Better-Auth (default) or Kinde |
| Payments | Stripe (default) or LemonSqueezy |
Next Steps
- Quick Start — install, configure, and run in under 5 minutes
- Project Structure — understand the directory layout
- Authentication — sign-in methods, 2FA, and SSO
- Payments & Billing — configure subscription tiers
- Customization — theming, branding, and white-label