Vibe Website Builder

A production-ready, AI-powered platform for generating customized, functioning Next.js applications directly from prompts, powered by Gemini AI and secure E2B cloud sandboxes.

---

Overview

Vibe Website Builder leverages massive generative models to create, compile, and run fully-functional Next.js web applications on the fly. It utilizes Gemini's advanced chat completion capabilities, integrated seamlessly within deeply scalable background jobs via Inngest. Code execution is isolated using E2B Sandboxes to ensure a secure, fault-tolerant user experience with robust system tools.

Key Features

• Generative AI Engine: End-to-end integration with Google Gemini for powerful, prompt-based code generation.
• Secure Sandboxed Execution: Dynamic generation, linting, and execution inside isolated E2B containers.
• Modern Tech Stack: React, Next.js 15, Shadcn UI, and Tailwind CSS.
• Durable Workflows: Resilient background operations managed by Inngest.
• Typesafe API & DB: Powered by tRPC, Prisma ORM, and serverless PostgreSQL (NeonDB).

Getting Started

Prerequisites

Ensure you have the following installed and configured before proceeding:

• Node.js (v18 or higher)
• Docker (For local E2B sandbox workflows)
• Essential accounts:
  • Database provider (e.g., NeonDB)
  • Analytics/Jobs provider (Inngest)
  • Sandbox execution (E2B)
  • AI Engine (Google Gemini AI)

Installation

1. Clone the repository:

git clone https://github.com/your-org/vibe-website-builder.git
cd vibe-website-builder

2. Install dependencies:

npm install

3. Configure Environment Variables: Copy the template to initialize your configuration file:

cp .env.example .env

Ensure that GEMINI_API_KEY, DATABASE_URL, and other required secrets are configured properly within .env.

Database Setup

Utilize Prisma to scaffold your local PostgreSQL schema.

1. Init or push your schema:

npx prisma db push

2. Optionally, seed your database or generate standard migrations:

npx prisma migrate dev --name init_db

Local Development

Running this platform requires starting Next.js concurrently with the Inngest local development server.

1. Start the Next.js server:

npm run dev

2. Start the Inngest local server (in a separate terminal):

npx inngest-cli@latest dev

The primary interface will be available at http://localhost:3000.

System Architecture

AI & Agents

Vibe relies on dynamic prompting stored in src/prompt.ts, instructing Gemini AI to act as an expert UI/UX developer. The model interacts with the user directory dynamically.

Secure Containerization

Sandbox templates (sandbox-templates/nextjs/) provide the isolated environments where generated code is installed (npm i), compiled (npx next dev --turbopack), and verified.

Documentation Reference

For further details regarding the underlying tools, refer to their respective technical documentation:

• Next.js Documentation
• E2B Documentation
• Inngest Documentation
• tRPC Documentation
• Gemini API Documentation

Contributing

We welcome community contributions. Please ensure that all changes adhere to standard format conventions (npm run lint) and do not introduce hardcoded secrets.

License

MIT License. See LICENSE for more details.