{"id":51216874,"url":"https://github.com/mosespace/vibekit_pro","last_synced_at":"2026-06-28T04:31:24.779Z","repository":{"id":356309260,"uuid":"1231842076","full_name":"mosespace/vibekit_pro","owner":"mosespace","description":"A structured CLI for building production Next.js SaaS apps with AI tools like Lovable \u0026 V0 without burning $200, shipping broken auth, or getting stuck","archived":false,"fork":false,"pushed_at":"2026-05-21T13:05:38.000Z","size":72198,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-21T21:56:10.107Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://vibekit.qwikpost.xyz","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"MUKE-coder/vibekit","license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mosespace.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-07T10:42:28.000Z","updated_at":"2026-05-21T13:06:02.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mosespace/vibekit_pro","commit_stats":null,"previous_names":["mosespace/vibekit","mosespace/vibekit_pro"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mosespace/vibekit_pro","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mosespace%2Fvibekit_pro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mosespace%2Fvibekit_pro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mosespace%2Fvibekit_pro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mosespace%2Fvibekit_pro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mosespace","download_url":"https://codeload.github.com/mosespace/vibekit_pro/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mosespace%2Fvibekit_pro/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34877471,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-28T02:00:05.809Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-28T04:31:24.243Z","updated_at":"2026-06-28T04:31:24.772Z","avatar_url":"https://github.com/mosespace.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VIBEKIT CLI\n\n![VibeKit CLI](/assets/screenshots/clean-sharex-beautified.png)\n\n\u003e A CLI that automates the [VibeKit Framework](https://github.com/MUKE-coder/vibekit) workflow for building production apps with AI agents. Plan your app with an AI agent, generate project files, then build automatically — for **web (Next.js), mobile (Expo), or full-stack (Turbo) projects**.\n\n**Built on top of the VibeKit Framework by [JB (Muke Johnbaptist)](https://jb.desishub.com) · [Desishub Technologies](https://desishub.com)**\n\n---\n\n\u003e **Alpha software.** This CLI has been tested on a small number of devices (Windows 11) and with Claude Code as the primary provider. Other providers (Codex, Gemini CLI, OpenCode) are wired up but largely untested. Expect rough edges, bugs, and missing polish. Contributions and bug reports are very welcome.\n\n---\n\n## What is this?\n\nThe [VibeKit Framework](https://github.com/MUKE-coder/vibekit) is a planning + building system for vibe coders using AI agents. The original workflow is manual:\n\n1. Copy `CLAUDE_PROMPT.md` → paste into Claude.ai → answer questions → download planning files\n2. Copy framework files into your project root\n3. Open your AI provider → paste `prompt.md` → start building\n\n**`create-vibekit-app` automates all of that** into a single command with two guided sessions:\n\n```\nnpx create-vibekit-app my-app\n```\n\n**Now supporting:** Web apps (Next.js 🌐), Mobile apps (Expo 📱), or Full-Stack (Turbo Monorepo 🚀)\n\n---\n\n## How it works\n\n```\nnpx create-vibekit-app my-app\n```\n\n**Step 1: Scaffold your project**\n\nThe CLI creates the appropriate project structure with framework configs, environment templates, and VibeKit framework files pre-populated.\n\n**Step 2: Describe your idea**\n\n```\n◇  Describe your app idea in 1-3 sentences:\n│  A school management system where teachers manage\n│  students and parents can pay fees online.\n```\n\n**Step 3: Choose your platform**\n\n```\n┌  create-vibekit-app\n│\n◇  What would you like to build?\n│  ● Web (Next.js)\n│  ○ Mobile (Expo)\n│  ○ Both (Turbo Monorepo)\n```\n\nPick your platform:\n\n- **Web** → Next.js SPA with server components, deployed to Vercel\n- **Mobile** → Expo app for iOS + Android, built with EAS\n- **Both** → Turbo monorepo with shared database, API routes, and auth\n\nIf you choose **Both**, select your monorepo structure:\n\n- **Shared root API** → `apps/web` + `apps/mobile` with API routes at project root\n- **Monorepo with packages** → `apps/web` + `apps/mobile` + `packages/types` + `packages/schemas`\n\n**Step 4: Pick your AI provider**\n\n```\n◇  Which AI provider should build your project?\n│  ● Claude Code\n│  ○ Codex (OpenAI)   not installed\n│  ○ Gemini CLI       not installed\n│  ○ OpenCode         not installed\n```\n\n**Step 5: Session 1 - Planning**\n\nYour app idea + platform choice is injected into the VibeKit planning prompt and written to `CLAUDE.md`. Your AI provider launches and interviews you about:\n\n- Features, data model, user roles\n- Integrations (auth, payments, file uploads, email)\n- Visual design (brand color, typography, dark mode)\n\nThen it generates **project planning files**:\n\n| File                     | Purpose                                                         |\n| ------------------------ | --------------------------------------------------------------- |\n| `project-description.md` | Complete app spec features, data model, pages, integrations     |\n| `project-phases.md`      | Phase-by-phase build blueprint with checkboxes                  |\n| `design-style-guide.md`  | Fully customized design system (colors, typography, components) |\n| `prompt.md`              | The build prompt for Session 2                                  |\n\nClose the provider when planning is done.\n\n**Step 6: Session 2 - Build**\n\nThe CLI detects the generated files and offers to start the build session:\n\n```\n◇  Planning files detected\n│\n◇  Session 2  Build. Start [Provider] now?\n│  Yes\n│\n●  [Provider] will read prompt.md and start Phase 1.\n```\n\nYour provider reads `prompt.md` which instructs it to:\n\n1. Read the platform-specific `master_prompt.md` (tech stack rules, patterns, standards)\n2. Read `design-style-guide.md` (your custom design system)\n3. Read `jb-components.md` (component registry reference)\n4. Read `project-description.md` + `project-phases.md` (the plan)\n5. Start Phase 1 and stop after each phase for confirmation\n\n---\n\n**Web (Next.js) project:**\n\n```\nmy-app/\n├── .vibekit/                        \u003c- gitignored, auto-read by agent\n│   ├── master_prompt.md             \u003c- web tech stack rules + patterns\n│   ├── jb-components.md             \u003c- JB component registry reference\n│   ├── pre-deploy-review.md         \u003c- pre-deploy audit checklist\n│   └── ...other guides\n│\n├── src/\n│   ├── app/\n│   ├── components/\n│   └── lib/\n│\n├── next.config.ts\n├── tsconfig.json\n├── postcss.config.mjs\n├── .env.example\n└── CLAUDE.md                        \u003c- planning prompt injected\n```\n\n**Mobile (Expo) project:**\n\n```\nmy-app/\n├── .vibekit/                        \u003c- gitignored, auto-read by agent\n│   ├── master_prompt.md             \u003c- Expo tech stack rules + patterns\n│   ├── vibekit-native-components.md \u003c- Expo component registry\n│   └── ...other guides\n│\n├── app/                             \u003c- expo-router file-based routing\n│   ├── (tabs)/\n│   └── +api.ts\n│\n├── src/\n│   ├── lib/\n│   ├── providers/\n│   └── components/\n│\n├── app.json                         \u003c- Expo config\n├── eas.json                         \u003c- EAS Build config\n├── ech stacks by platform\n\n### Web (Next.js)\n\n| Layer         | Technology                  |\n| ------------- | --------------------------- |\n| Framework     | Next.js 16 (App Router)     |\n| Language      | TypeScript 5.9              |\n| Database      | Neon Serverless Postgres    |\n| ORM           | Prisma v7                   |\n| Auth          | Better Auth (cookies)       |\n| Data fetching | React Query + Fetch API     |\n| Validation    | Zod + React Hook Form       |\n| Styling       | Tailwind CSS v4 + shadcn/ui |\n| PDF           | @react-pdf/renderer         |\n| Excel         | xlsx                        |\n| Email         | Resend + React Email        |\n| Payments      | Stripe                      |\n| File storage  | Cloudflare R2 / UploadThing |\n| Deployment    | Vercel + Cloudflare         |\n| Components    | JB Component Registry       |\n\n### Mobile (Expo)\n\n| Layer         | Technology                           |\n| ------------- | ------------------------------------ |\n| Framework     | Expo SDK 55+ (React Native 0.83)     |\n| Language      | TypeScript 5.9                       |\n| Routing       | expo-router (file-based, like Next)  |\n| Database      | Neon Serverless Postgres             |\n| ORM           | Prisma v7 (HTTP adapter)             |\n| Auth          | Better Auth (@better-auth/expo)      |\n| State         | TanStack Query + Zustand             |\n| Storage       | react-native-mmkv + expo-secure-store |\n| Styling       | NativeWind v4 (Tailwind for RN)      |\n| API Routes    | Expo API Routes (app/api/**/+api.ts) |\n| Deployment    | EAS Build / EAS Submit / EAS Update  |\n| Components    | Vibekit Native Components (expo/)    |\n\n### Full-Stack (Turbo Monorepo)\n\nCombines both above with:\n\n| Layer             | Technology                            |\n| ----------------- | ------------------------------------- |\n| Monorepo          | Turbo                                 |\n| Package manager   | pnpm (workspaces)                     |\n| Shared database   | Neon Serverless Postgres (single db)  |\n| Shared schema     | Prisma v7 (one schema, both apps use) |\n| Shared auth       | Better Auth (web: cookies, mobile: secure store) |\n| Shared types      | `packages/types`                      |\n| Shared schemas    | `packages/schemas`                    |\n| API Routes        | Shared root or monorepo-based\n│           ├── user.ts\n│           └── index.ts\n│\n├── turbo.json                       \u003c- Turbo orchestration config\n└── pnpm-workspace.yaml              \u003c- Workspace definition\n```\n\nAfter Session 1 completes, the agent also generastack rules + Prisma v7 patterns\n│ ├── jb-components.md \u003c- JB component registry reference\n│ ├── pre-deploy-review.md \u003c- pre-deploy audit checklist\n│ ├── database-guide.md \u003c- Neon + Prisma reference\n│ ├── deployment.md \u003c- Vercel, Cloudflare, DNS\n│ ├── environment-variables.md \u003c- every env var, step by step\n│ ├── monetization-guide.md \u003c- Stripe, webhooks, billing\n│ ├── prompt-engineering.md \u003c- prompting techniques + rescue protocols\n│ └── troubleshooting.md \u003c- symptom -\u003e fix playbook\n│\n├── .env.example \u003c- base env template\n├── .gitignore \u003c- includes .vibekit/ and .env.local\n└── CLAUDE.md \u003c- planning prompt with your idea injected\n\n```\n\nAfter Session 1 completes, the agent also writes:\n\n```\n\n├── project-description.md\n├── project-phases.md\n├── design-style-guide.md\n└── prompt.md\n\n```\n\n---\n\n## Provider support\n\n| Provider       | Detect | Auth check                             | Tested |\n| -------------- | ------ | -------------------------------------- | ------ |\n| Claude Code    | Yes    | Credential file + `ANTHROPIC_API_KEY`  | Yes    |\n| Codex (OpenAI) | Yes    | `OPENAI_API_KEY`                       | No     |\n| Gemini CLI     | Yes    | Credential file + `GOOGLE_API_KEY`     | No     |\n| OpenCode       | Yes    | `OPENAI_API_KEY` / `ANTHROPIC_API_KEY` | No     |\n\nIf you test on a provider that isn't marked Yes, please open an issue or PR with your findings.\n\n---\n\n## The VibeKit standard stack\n\nEvery project built with this framework uses:\n\n| Layer         | Technology                  |\n| ------------- | --------------------------- |\n| Framework     | Next.js 16 (App Router)     |\n| Language      | TypeScript 5.9              |\n| Database      | Neon Serverless Postgres    |\n| ORM           | Prisma v7                   |\n| Auth          | Better Auth                 |\n| Data fetching | React Query + Fetch API     |\n| Validation    | Zod + React Hook Form       |\n| Styling       | Tailwind CSS v4 + shadcn/ui |\n| PDF           | @react-pdf/renderer         |\n| Excel         | xlsx                        |\n| Email         | Resend + React Email        |\n| Payments      | Stripe                      |\n| File storage  | Cloudflare R2 / UploadThing |\n| Deployment    | Vercel + Cloudflare         |\n| Components    | JB Component Registry       |\n\n---\n\n## Credits\n\nThis CLI is built on top of the **VibeKit Framework** created by [JB (Muke Johnbaptist)](https://jb.desishub.com) of [Desishub Technologies](https://desishub.com).\n\n- Original framework: [github.com/MUKE-coder/vibekit](https://github.com/MUKE-coder/vibekit)\n- JB Component Registry: [jb.desishub.com/blog/jb-component-registry-complete-reference](https://jb.desishub.com/blog/jb-component-registry-complete-reference)\n- Framework docs site: [vibekit.desishub.com](https://vibekit.desishub.com)\n\nThe planning prompts, master prompt, tech stack decisions, design system approach, and JB component registry are all JB's original work. This repo wraps them in a CLI so you don't have to copy-paste anything manually.\n\n---\n\n## Contributing\n\nThis is early software. It works, but it has rough edges, untested paths, and provider-specific quirks that haven't been hit yet. Contributions are very welcome.\n\nSee [CONTRIBUTING.md](./CONTRIBUTING.md) for the full guide.\n\nQuick ways to help:\n\n- **Found a bug?** [Open an issue](https://github.com/MUKE-coder/vibekit/issues/new?template=bug-report.md)\n- **Tested on an unsupported provider or OS?** Open an issue with your findings\n- **Fixed something?** Open a PR no ceremony required for bug fixes\n- **New provider support?** Add a file to `packages/create-vibekit-app/src/providers/` and open a PR\n\n---\n\n## License\n\nMIT use freely, build boldly.\n\n---\n\n_VibeKit Framework by [JB (Muke Johnbaptist)](https://jb.desishub.com) · CLI by the community_\n```\n\n## Star History\n\n\u003ca href=\"https://www.star-history.com/?repos=mosespace%2Fvibekit_pro\u0026type=date\u0026legend=bottom-right\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/chart?repos=mosespace/vibekit_pro\u0026type=date\u0026theme=dark\u0026legend=top-left\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/chart?repos=mosespace/vibekit_pro\u0026type=date\u0026legend=top-left\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/chart?repos=mosespace/vibekit_pro\u0026type=date\u0026legend=top-left\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmosespace%2Fvibekit_pro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmosespace%2Fvibekit_pro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmosespace%2Fvibekit_pro/lists"}