Welcome to VibeFast

VibeFast is a monorepo starter that pairs Expo + React Native with Next.js so mobile, web, SaaS dashboards, and docs live together. Choose between Convex (TypeScript, real-time reactive) or Supabase (PostgreSQL, Row-Level Security) as your backend during vf init—both are fully integrated with shared auth, storage, AI features, and payments. The VF CLI (vf) sits on top of all of it—one command lets you scaffold a clean project, another lets you add or remove features on demand.

Built for every platform, from dedicated mobile to full SaaS

• Mobile + Web in one workspace – share UI tokens, type definitions, and backend functions while keeping each client optimised for its platform.
• Next.js runs marketing, docs, admin panels, dashboards, or full SaaS flows with pages and API routes already wired into the monorepo.
• Expo + React Native powers the native apps with modern UI, voice, chat, AI, and payment flows that reuse the same backend.
• Your backend is the single source of truth: one database, one auth configuration, real-time subscriptions, and file storage for every platform—whether you choose Convex or Supabase.

The VF CLI is how you keep the starter lean yet powerful

The CLI is not just an installer—it’s the integration manager for VibeFast:

• vf init walks you through Clean (just the essentials) or Custom (pick integrations up front) setups, plus backend choice (Convex or Supabase) and platform choices (Native, Web, or the full monorepo).
• vf add <feature> installs the React Native, Next.js, and backend code needed for chatbot, image-generator, voice recordings, analytics dashboards, subscriptions, tracker app, and more.
• vf remove <feature> cleanly rolls back an integration when the scope changes.
• vf list shows what features you currently have.
• Every CLI workflow requires you to log in first with your license key (this gives you repo access plus CLI feature management).

Clean or Custom, you can always add or remove modules later, so the starter works whether you want just a mobile app, just a web SaaS, or both.

Features that ship with the starter kit

The repo already includes playable implementations of every integration you can add with the CLI. All features work with both backends unless noted:

• Chatbot & voice assistant with streaming AI responses, tool use, and optional voice input. RAG (knowledge retrieval) is available with Convex.
• Image generator + analyzer flows for AI-created art and insight screens.
• Quick actions, charts, and smart dashboards for navigation shortcuts and data visuals in both web and mobile clients.
• Payments & subscriptions wired with RevenueCat to manage tiers, consumables, and coins.
• Audio recorder, voice bot, wake-word detection, and tracker app (the tracker app is a calorie & habit tracker with great UI, not an analytics tool).
• Authentication via your chosen backend (email, Google, Apple, GitHub, and guest sessions) plus the hooks/UI screens for guarding routes.

Use CLI commands to scope any of the above into your project, then tweak the React Native and Next.js clients with the shared UI system.

Two paths to get started

1. Start with the CLI (recommended)

1. Install the CLI: npm install -g vibefast-cli
2. Log in with your license key: vf login --token YOUR_LICENSE_KEY
3. Scaffold a project: vf init
   • Choose your backend: Convex or Supabase.
   • Choose Clean for the bare essentials or Custom to pick features up front.
   • Select platforms (Native, Web, or Both).
   • Give the project a name—everything else is wired for you.
4. Add features at any time: vf add chatbot, vf add image-generator, etc.
5. Remove features as requirements change: vf remove chatbot.

You keep your features lean no matter how big the product scope becomes.

2. Manual monorepo setup (for learning or custom workflows)

1. Fork the vibefast repo on GitHub.
2. Clone your fork:

   git clone https://github.com/<your-username>/vibefast.git
   cd vibefast

3. Install dependencies: pnpm install
4. Copy the backend .env.example to .env.local and fill in your backend credentials (Convex or Supabase), AI keys, and auth/provider secrets.
5. Start the backend: pnpm dev:server
6. Start the native client: pnpm dev:native
7. (Optional) Run the web client: pnpm dev:web

If you ever want to pull the CLI story back in, you can still run vf add/vf remove inside this manual copy after logging in with your license key.

What to read next

• Choose Your Backend
• CLI Quick Start
• Manual Monorepo Setup
• Technology Stack
• Core Concepts