Skip to content

Velloria-ai/Vell

Β 
Β 

Repository files navigation

AI-Powered Browser IDE

A professional, full-featured coding environment powered by AI, running entirely in your browser.

AI-Powered IDE React TypeScript Tailwind

✨ Features

πŸ€– AI Assistant

  • Natural Language Code Generation: Describe what you want in plain English
  • Context-Aware Suggestions: AI understands your entire codebase
  • Real-time Streaming: See responses as they're generated
  • Smart Explanations: Get instant code explanations and debugging help

πŸ’» Professional Code Editor

  • Monaco Editor: The same editor that powers VS Code
  • Syntax Highlighting: Support for HTML, CSS, JavaScript, Python, and more
  • IntelliSense: Smart autocomplete and code suggestions
  • Error Detection: Real-time linting and error highlighting
  • Multi-file Support: Work on multiple files simultaneously

πŸ‘οΈ Live Preview

  • Real-time Updates: See changes instantly as you type
  • Sandboxed Environment: Safe execution of your code
  • Auto-refresh: Automatic updates on file changes
  • Error Boundaries: Graceful handling of runtime errors

🎨 Modern UI/UX

  • Dark & Light Themes: Toggle between themes with animated transitions
  • RGB Fluid Borders: Stunning animated border effects
  • Responsive Design: Works on desktop, tablet, and mobile
  • Distraction-free: Clean, modern interface inspired by Bolt.new and Lovable.dev

πŸ“ File Management

  • Virtual File System: All files stored in your browser
  • File Explorer: Easy navigation with file icons
  • Multi-file Editing: Switch between files seamlessly
  • Auto-save: Your work is automatically saved

πŸš€ Quick Start

Try it Now

Visit the live demo and start coding immediately!

Local Development

# Clone the repository
git clone <YOUR_GIT_URL>
cd <YOUR_PROJECT_NAME>

# Install dependencies
npm install

# Start development server
npm run dev

Open http://localhost:8080 in your browser.

πŸ“– How to Use

1. AI Assistant (Left Panel)

  • Type your request in natural language
  • Ask for code generation, explanations, or debugging help
  • Example: "Create a todo list component with React"

2. File Explorer (Middle-Left)

  • Click on files to open them in the editor
  • Toggle visibility with the "Hide Files" button
  • Files auto-save as you type

3. Code Editor (Center)

  • Full Monaco Editor with syntax highlighting
  • Use Ctrl+Space for autocomplete
  • Format code with Alt+Shift+F

4. Live Preview (Right)

  • See your HTML/CSS/JS rendered in real-time
  • Toggle preview with "Editor Only" button
  • Preview automatically updates on file changes

5. Theme Toggle (Top Right)

  • Switch between dark and light themes
  • Preference saved automatically
  • Animated RGB borders in both themes

πŸ› οΈ Technology Stack

  • Frontend: React 18, TypeScript, Tailwind CSS
  • Editor: Monaco Editor (@monaco-editor/react)
  • AI: Lovable AI Gateway (Google Gemini 2.5 Flash)
  • Backend: Supabase Edge Functions
  • Routing: React Router v6
  • UI Components: shadcn/ui
  • State: React Context API

πŸ“‚ Project Structure

β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”œβ”€β”€ ide/
β”‚   β”‚   β”‚   β”œβ”€β”€ PromptPanel.tsx      # AI chat interface
β”‚   β”‚   β”‚   β”œβ”€β”€ FileExplorer.tsx     # File navigation
β”‚   β”‚   β”‚   β”œβ”€β”€ MonacoEditor.tsx     # Code editor
β”‚   β”‚   β”‚   β”œβ”€β”€ LivePreview.tsx      # Preview window
β”‚   β”‚   β”‚   └── OnboardingModal.tsx  # Welcome screen
β”‚   β”‚   └── ui/                      # UI components
β”‚   β”œβ”€β”€ contexts/
β”‚   β”‚   β”œβ”€β”€ ThemeContext.tsx         # Theme state
β”‚   β”‚   └── FileSystemContext.tsx    # File state
β”‚   β”œβ”€β”€ hooks/
β”‚   β”‚   └── useChat.ts               # AI streaming
β”‚   └── pages/
β”‚       └── Index.tsx                # Main IDE page
β”œβ”€β”€ supabase/
β”‚   └── functions/
β”‚       └── chat/                    # AI backend
└── DEPLOYMENT.md                    # Deployment guide

🎯 Key Features Explained

Monaco Editor Integration

The IDE uses Monaco Editor, the same technology that powers Visual Studio Code:

  • Full TypeScript support
  • Rich IntelliSense
  • Code folding
  • Find and replace
  • Multi-cursor editing

AI-Powered Code Generation

Leverages Google's Gemini 2.5 Flash model:

  • Fast response times
  • Context-aware suggestions
  • Multi-language support
  • Free during promotional period

Virtual File System

Files are stored in browser memory:

  • Instant file switching
  • No server uploads needed
  • Privacy-first design
  • localStorage persistence

Live Preview Engine

Real-time rendering with:

  • Automatic CSS/JS injection
  • Sandboxed execution
  • Error recovery
  • Hot reload

πŸ”’ Security & Privacy

  • Client-side Storage: All files stay in your browser
  • Sandboxed Preview: Code runs in isolated iframe
  • No External Tracking: Privacy-first design
  • Secure AI Gateway: Backend API key management

β™Ώ Accessibility

  • Full keyboard navigation
  • ARIA labels on all controls
  • Screen reader support
  • High contrast themes
  • Focus management

🌐 Browser Support

  • Chrome/Edge 90+
  • Firefox 88+
  • Safari 14+
  • Opera 76+

πŸ“ Examples

Generate a React Component

Prompt: "Create a button component with hover effects"
AI generates: Complete React component with styling

Create a Landing Page

Prompt: "Build a modern landing page with hero section"
AI generates: HTML + CSS + responsive design

Debug Code

Prompt: "Why isn't my click handler working?"
AI explains: Event binding and common mistakes

πŸš€ Deployment

Lovable (One-click)

  1. Click "Share" β†’ "Publish"
  2. Done! Your IDE is live

Vercel

vercel --prod

Netlify

netlify deploy --prod

See DEPLOYMENT.md for detailed instructions.

🀝 Contributing

This is a template project - fork it and make it your own!

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

πŸ“„ License

MIT License - see LICENSE file for details

πŸ™ Acknowledgments

  • Monaco Editor by Microsoft
  • shadcn/ui for beautiful components
  • Lovable for the AI gateway
  • React team for the framework

πŸ“ž Support

  • Documentation: docs.lovable.dev
  • Discord: Join our community
  • Issues: Report bugs on GitHub

Built with ❀️ using Lovable, React, Monaco Editor, and AI

Live Demo | Documentation | Community

About

yuvi

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 97.7%
  • CSS 1.5%
  • Other 0.8%