README.md

Webu

The Open Source Lovable Alternative

Build stunning full-stack web apps with natural language.

Warning

Webu is currently in very early development. Features are experimental and APIs may change. Use with caution in production environments.

🚀 About Webu

Webu is an open-source AI web builder that turns your text descriptions into production-ready React applications. It's designed to be a free and hackable alternative to tools like Lovable/v0, giving you complete control over your code and infrastructure.

Why Webu?

• 💸 Open Source & Free: No subscriptions, no locked-in platforms.
• ⚡ Instant Previews: See your changes in real-time with our sandboxed preview environment.
• 🎨 Modern Stack: Generates clean, modern code using React, Tailwind CSS, and Lucide Icons.
• 🔒 Privacy Focused: Run it locally, use your own API keys.
• 🛠️ Hackable: It's just a Next.js app. Customize it to fit your workflow.

✨ Features

• Natural Language Parsing: Describe your app in plain English.
• Real-time Preview: Interactive sandbox to test your generated app instantly.
• Client-Side Generation: Runs in the browser or on lightweight servers.
• Iterative Refinement: Ask for changes and see updates immediately.
• Export to CodeSandbox: One-click export to continue development.

🛠️ Tech Stack

• Framework: Next.js 16 (App Router)
• Language: TypeScript
• Styling: Tailwind CSS 4
• AI SDK: Vercel AI SDK
• AI Models:
  • Google Gemini 3 Pro
  • Anthropic Claude
  • OpenAI GPT
• Code Editor: Monaco Editor (VS Code's editor)
• Sandbox: Sandpack by CodeSandbox
• State Management: Zustand
• Icons: Lucide React
• Schema Validation: Zod

⚡ Getting Started

Prerequisites

• Node.js 18+
• npm/yarn/bun
• An API Key for Gemini (Get one here)

Installation

1. Clone the repo

   git clone https://github.com/yourusername/webu.git
   cd webu

2. Install dependencies

   bun install
   # or
   npm install

3. Set up Environment Variables Create a .env file in the root directory:

   GOOGLE_GENERATIVE_AI_API_KEY=your_gemini_api_key_here

4. Run the development server

   bun run dev
   # or
   npm run dev

5. Open your browser Navigate to http://localhost:3000 to start building!

🤝 Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

See CONTRIBUTING.md for detailed guidelines.

📜 License

Distributed under the MIT License. See LICENSE for more information.

🌟 Support

Give a ⭐️ if you like this project!