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. The Convex backend is shared across every client, which keeps real-time data, auth, files, AI agents, and payments consistent without copy/paste. 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 Convex 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 Convex backend.
• Convex is the single source of truth: one database, one auth configuration, one set of agents, real-time subscriptions, and file storage for every platform.

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 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. Highlights include:

• Chatbot & voice assistant powered by Convex AI agents, streaming models, knowledge retrieval, and optional voice input.
• Image generator + analyzer flows for AI-created art and insight screens backed by Convex actions.
• Quick actions, charts, and smart dashboards for navigation shortcuts and data visuals in both web and mobile clients.
• Payments & subscriptions wired with RevenueCat and Convex 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 Convex Auth (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 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 the Convex deployment, AI keys, and auth/provider secrets.
5. Spin up Convex: 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

• CLI Quick Start
• Manual Monorepo Setup
• Technology Stack
• Core Concepts