Common questions, direct answers.
Everything you might want to know about VibeKit, the agents it supports, and how it compares to building from scratch.
- 01
What is VibeKit?
VibeKit is a structured framework for building production-grade Next.js applications with any AI coding agent. It generates four files (project-description.md, project-phases.md, design-style-guide.md, prompt.md) that lock the app's scope, build phases, and visual design before a single line of code is written. The agent then builds phase by phase using a locked tech stack: Next.js 16, Prisma v7, Better Auth, React Query, Zod, and Tailwind v4.
- 02
Which AI coding agents does VibeKit work with?
VibeKit works with any coding agent that reads project files. This includes Claude Code, Cursor, Kiro Code, Antigravity, Windsurf, Cline, Aider, Continue, Cody, v0, Lovable, and Bolt. The four generated files are agent-agnostic markdown — drop them into any project and the agent will read them as part of its context.
- 03
How is VibeKit different from create-next-app?
create-next-app gives you a blank Next.js project. VibeKit gives you a planned project: a customized design system, a phase-by-phase build plan, a coding constitution for the agent, a registry of pre-built components (auth, payments, file uploads, data tables), and a pre-deploy security audit prompt. You start from a brief, not from boilerplate.
- 04
Is VibeKit free?
Yes, VibeKit is MIT licensed and free to use. You'll pay for the AI agent itself (Claude Code subscription, Cursor subscription, etc.) and for the cloud services your app uses (Neon Postgres, Vercel hosting, Resend for email, Stripe for payments). Most of those have generous free tiers for small projects.
- 05
What tech stack does VibeKit lock you into?
Next.js 16 (App Router), TypeScript 5.9, Tailwind CSS v4, shadcn/ui, Prisma v7 + Neon Postgres, Better Auth, React Query, React Hook Form + Zod, API Routes (Route Handlers), @react-pdf/renderer for PDFs, xlsx for Excel, Resend + React Email for transactional email, Stripe for payments, Cloudflare R2 or UploadThing for file storage, deployed on Vercel with Cloudflare DNS.
- 06
Why lock the stack instead of letting the AI choose?
Because AI agents are inconsistent. Without a locked stack, you'll get jsPDF in one project, react-pdf in the next; Drizzle here, Prisma there; useEffect for data fetching when React Query is right. The locked stack means every project is debuggable in the same way, every component is reusable across projects, and the agent never has to invent — it just builds.
- 07
What does the pre-deploy review do?
Before deploying, you paste pre-deploy-review.md into your coding agent. It performs a senior-level audit covering: high CPU tasks, performance bottlenecks (N+1 queries, missing pagination, memory leaks), background tasks (webhook idempotency, retry logic, distributed locks), and security (unauthenticated routes, SQL injection, missing rate limiting, exposed secrets). It writes findings as Critical / High / Medium to pre-deploy-review-report.md. You address Critical issues before going live.
- 08
What's the JB Component Registry?
A collection of production-ready shadcn components for the most common app primitives: authentication (Better Auth UI), file uploads (S3/R2), Stripe checkout, data tables, MDX blogs, marketing sites, e-commerce carts, searchable selects, API documentation, and Mobile Money payments. Your coding agent installs them with one command instead of writing auth or file uploads from scratch — saving 60–80% of tokens per feature.
- 09
Do I need to be a developer to use VibeKit?
You need basic comfort with the command line, git, and reading code — but you don't need to write much code yourself. The agent does the writing. You'll review, confirm, and occasionally redirect. If you've successfully shipped anything with Cursor or Claude Code before, you can use VibeKit.
- 10
How long does it take to build an app with VibeKit?
A typical SaaS MVP — auth, dashboard, CRUD, payments, email, deploy — takes 8–20 hours of agent time spread across 3–7 days. Phase 1 (foundation: auth + layout + design system) is usually 1–2 hours. Each subsequent phase is 1–4 hours depending on feature complexity. The pre-deploy review and deployment take another 2–3 hours combined.
- 11
Can I use VibeKit for something other than SaaS?
Yes. The framework is opinionated about Next.js but agnostic about app type. People have used it for marketing sites (with the Website UI component), blogs (MDX Blog component), e-commerce stores (Stripe UI or DGateway Shop), internal admin tools, and learning platforms. Anything that fits the Next.js + Postgres + auth pattern.
- 12
What if my agent gets stuck or loops on the same error?
VibeKit ships with a rescue system. The troubleshooting.md guide has symptom-to-fix recipes, and prompt-engineering.md has three rescue techniques: the Hard Reset (start a new conversation with full context), the Decomposition (split a failing prompt into 3–4 small prompts), and the V0 Bypass (design visual issues in V0, hand off the result). The Phase-by-Phase build structure also limits how far things can drift between confirmations.
- 13
Does VibeKit support dark mode?
Yes — but only if you opt in. The planning interview asks if you want dark mode. If you say yes, the design-style-guide.md includes a dark palette, the master prompt enforces ThemeProvider + next-themes, and a toggle is added to the sidebar. If you say no, dark mode is skipped entirely — no extra code, no .dark classes, no toggle.
- 14
Can I customize the design beyond the style guide?
Absolutely. The design-style-guide.md is a starting point — once it's in your project, you and the agent can iterate on it. Change the primary color, swap fonts, adjust spacing. The master prompt enforces consistency across the app, but the tokens themselves are entirely yours to edit.
- 15
Where do I get help if something breaks?
Open an issue on the GitHub repo, reach out via the JB website (jb.desishub.com), or post in the Desishub community. For agent-specific issues (Claude Code limits, Cursor bugs), the agent's own Discord/Slack will be more responsive than us.