What is Vibecarbon?

Vibecarbon is a full-stack SaaS starter that combines React 19, Vite, Tailwind v4, Hono, and self-hosted Supabase — with automated DevOps built in.

Skip the choice between vendor lock-in and DIY infrastructure. Create web applications with authentication, billing, teams, email, blog, docs, i18n, and production deployment — without a dedicated DevOps engineer.

Includes Docker Compose, Kubernetes, High-Availability with replication and one-command failover, scaling, and automated backups.

Quick Start

# Create a new project
npx vibecarbon create my-app

# Start local development
cd my-app
npx vibecarbon up

# Deploy an environment
npx vibecarbon deploy

# Tear down an environment
npx vibecarbon destroy

Commands

USAGE
  npx vibecarbon <command> [options]

DEV COMMANDS
  create <project-name>    Create a new Vibecarbon project
  up                       Start local development environment
  down                     Stop local development environment
  status                   Show project and deployment status
  reset                    Reset local environment (removes all data)
  configure                Configure external services (billing, OAuth, SMTP, etc.)
  add <feature>            Add features (observability, redis)
  remove <feature>         Remove features from a project
  upgrade                  Upgrade infrastructure files to latest template

DEPLOY COMMANDS
  deploy [environment]     Deploy an environment (interactive picker for mode/region)
  destroy [environment]    Tear down cloud environment
  backup [environment]     Create, list, or download database backups
  restore [environment]    Restore database from backup
  failover [environment]   Initiate failover to standby region
  scale [environment]      Scale worker nodes and instance sizes

DEBUG COMMANDS
  shell [environment]      Interactive bash with KUBECONFIG + cloud creds exported
  diagnose [environment]   Dump full cluster state to ~/.vibecarbon/diag-*
  console <node>           Open Hetzner's web VNC console for a node
  access [subcommand]      Manage SSH + k8s-API operator-CIDR allowlist

Who It's For

Indie Hackers & Solopreneurs — Ship faster, spend less, own everything. Launch a production grade MVP this weekend.

Startup Founders & Small Teams — Enterprise architecture without the complexity. Multi-tenant organizations, auto-scaling, and high-availability when you need it.

Agencies & Consultancies — One stack for every client project. Consistent, production-ready foundation with easy handoff.

Where Vibecarbon Fits

If you already self-host with tools like Coolify or Dokploy, Vibecarbon lives in the same world: your servers, your data, no platform lock-in. The difference is where it starts.

| | You bring | You get | |---|---|---| | Coolify / Dokploy | An app you've already built | A self-hosted PaaS dashboard that deploys it | | Vibecarbon | An idea | The SaaS codebase itself — auth, billing, teams, admin — plus a CLI that deploys and operates it, from one Docker Compose server to multi-region Kubernetes with failover |

Same family, different starting point. If your app already exists, those tools are great homes for it. If you're starting a SaaS from zero, Vibecarbon hands you the application and the infrastructure.

Key Benefits

Application Layer

• Auth (email, OAuth, magic links, MFA) + brute force protection
• Multi-provider billing (Stripe, Paddle, Polar) with subscriptions, checkout, and plan gating
• Multi-tenant organizations with RBAC
• Admin panel with user impersonation, notifications, jobs, contact, newsletter, and infrastructure dashboard
• MDX blog, changelog, documentation, and legal pages (privacy policy, terms of service)
• Internationalization (i18n) with language switcher
• Background jobs via pg_cron (zero extra infrastructure)

• Guided onboarding flow
• Contact form with admin panel and email notifications
• Newsletter with double opt-in, admin compose/send, and CSV export
• File uploads via S3-backed storage (Hetzner Object Storage)
• Transactional email (SMTP)
• Client-side docs search with Cmd+K shortcut
• Product analytics (Plausible — cookie-free, GDPR-compliant)
• SEO (meta tags, sitemap, RSS feed)

Infrastructure

• New environments in minutes
• Security hardened from day one
• Automated deployments via CI/CD
• Auto-scaling (2-10+ replicas)
• Multi-region high availability
• VPS native (you own & control)
• Auto backup & restore
• Live monitoring & alerts (Grafana, Prometheus, Loki)
• Zero vendor lock-in
• Cost effective — runs on inexpensive VPS hosting, a fraction of hyperscaler pricing

Developer Experience

• AI-ready codebase (Claude Code, Cursor, Windsurf, Copilot rules included)
• 50+ Shadcn UI components
• Full TypeScript across client and server
• Biome linting/formatting, Vitest test suite

Architecture

One CLI, four deploy modes — pick per environment. Every mode includes automated SSL, backups, and monitoring.

flowchart LR
    CLI(["npx vibecarbon deploy"])
    CLI --> C["compose<br/>one server · free"]
    CLI --> CH["compose-ha<br/>primary + standby · streaming replication"]
    CLI --> K["k8s<br/>k3s cluster · autoscaling workers"]
    CLI --> KH["k8s-ha<br/>multi-region · one-command failover"]

Documentation

| Document | Description | |----------|-------------| | Technical Guide | Architecture, code examples, API patterns, scripts | | Design Guide | Brand identity, visual design, UX principles | | Test Suite | Test types, coverage, and how to run them |

Deployment Guides

| Guide | Best For | |-------|----------| | Hetzner Cloud | Cost-effective VPS hosting (single-node + HA) | | Kubernetes README | K8s autoscaling, worker bounds configuration, HA cluster setup |

DigitalOcean ships in-tree as a reference provider — how the interface maps to a second cloud — for compose and compose-ha; k8s and k8s-ha stay Hetzner-only. The deploy wizard's provider prompt labels it accordingly; no standalone guide yet.

Integration Guides

| Guide | Description | |-------|-------------| | Observability | Prometheus, Grafana, Loki |

Performance

Real numbers, not estimates — every cell is wall-clock time from the last fully-green end-to-end run against real cloud infrastructure.

| Scenario | Cold deploy | Warm deploy | Backup | Restore | Scale | Destroy | | :--- | :---: | :---: | :---: | :---: | :---: | :---: | | ✅ compose | 4m 16s | 25.3s | 12.2s | 4m 40s | 4m 26s | 2m 34s | | ✅ compose-ha | 5m 51s | 2m 29s | 11.9s | 6m 29s | 4m 47s | 2m 34s | | ✅ k8s | 7m 54s | 10.8s | 26.6s | 7m 0s | 2m 48s | 5m 59s | | ✅ k8s-ha | 8m 28s | 1m 3s | 25.9s | 12m 33s | 4m 20s | 6m 33s |

End-to-end wall-clock from the last fully-green e2e matrix run against real Hetzner Cloud infra · run 021a5c2 on 2026-07-21 · measured from GitHub-hosted runner → ash/hil · methodology: docs/tests.md.

License & Terms

The CLI is Fair Source under the Functional Source License 1.1 with MIT future license. Building from source is free for any non-competing use — and every release automatically becomes MIT open source two years after publication.

Using the distributed npx vibecarbon package requires a license for advanced deploy modes:

| Tier | Price | Who | |------|-------|-----| | Graphite | Free | Local dev, all add-ons, single-server Compose production deploys, and upgrade (free on every tier) | | Fullerene | $149 | Compose HA, Kubernetes, Kubernetes HA & GitOps CI/CD, for your own products | | Agency | Contact us | Deploy for clients and enterprise — white-label or resell |

See TERMS.md for full usage terms. Generated project code is MIT — you own your app outright.

Support

• GitHub Issues: Report bugs or request features
• GitHub: github.com/hyperformant/vibecarbon