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.
The setup wizard runs once, before you start building. Modules removed through it are permanently stripped from the codebase — files, routes, schema tables, and imports. Adding a removed module back requires pulling it manually from the source repository. Modules you keep can be toggled on or off at any time via environment variables without touching code.
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, Polar | 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. The shared AI foundation is included in the core template. Three optional premium plugins are available separately:
- 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 | PostgreSQL or 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 (locale-aware URL routing; English shipped) |
| Analytics | PostHog |
| Error Monitoring | Sentry (client, server, edge) |
| Testing | Vitest (unit) + Playwright (E2E) |
| Auth | Better-Auth (default) or Kinde |
| Payments | Stripe (default), LemonSqueezy or Polar |
| Storage | Local (default), S3, or Cloudflare R2 |
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