Skip to content
Public template

About

VibeCraft AI — 2026 AI-powered visual app builder with an autonomous coding agent, real code IDE, live visual canvas, AI-assisted development, change diffs, validation, and synchronized Design ↔ Code workflows.

Resources

Stars

1 star

Watchers

1 watching

Forks

Repository files navigation

VibeCraft-AI

VibeCraft AI — 2026 AI-powered visual app builder with an autonomous coding agent, real code IDE, live visual canvas, AI-assisted development, change diffs, validation, and synchronized Design ↔ Code workflows.

VibeCraft AI 🚀

Describe it. See it. Build it.

VibeCraft AI is a next-generation AI-powered visual application builder that combines AI coding agents, a real code IDE, visual editing, live preview, and intelligent project management into one development environment.

Instead of switching between an AI chatbot, code editor, design tool, and browser preview, VibeCraft AI brings the complete workflow into one workspace.


✨ What is VibeCraft AI?

VibeCraft AI lets developers build applications using natural language while maintaining full control over the generated source code.

Core Workflow

Describe
   ↓
AI understands your project
   ↓
AI creates an implementation plan
   ↓
Review proposed changes
   ↓
Apply changes
   ↓
Code updates
   ↓
Visual canvas updates
   ↓
Validate
   ↓
Preview

The goal is simple:

AI handles repetitive development work while the developer remains in control.


---

🚀 Core Features

🤖 AI Coding Agent

VibeCraft AI includes an AI development agent capable of understanding the current project context.

The agent can:

Analyze project structure

Inspect files

Understand components

Create implementation plans

Generate code

Modify existing code

Fix errors

Refactor components

Explain code

Improve responsive layouts

Generate UI components

Propose dependencies

Validate changes


Agent Modes

ASK
PLAN
BUILD
FIX
REFACTOR
EXPLAIN


---

🎨 Visual App Builder

Build interfaces visually without losing access to the underlying code.

Supported visual operations include:

Select components

Move components

Resize components

Drag and drop

Edit text

Edit styles

Change spacing

Change typography

Change colors

Modify responsive behavior

Add components

Delete components

Reorder components



---

💻 Real Code IDE

VibeCraft AI is not just a visual mockup generator.

It includes a real development workspace for source code.

Supported

TypeScript
TSX
JavaScript
JSX
CSS
JSON
Markdown

IDE Features

File explorer

Syntax highlighting

Line numbers

Search

Replace

Code folding

Error indicators

Code selection

AI code actions

Problems panel

Agent activity

Project files

Change tracking



---

🔄 Design ↔ Code Synchronization

One of the core concepts of VibeCraft AI is keeping the visual editor and source code connected.

Visual Canvas
      ↕
Project State
      ↕
Source Code
      ↕
AI Agent

For supported components:

Visual Change
      ↓
Project Model
      ↓
Source Code
      ↓
Live Preview

And:

Code Change
      ↓
Validation
      ↓
Project State
      ↓
Visual Preview

This allows developers to move between visual editing and code editing without abandoning either workflow.


---

🧠 AI Change System

VibeCraft AI does not blindly overwrite project files.

Every significant AI modification follows:

REQUEST
   ↓
INSPECT
   ↓
PLAN
   ↓
CHANGE SET
   ↓
DIFF
   ↓
APPROVE
   ↓
APPLY
   ↓
VALIDATE

Example:

CHANGE SET #24

+ components/PricingSection.tsx
~ app/page.tsx
~ app/globals.css

Changes:
+ Added pricing component
+ Added responsive layout
+ Added pricing section

Users can:

Review

Apply

Reject

Undo

Redo



---

🔍 Diff Viewer

AI-generated changes can be reviewed before they are applied.

Example:

- <h1>Build your website</h1>
+ <h1>Build your next app with AI</h1>

Supported actions:

Apply
Reject
Apply All
Reject All


---

🛠️ AI Code Actions

Select code and ask the AI to:

Explain
Fix
Refactor
Optimize
Generate
Test

Example:

Select function
      ↓
Ask AI
      ↓
"Add error handling"
      ↓
AI generates diff
      ↓
Review
      ↓
Apply


---

🐛 AI Error Fixing

VibeCraft AI can analyze development problems such as:

TypeScript errors

Syntax errors

Import errors

Invalid props

Component issues

Responsive layout problems


Example:

ERROR

Property "variant" does not exist.

[ Explain ] [ Fix with AI ]

AI workflow:

Error
 ↓
Inspect relevant files
 ↓
Understand cause
 ↓
Generate fix
 ↓
Show diff
 ↓
User approval
 ↓
Apply
 ↓
Validate


---

👁️ Live Preview

Preview applications instantly without leaving the development environment.

Modes:

EDITOR
PREVIEW

Preview sizes:

Desktop
Tablet
Mobile

Example:

Desktop
1440px

Tablet
768px

Mobile
390px


---

📱 Responsive Visual Development

VibeCraft AI is designed mobile-first.

Preview:

Mobile

Tablet

Desktop

Large Desktop


Developers can inspect responsive layouts directly from the visual workspace.


---

📂 Project File System

Example project structure:

project/
│
├── app/
│   ├── page.tsx
│   ├── layout.tsx
│   └── globals.css
│
├── components/
│   ├── ui/
│   ├── layout/
│   └── sections/
│
├── lib/
│
├── public/
│
├── package.json
├── tsconfig.json
└── README.md


---

🗂️ Project Dashboard

Dashboard includes:

Recent projects

All projects

Project creation

Project duplication

Project renaming

Project deletion

Last modified information

Project status


Example:

┌─────────────────────────────┐
│ AI SaaS Dashboard           │
│ Next.js + TypeScript        │
│ Updated 5 minutes ago       │
│                             │
│ [Open Project]              │
└─────────────────────────────┘


---

📄 Pages System

Projects can contain multiple pages.

Example:

Home
About
Pricing
Contact
Dashboard
Settings

Users can:

Add pages

Rename pages

Duplicate pages

Delete pages

Switch between pages



---

🧩 Component System

Reusable components include:

Layout
Navigation
Hero
Heading
Paragraph
Button
Card
Image
Input
Form
Navbar
Footer
Section

Each component can have:

Props

Styles

Children

Responsive behavior

Source-file mapping



---

🧱 Component Model

VibeCraft AI uses a structured component/node model.

Example:

{
  id: "hero-title",
  type: "heading",
  props: {
    text: "Build Faster With AI"
  },
  style: {
    fontSize: 48,
    fontWeight: 700
  }
}

This structured representation allows the visual editor and AI agent to operate on the same project model.


---

↩️ Undo / Redo

VibeCraft AI provides project-level history.

Keyboard shortcuts:

Ctrl/Cmd + Z
Undo

Ctrl/Cmd + Shift + Z
Redo

Every major AI change can be reversed.


---

💾 Autosave

Project state is automatically persisted.

Phase 1 uses:

localStorage

The storage abstraction is designed so it can later be replaced with:

Firebase
Supabase
PostgreSQL

without rewriting the entire editor.


---

🧠 Project Memory

The AI can maintain project-specific context.

Example:

Project Rules

- Use TypeScript
- Use Tailwind CSS
- Reuse existing components
- Avoid unnecessary dependencies
- Maintain mobile responsiveness

The agent should follow these rules when generating code.


---

🔐 Security

Security is a core architectural requirement.

VibeCraft AI should implement:

Input validation

Safe file paths

Path traversal protection

Server-side API keys

Controlled development commands

Dependency approval

Destructive-action confirmation

Safe rendering

No secrets in client-side code


API Keys

Never expose keys such as:

GEMINI_API_KEY
OPENAI_API_KEY
ANTHROPIC_API_KEY

inside browser/client code.

Use server-side environment variables.


---

🧠 AI Provider Architecture

VibeCraft AI uses a provider-independent AI abstraction.

AI Gateway
     ↓
Model Router
     ↓
Provider Adapter
     ↓
AI Model

Potential providers:

Google Gemini
OpenAI
Anthropic

This architecture allows providers to be added or replaced without rebuilding the application.


---

⚡ AI Streaming

Where supported, AI responses can stream progressively.

Example:

Understanding project...

Inspecting files...

Planning changes...

Generating code...

Validating...

Changes ready.

If an AI provider fails:

AI service unavailable.

Your project was not modified.


---

📝 AI Conversation History

Project-level conversations can contain:

User prompts

AI responses

Selected files

Selected components

Error context

Change-set references

Timestamps


This allows users to continue development sessions without losing context.


---

🕘 Version History

Every major applied change can create a version.

Example:

v1 Initial project
v2 Added Hero
v3 Added Pricing
v4 Fixed Mobile Navigation
v5 Refactored Dashboard

Actions:

View
Compare
Restore

Restoring should create a new version rather than destroying existing history.


---

🎯 Design System

VibeCraft AI supports reusable design tokens.

Colors

Primary
Secondary
Background
Foreground
Muted
Border
Success
Warning
Error

Typography

Font Family
Heading Size
Body Size
Line Height
Font Weight

Spacing

XS
SM
MD
LG
XL

Radius

SM
MD
LG


---

🖥️ 2026 Interface

VibeCraft AI uses a modern AI-native development interface.

Design principles:

Dark-first

Clean typography

Minimal UI

Clear hierarchy

Responsive layouts

Subtle borders

Controlled animations

Professional spacing

Developer-focused workflows


Avoid:

Excessive gradients

Fake AI animations

Visual clutter

Unnecessary effects

Fake functionality



---

🏗️ Architecture

High-level architecture:

VIBECRAFT AI
                       │
          ┌────────────┴────────────┐
          │                         │
     VISUAL EDITOR              AI AGENT
          │                         │
          └────────────┬────────────┘
                       │
                PROJECT STATE
                       │
          ┌────────────┼────────────┐
          │            │            │
       CANVAS        CODE        HISTORY
          │            │            │
          └────────────┼────────────┘
                       │
                  VALIDATION
                       │
                    PREVIEW


---

🛠️ Technology Stack

Frontend

Next.js

React

TypeScript

Tailwind CSS


AI

Provider-independent AI gateway.

Compatible architecture for:

Gemini

OpenAI

Anthropic


Storage

Phase 1:

localStorage

Future:

Firebase
Supabase
PostgreSQL


---

📁 Recommended Structure

vibecraft-ai/
│
├── app/
│   ├── dashboard/
│   ├── project/
│   │   └── [id]/
│   ├── layout.tsx
│   └── globals.css
│
├── components/
│   ├── ai/
│   ├── canvas/
│   ├── dashboard/
│   ├── editor/
│   ├── inspector/
│   ├── sidebar/
│   └── ui/
│
├── lib/
│   ├── actions/
│   ├── ai/
│   ├── canvas/
│   ├── storage/
│   └── workspace/
│
├── types/
│
├── public/
│
├── package.json
├── tsconfig.json
├── tailwind.config.ts
└── README.md


---

🚀 Getting Started

1. Clone

git clone https://github.com/YOUR_USERNAME/vibecraft-ai.git

cd vibecraft-ai

2. Install dependencies

npm install

3. Create environment file

cp .env.example .env.local

Add your server-side AI configuration.

Example:

GEMINI_API_KEY=your_key_here
OPENAI_API_KEY=your_key_here
ANTHROPIC_API_KEY=your_key_here

Only configure the providers you actually use.

4. Run development server

npm run dev

Open:

http://localhost:3000


---

🧪 Development

Run development:

npm run dev

Build:

npm run build

Start production:

npm run start

Lint:

npm run lint

Type checking:

npm run typecheck


---

🧪 Phase 1 Acceptance Test

Create Project
      ↓
Open Project
      ↓
Select Component
      ↓
Edit Component
      ↓
Add Component
      ↓
Responsive Preview
      ↓
Undo
      ↓
Redo
      ↓
Refresh
      ↓
Verify Persistence


---

🤖 Phase 2 Acceptance Test

Create Project
      ↓
Open AI Agent
      ↓
Request Change
      ↓
Agent Inspects Project
      ↓
Plan
      ↓
Change Set
      ↓
Diff
      ↓
Approve
      ↓
Code Updated
      ↓
Canvas Updated
      ↓
Validation
      ↓
Preview


---

🗺️ Roadmap

Phase 1 — Visual Builder

[x] Project dashboard

[x] Project creation

[x] Visual canvas

[x] Component system

[x] Inspector

[x] Pages

[x] Drag & drop

[x] Responsive preview

[x] Preview mode

[x] Undo / redo

[x] Local persistence

[x] AI command foundation


Phase 2 — AI Agent + Code IDE

[x] AI Agent architecture

[x] Code workspace

[x] File explorer

[x] Code editor

[x] AI code actions

[x] Project context

[x] Implementation plans

[x] Change sets

[x] Diff viewer

[x] Validation

[x] AI error fixing

[x] Version history

[x] Design ↔ Code synchronization


Phase 3 — Backend Builder

Planned:

[ ] Database builder

[ ] Authentication

[ ] API builder

[ ] Environment management

[ ] Firebase integration

[ ] Supabase integration

[ ] PostgreSQL support


Phase 4 — Automation

Planned:

[ ] Visual workflow builder

[ ] API workflows

[ ] AI workflows

[ ] Scheduled tasks

[ ] Webhooks

[ ] Automation agents


Phase 5 — Production Platform

Planned:

[ ] GitHub integration

[ ] Deployment

[ ] Domains

[ ] Team collaboration

[ ] Usage analytics

[ ] Billing

[ ] Templates marketplace



---

🎯 Product Vision

VibeCraft AI is designed around one principle:

> AI should accelerate software development without taking control away from the developer.



The developer should be able to move freely between:

IDE
Visual Builder
AI Agent
Code
Preview
Testing

without losing project context.


---

🔥 Why VibeCraft AI?

Traditional workflow:

Design Tool
     ↓
Code Editor
     ↓
AI Chat
     ↓
Browser
     ↓
Terminal
     ↓
Debugger
     ↓
Repeat

VibeCraft AI:

VIBECRAFT AI

        ┌─────────────────────┐
        │     AI AGENT        │
        └──────────┬──────────┘
                   │
        ┌──────────▼──────────┐
        │    PROJECT STATE    │
        └──────┬────────┬─────┘
               │        │
       ┌───────▼───┐ ┌──▼───────┐
       │  DESIGN   │ │   CODE   │
       └───────┬───┘ └──┬───────┘
               │        │
               └────┬───┘
                    ▼
               LIVE PREVIEW


---

🤝 Contributing

Contributions are welcome.

Recommended workflow:

Fork
 ↓
Create branch
 ↓
Make changes
 ↓
Run tests
 ↓
Run lint
 ↓
Create Pull Request

Example:

git checkout -b feature/ai-agent


---

📜 License

Choose and add the appropriate open-source license before public release.


---

⚠️ Project Status

VibeCraft AI is under active development.

The architecture is being developed incrementally:

Phase 1
Visual Builder
      ↓
Phase 2
AI Agent + Code IDE
      ↓
Phase 3
Backend Builder
      ↓
Phase 4
Automation
      ↓
Phase 5
Production Platform

Features marked as planned should not be represented as production-ready until they are actually implemented and tested.


---

⭐ VibeCraft AI

Describe it. See it. Build it.

AI-native software development for the next generation of builders.

About

VibeCraft AI — 2026 AI-powered visual app builder with an autonomous coding agent, real code IDE, live visual canvas, AI-assisted development, change diffs, validation, and synchronized Design ↔ Code workflows.

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages