Vibely

AI-driven full-stack development orchestrator. Describe your app in plain English → production-ready web application.

Quick Start

npx vibely start                # CLI mode — interactive prompts

Or deploy the web UI:

git clone https://github.com/jordan-thirkle/Vibely
cd Vibely
npm install && npm run build:all
WEB_PORT=3333 node dist/web/server.js
# → http://localhost:3333

Or use the hosted version.

Features

| Surface | Capabilities | |---------|-------------| | Chat-first UX | Describe your app in plain English, AI handles architecture → code → deploy | | CLI (11 commands) | start, interactive, stage, refine, validate, audit, git, plugins, summary, init, generate-manifest | | Web UI (16 pages) | Chat, Dashboard, Manifest Editor, Pipeline Runner, File Viewer (Monaco), Architecture Diagrams, Kanban Board, Database Manager, Version History, Deploy, Settings, Pricing, Share | | AI Providers | OpenAI (GPT-4o), Anthropic (Claude 3.5), Google (Gemini 2.0 Flash), Mock (deterministic), Custom plugin | | Stack Modules | Frontend (React/Vue/Svelte + MD3), Backend (Express/FastAPI + Zod), Database (SQL/NoSQL/Prisma), Auth (JWT/OAuth/RBAC), Deploy (Docker/K8s) | | Live Preview | Auto-refreshing iframe of generated app | | Built-in Database | Auto-provisioned SQLite for generated apps with web-based query browser | | Version History | Snapshot and restore generated files with timeline UI | | Collaboration | Share project links (view-only) | | Custom Domains | DNS record generation for Fly.io and Vercel | | One-Click Deploy | Live log streaming for Fly.io and Vercel deployment | | Plugin System | Lifecycle hooks, custom providers, custom templates | | Git Integration | Auto-commits with emoji semantic messages | | 17 Prompt Templates | CRUD, auth, WebSocket, payments, file upload, admin panel, realtime | | Deployment | Dockerfiles, docker-compose, K8s manifests, Terraform IaC, CI/CD | | Review | AI code review covering security, a11y, performance, maintainability |

AI Providers

Set any of these environment variables for live generation:

| Provider | Env Variable | Model | |----------|-------------|-------| | OpenAI | OPENAI_API_KEY | GPT-4o | | Anthropic | ANTHROPIC_API_KEY | Claude 3.5 Sonnet | | Google | GOOGLE_API_KEY | Gemini 2.0 Flash |

Without API keys, Vibely uses a rich deterministic mock generator that produces production-quality code with realistic patterns.

Commands

vibely start                    Full 6-stage pipeline
vibely stage <name>             Run a single stage
vibely interactive              Human-in-the-loop with approve/reject
vibely refine "make buttons larger"  Natural language iteration
vibely validate                 Cross-layer consistency checks
vibely audit                    Lighthouse + Axe WCAG audits
vibely git status               Auto-commit history
vibely summary                  Project state overview
vibely generate-manifest        Create example vibely.yaml

Example Manifest

version: "1.0"
project:
  name: my-app
  description: A full-stack web application
  techStack: [react, express, postgresql]
  complexity: moderate

frontend:
  framework: react
  theme: material
  primaryColor: "#6200EE"
  features:
    - type: page
      name: Dashboard
      route: "/"

backend:
  framework: express
  language: typescript
  apiStyle: rest
  entities:
    - name: User
      fields:
        - name: email
          type: email
          required: true
        - name: name
          type: string
          required: true
      endpoints:
        - method: GET
          path: /api/users
          auth: true

database:
  type: postgresql
  orm: prisma
  migrations: true

auth:
  strategy: [jwt]
  rbac:
    roles:
      - name: user
        permissions: [read:own, write:own]
    defaultRole: user

deployment:
  provider: vercel
  containerization: docker
  ciCd: githubActions

Architecture

┌─────────────────────────────────────────────────────┐
│                    Vibely CLI                        │
├──────────┬──────────┬──────────┬──────────┬────────┤
│ Kickstart│  Design  │Implement │Integrate │ Review │
│   🚀    │   🎨    │   💻    │   🔗    │  👀   │
│ Architect│ Modules  │ Generate │Validate  │ Audit  │
├──────────┴──────────┴──────────┴──────────┴────────┤
│                 Consistency Checker                  │
│  API Contracts │ Data Flow │ Security │ A11y │ Tests │
├─────────────────────────────────────────────────────┤
│  Frontend  │ Backend │ Database │ Auth │ Deployment │
└─────────────────────────────────────────────────────┘

Standards Compliance

• WCAG 2.2 AA: ARIA labels, semantic HTML, keyboard nav, focus management, ≥4.5:1 contrast
• OWASP Top 10: JWT rotation, bcrypt, CSP, CORS, rate limiting, input sanitization
• Core Web Vitals: LCP <2.5s, FID <100ms, CLS <0.1
• Material Design 3: Design tokens, elevation, typography scale, responsive grid
• GDPR-ready: No PII in logs, data retention policies, consent management stubs

Development

npm install
npm run build       # TypeScript compilation
npm test            # Jest test suite (60 tests)
npm run typecheck   # Type checking

CI/CD

Push to main triggers GitHub Actions:

1. npm ci → npm run build → npm test
2. On success, auto-deploys to Fly.io via flyctl deploy --remote-only

Requires FLY_API_TOKEN secret in GitHub repository settings.

License

MIT