Vibely

AI-driven full-stack development orchestrator. One YAML manifest → production-ready web application with zero manual coding.

Quick Start

npm install -g vibely           # Install globally
vibely generate-manifest        # Create vibely.yaml
# Edit vibely.yaml to your liking
vibely start                    # Run full pipeline

Or locally:

npx vibely start

What It Does

From a single YAML manifest describing your app, Vibely generates:

| Layer | Output | |-------|--------| | Architecture | Component tree, data flow diagram, tech stack justification, task breakdown | | Frontend | React/Vue/Svelte components with Material Design 3, WCAG 2.2 AA, full a11y | | Backend | Express/FastAPI REST API with Zod validation, pagination, error handling | | Database | PostgreSQL/MySQL/MongoDB schema with indexes, triggers, seed data | | Auth | JWT with refresh rotation, bcrypt, RBAC middleware, rate limiting | | 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 (36 tests)
npm run typecheck   # Type checking

License

MIT