izi kit
Headless Next.js 16 starter — auth, payments, admin, webhooks, cron.
You’re seeing this default page because frontend/src/app/page.tsx hasn’t been replaced yet.
👋 New here? Open this project in Claude Code and type:
/setup-kit
The /setup-kit skill audits your environment, installs what it can (pnpm via Corepack, secrets), and walks you through plugging a self-hosted Supabase Postgres connection string. Then just describe what you want to build to Claude (in French or English). The 40 routes (auth, payments, admin, webhooks, cron, uploads) are already wired — you only talk about your product, not the plumbing. See WORKFLOW.md for the full vibe-coding flow.
Backend status
Live JSON probes — open these in a new tab to confirm everything is up.
- /api/health — liveness (always responds)
- /api/readyz — readiness (DB + Redis probes, 503 if either is down)
Provider configuration
Read at request time from process.env. Optional providers are inert when absent — the corresponding routes 404 silently and the rest of the app keeps working.
Required (app refuses to boot without these)
- DATABASE_URL— Self-hosted Supabase Postgres
- JWT_SECRET— Auth signing key (required)
Recommended (app boots, but breaks at first use)
- ENCRYPTION_KEY— AES-256-GCM (recommended)
- CRON_SECRET— Vercel Cron Bearer (recommended)
- DIRECT_URL— For prisma migrate deploy
Optional providers
- UPSTASH_REDIS_REST_URL— Redis (rate limit, queue, lockout)
- GOOGLE_CLIENT_ID— Sign in with Google (OAuth)
- RESEND_API_KEY— Email sender
- EMAIL_FROM— Verified sender address
- CLOUDINARY_CLOUD_NAME— Cloudinary file / media storage
- MONEROO_SECRET_KEY— Moneroo payments
- SUPABASE_URL— Self-hosted Supabase API
- SENTRY_DSN— Error reporting + traces
What this starter ships
- API routes under
/api/*— auth, OAuth, admin, payments, uploads, webhooks, 5 cron handlers - Prisma schema + versioned migrations on self-hosted Supabase Postgres
- Vitest unit test suite covering the protected libs
- CI pipeline: format / lint / typecheck / test / build / audit
- Dedicated self-hosted Supabase APIs, storage, authentication, and connection pooler
Full architecture overview in CLAUDE.md; public surface in README.md.