vibecarbon
v0.5.1
Published
Create and manage production-ready Vibecarbon applications
Downloads
1,985
Maintainers
Readme
Full-stack, security-hardened, auto-everything apps in minutes.
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 failover, auto-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 destroyCreate for free, always. Pay to deploy.
create,up,down, and all local development are free forever.deploy,destroy,backup,restore,failover, andscalerequire a Diamond or Fullerene license — a one-time payment, no subscriptions, your servers.
Open source under AGPL v3. Generated project code is MIT — you own your app.
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 allowlistWho 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.
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
- 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)
- MDX blog, changelog, documentation, and legal pages (privacy policy, terms of service)
- Client-side docs search with Cmd+K shortcut
- Internationalization (i18n) with language switcher
- Background jobs via pg_cron (zero extra infrastructure)
- Product analytics (Plausible — cookie-free, GDPR-compliant)
- Admin panel with user impersonation, notifications, jobs, contact, newsletter, and infrastructure dashboard
- 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 ($15-20/mo single region or compose HA, $30+/mo K8s multi-region HA)
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
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 |
Integration Guides
| Guide | Description | |-------|-------------| | n8n Integration | Workflow automation | | Observability | Prometheus, Grafana, Loki |
Performance
| Scenario | Cold deploy | Warm deploy | Backup | Restore | Scale | Destroy | | --- | ---: | ---: | ---: | ---: | ---: | ---: | | compose | 4m 37s | 33.3s | 15.7s | 4m 12s | 6m 12s | 42.9s | | compose-ha | 7m 44s | 3m 45s | 16.1s | 8m 15s | 9m 49s | 41.7s | | k8s | 10m 24s | 2.3s | 15.9s | 12m 34s | 2m 57s | 3m 35s | | k8s-ha | 15m 27s | 53.5s | 15.6s | 17m 37s | 9m 9s | 2m 22s |
End-to-end wall-clock from the last fully-green e2e matrix run against real Hetzner Cloud infra · run a2ec81a on 2026-05-19 · methodology: docs/tests.md.
License & Terms
The CLI is open source under the GNU Affero General Public License v3.0. Building from source is free for any use, forever.
Using the distributed npx vibecarbon package requires a license for deployment commands:
| Tier | Price | Who | |------|-------|-----| | Graphite | Free | Local dev — create, up, down, all add-ons | | Diamond | $149 lifetime | Full automation for indie hackers & startups | | Fullerene | $499 lifetime | Commercial license for agencies & enterprise |
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
