NextDevTpl Documentation

NextDevTpl 3.x is a composable Next.js SaaS starter. Select product modules, external service implementations, and a deployment platform; the generator keeps only the chosen source, packages, environment variables, database schema, and deployment files. Your project owns the generated code.

The optional operations kit gives independent SaaS projects a typed event contract, consent-aware attribution, an admin metrics dashboard, revenue and AI cost read models, daily snapshots, and safe notifications without a hosted NextDevTpl analytics service.

Confirm what your project contains

nextdevtpl.generated.json in a generated project records the effective selection:

{
  "preset": "saas",
  "target": "vercel",
  "modules": ["auth", "dashboard", "marketing"],
  "adapters": { "payment": "payment:creem" }
}

Read this file first, then follow the matching feature pages. Unselected capabilities have already been removed and require no configuration.

3.x capabilities

Area	Supported capabilities
Generation	minimal, saas, ai-saas, and custom selections with dependency resolution and source pruning
Product	Auth, dashboard, marketing, settings, subscriptions, credits, admin, support, blog, and PSEO
Payments	Shared contract with Creem or Stripe, subscriptions, one-time payments, and verified webhooks
Mail	Disabled, Resend, SMTP, or Cloudflare Email
Storage	S3-compatible presigned uploads or a Cloudflare R2 binding
AI	OpenAI-compatible providers, Anthropic, or Workers AI
Jobs	Inngest or Cloudflare Workflows plus protected cron handlers
Rate limiting	No-op, Upstash Redis, or Cloudflare Rate Limiting bindings
Platforms	Server, Docker Compose, Vercel, and Cloudflare Workers
Operations	Typed telemetry, product/revenue/AI metrics, snapshots, alerts, health checks, structured logs, Sentry, Axiom, and compatibility gates

Recommended path

For a first project:

1. Quick Start
2. Generator and Presets
3. Feature Modules
4. Configuration
5. Operations

For external services:

1. Service Adapters
2. The matching payments, email, storage, AI, jobs, or observability page

Before production:

1. Deployment
2. Upgrade and Compatibility

Two ways to use the project

Use create-nextdevtpl for a clean product application. Clone the full repository when contributing to the template, extending official modules, running the compatibility matrix, or preparing a generator release.