Skip to content

khushal-winner/Volt

Repository files navigation

⚡️ Volty – Your Open Source Micro SaaS AI Code Companion

Volty Logo

Generate, edit, and deploy full-stack web apps from natural language prompts

🚀 Live Demo📖 Documentation🐛 Report Bug✨ Request Feature

MIT License Next.js Convex


🌟 What is Volty?

Volty is an open-source, AI-powered micro SaaS platform that revolutionizes how developers create web applications. Simply describe what you want to build in natural language, and Volty generates complete, production-ready code using cutting-edge AI technology.

Perfect for rapid prototyping, learning, or building your next side project – Volty bridges the gap between ideas and implementation.

🎯 Who is Volty for?

  • Beginners learning web development
  • Experienced developers looking to prototype quickly
  • Entrepreneurs validating ideas without technical barriers
  • Teams needing rapid MVP development

✨ Features

🤖 AI-Powered Code Generation

Generate complete project structures, components, or code snippets using Google's Gemini API with intelligent context awareness.

💬 Interactive AI Chat Assistant

Get real-time help, code explanations, debugging assistance, and architectural advice through our integrated AI chat.

🖥 Live Workspace Environment

Edit and preview your code instantly with Sandpack's powerful in-browser development environment – no local setup required.

💾 Persistent Cloud Storage

Your projects are automatically saved and synced across all your devices using Convex's real-time database.

💰 Flexible Token System

Choose from multiple pricing tiers that scale with your usage, from free development to unlimited professional use.

🔒 Secure Authentication

Simple, secure login system with extensible authentication options for teams and organizations.

🎨 Beautiful, Customizable UI

Built with Tailwind CSS and Shadcn/UI components for a modern, responsive experience that you can easily customize.

🌐 Zero Installation Required

Fully browser-based platform – start coding immediately without any local development environment setup.


🚀 Quick Start

Prerequisites

1️⃣ Clone and Install

git clone https://github.com/khushal-winner/Volt.git
cd Volt
npm install

2️⃣ Environment Setup

Create .env.local in your project root:

# Required
NEXT_PUBLIC_CONVEX_URL=your_convex_deployment_url
NEXT_PUBLIC_GEMINI_API_KEY=your_gemini_api_key

# Optional (for payments)
NEXT_PUBLIC_PAYPAL_CLIENT_ID=your_paypal_client_id

3️⃣ Initialize Convex

npx convex dev

4️⃣ Start Development Server

npm run dev

Visit http://localhost:3000 and start building! 🎉


🌐 Live Demo

👉 Try Volty Live


🏗 Architecture Overview

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Frontend      │    │   Convex        │    │   AI Services   │
│   (Next.js)     │◄──►│   (Database)    │    │   (Gemini API)  │
│                 │    │                 │    │                 │
│ • React UI      │    │ • Projects      │    │ • Code Gen      │
│ • Sandpack      │    │ • User Data     │    │ • Chat         │
│ • Tailwind      │    │ • Real-time     │    │ • Context      │
└─────────────────┘    └─────────────────┘    └─────────────────┘

📂 Project Structure

app/
├── main/                    # Main application routes
│   ├── pricing/            # Pricing page
│   └── workspace/[id]/     # Dynamic workspace routes
├── api/                    # API endpoints
│   ├── ai-chat/           # AI chat functionality
│   └── gen-ai-code/       # Code generation endpoint
├── components/
│   ├── custom/            # Project-specific components
│   └── ui/                # Reusable UI components (Shadcn)
├── convex/                # Backend functions and schema
├── context/               # React context providers
├── hooks/                 # Custom React hooks
├── lib/                   # Utility functions
└── data/                  # Static configuration and prompts

💎 Pricing & Token System

Plan Tokens Price (₹) Best For
Free 10K ₹0 Learning & Testing
Basic 50K ₹4.99 Small Projects
Starter 120K ₹9.99 Regular Development
Pro 2.5M ₹19.99 Professional Use
Unlimited ₹49.99 Teams & Agencies

Note: Tokens are consumed based on AI model usage for code generation and chat interactions.


🛠 Tech Stack

Frontend

  • Next.js 15 - React framework with App Router
  • React 18 - UI library
  • Tailwind CSS - Utility-first CSS framework
  • Shadcn/UI - High-quality component library
  • Sandpack - In-browser code editor and preview

Backend & Database

  • Convex - Real-time database and backend functions
  • Google Auth (React) - Google OAuth authentication

AI & APIs

  • Google Generative AI - Gemini API for code generation
  • Custom AI Pipeline - Intelligent prompt engineering

Development

  • ESLint - Code linting
  • Prettier - Code formatting

🤝 Contributing

We welcome contributions! Here's how you can help:

🐛 Reporting Bugs

  • Use our issue template
  • Include steps to reproduce
  • Add screenshots if applicable

✨ Suggesting Features

💻 Code Contributions

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Commit your changes: git commit -m 'Add amazing feature'
  4. Push to branch: git push origin feature/amazing-feature
  5. Open a Pull Request

📋 Development Guidelines

  • Follow the existing code style
  • Write clear commit messages
  • Add tests for new features
  • Update documentation as needed

📋 Roadmap

🚧 Current (v1.0)

  • AI code generation
  • Live workspace
  • Project persistence
  • Token-based pricing
  • Basic authentication

🔮 Coming Soon (v1.1)

  • GitHub integration
  • Template marketplace
  • Team collaboration
  • Advanced AI models
  • Mobile responsive editor
  • Export to GitHub/Vercel

🌟 Future (v2.0)

  • Multi-language support
  • Plugin system
  • Advanced deployment options
  • Enterprise features
  • Advanced analytics

📚 Documentation

API Reference

Guides


🙏 Acknowledgments

  • Inspiration: Bolt.new for pioneering AI-powered web development
  • Technologies: Built on the shoulders of giants - Next.js, Convex, and Google AI
  • Community: Thanks to all contributors and users who make Volty better
  • Open Source: Standing on the foundation of amazing open-source projects

📞 Support & Community


🙏 Support Volty

If Volty helps you build amazing things, consider supporting the project:

  • Star this repository
  • 🐦 Share on Twitter
  • 🤝 Contribute to the project

Every contribution helps keep Volty free and open source!


📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


Built with ❤️ by Khushal

Empowering developers to build faster, smarter, and better

⚡ Try Volty Now🌟 Star on GitHub

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors