Template SaaS Next.js — auth, payments e IA listos para producir

Para qué sirve#

Un template Next.js que tiene resueltas las piezas que siempre tenés que armar de nuevo cuando empezás un SaaS:

• Auth con sesiones, OAuth, password reset y MFA
• Pagos suscripciones y one-time, con webhooks bien manejados
• Multi-tenancy (organizaciones, invitaciones, roles)
• Panel admin para mirar usuarios, suscripciones, métricas
• Endpoints IA preconfigurados para Claude con caching y rate limits
• Email transaccional con templates editables
• i18n ES/EN preconfigurado

Lo que NO incluye: tu producto. Eso lo ponés vos. Pero la base está lista para que el día 1 te concentres en la lógica de negocio, no en repetir el setup de Stripe webhooks otra vez.

Stack#

Cómo empezar#

npx create-nucleo-saas mi-app
cd mi-app
cp .env.example .env.local

# Database
DATABASE_URL="postgres://..."

# Auth (uno de los dos)
CLERK_SECRET_KEY="sk_test_..."
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY="pk_test_..."
# o
NEXT_PUBLIC_SUPABASE_URL="..."
SUPABASE_SERVICE_ROLE_KEY="..."

# Pagos
STRIPE_SECRET_KEY="sk_test_..."
STRIPE_WEBHOOK_SECRET="whsec_..."
MERCADOPAGO_ACCESS_TOKEN="APP_USR-..."  # opcional

# Email
RESEND_API_KEY="re_..."

# IA
ANTHROPIC_API_KEY="sk-ant-..."

npm install
npm run db:push   # corre las migraciones iniciales
npm run dev

Lo que vas a encontrar#

app/ — rutas#

app/
├── (marketing)/       # landing, pricing, blog (estático rápido)
├── (auth)/            # sign-in, sign-up, reset
├── (dashboard)/       # app autenticada
│   ├── overview/
│   ├── settings/
│   ├── billing/
│   └── team/          # solo si activaste multi-tenant
├── (admin)/           # panel admin (solo role=admin)
└── api/
    ├── webhooks/      # Stripe, MP, Clerk webhooks listos
    └── ai/            # endpoints IA con caching

lib/ — lógica#

lib/
├── db/                # schema Drizzle + queries comunes
├── auth/              # helpers de auth, abstracción del provider
├── payments/          # checkout, subscriptions, webhooks
├── ai/                # client Claude con prompt caching y retries
├── email/             # templates React Email
└── jobs/              # background jobs (Inngest opcional)

Casos resueltos que valen el oro#

Endpoint IA preconfigurado#

El template viene con un endpoint base que ya tiene cosas resueltas:

// app/api/ai/chat/route.ts (resumido)
export async function POST(req: Request) {
  const user = await requireUser()
  await checkRateLimit(user.id, 'ai-chat')
  
  const { messages } = await req.json()
  
  const response = await anthropic.messages.create({
    model: 'claude-sonnet-4-6',
    max_tokens: 2000,
    system: [
      { type: 'text', text: SYSTEM_PROMPT, cache_control: { type: 'ephemeral' } }
    ],
    messages,
  })
  
  await logUsage(user.id, response.usage)
  return Response.json({ message: response.content[0] })
}

Cosas que ya están resueltas:

• Auth check
• Rate limit por usuario
• Prompt caching del system prompt
• Logging de tokens (para facturar o auditar)
• Manejo de errores

Para hacer tu propio endpoint, copiá este y reemplazá el SYSTEM_PROMPT.

Pricing tiers de ejemplo#

El template trae 3 tiers configurados en Stripe (test mode):

Editá los precios reales en lib/payments/plans.ts. La lógica de gates (qué feature está en qué tier) está en lib/payments/feature-gates.ts.

Deploy#

Vercel (recomendado)#

npm i -g vercel
vercel

Configurá las variables de entorno en el dashboard de Vercel. La DB tiene que estar en otro lado (Supabase, Neon, Railway).

Self-hosted con Docker#

docker compose up

El docker-compose.yml incluye Postgres + app. Listo para Railway, Fly.io, o tu VPS.

Lo que NO está incluido (intencional)#

• Analytics: agregá PostHog o Plausible vos. No queremos casarte con un vendor.
• Customer support widget: idem.
• CMS para tu blog: el template tiene un blog con MDX local. Si querés Sanity/Contentful, lo enchufás vos.
• Mobile apps: si necesitás iOS/Android nativo, el template te sirve como backend, pero no incluye apps.

Roadmap#

Próximas versiones (v2.2 y siguientes):

• Multi-region DB con read replicas
• Audit log para compliance enterprise
• SSO con SAML (ahora solo OAuth)
• Sandboxed agent execution (Claude ejecutando en environments aislados)

PRs bienvenidos. Repo público con licencia MIT.