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 Neon Postgres connection string — the kit is tuned for Neon’s serverless behavior (other Postgres providers work but need user-side tuning). 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— Postgres (required)
- 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
- BICTORYS_API_KEY— Mobile money payments
- 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 (Postgres / Neon)
- Vitest unit test suite covering the protected libs
- CI pipeline: format / lint / typecheck / test / build / audit
- Cloud-only by design — bring your own Postgres (Neon free tier), no local containers
Full architecture overview in CLAUDE.md; public surface in README.md.