Introduction

What Is Codapult

Codapult is a production-ready SaaS foundation for Next.js 16. It connects the parts a serious SaaS needs — authentication, billing, teams, AI chat, admin, content, and infrastructure — so you can spend your time on the product instead of rebuilding the foundation.

Optional capabilities are organized into focused module groups. Run the interactive setup wizard (npx @codapult/cli setup) to remove the supported groups you don't need, and review the generated project before writing custom code.

The setup wizard runs once, before you start building. It permanently removes the files and routes mapped to disabled groups and applies supported prune markers. Because shared schema and dependencies can serve several capabilities, review those after setup and remove anything no longer needed before generating migrations. Adding removed code back requires pulling it manually from the source repository. Modules you keep can be toggled on or off at any time via environment variables where supported.

See License and Permitted Use for project limits, client work, hosted SaaS, and what you may not resell.

Product layers

Codapult is the full-source SaaS foundation: the Next.js application, modules, adapters, infrastructure templates, and documentation that become your product repository.

The surrounding developer tools have focused roles:

• Codapult CLI provides setup, generators, provider/environment checks, database workflows, deployment checks, and the MCP server used from the project root.
• Codapult Guard provides project architecture memory, approved contracts, changed-file regression checks, impact context, and verification. The CLI exposes its Codapult workflow, while @codapult/guard can also be installed directly in another JavaScript or TypeScript repository.

The application remains the product you ship; CLI and Guard operate the development and verification workflow around that source.

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:

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

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