Ship-ready infrastructure you can actually play with

One command spins up a complete production-grade stack, backend, frontend, databases, message bus, tracing, metrics, CI/CD, and a web dashboard, running entirely on your laptop. Experiment freely. Tear it down. Spin it back up. No cloud account, no billing surprise, no YAML to write.

npm install -g @blissful-infra/cli
blissful-infra start my-app

Your app is running at http://localhost:3000 in under a minute, backend, frontend, databases, message bus, tracing, metrics, CI/CD, and a local web dashboard all wired together and managed as a unit.

Choose your path

Three audiences, one toolchain. Pick the entry point that matches what you’re trying to do.

Learn

Students, new grads and engineers learning enterprise patterns without an AWS bill. A guided course from zero to a running Kubernetes service with Kafka, Postgres and Keycloak.

Start the Learn path →

Build

Engineers with an idea who want a fast experimentation loop. One command to a production-grade local stack, skip the theory, prototype now.

Start the Build path →

Deliver

Small studios and indie teams running multiple client projects. Per-client isolated stacks with their own Kafka, Postgres, observability and CI on one laptop.

Start the Deliver path →

Curious why blissful-infra runs real open-source services instead of bundling managed-service emulators? Read the philosophy →

Features

Sandbox in seconds

One command scaffolds and boots a complete Docker Compose stack: Spring Boot API, React frontend, Kafka, Postgres, Redis, Tempo tracing, Prometheus, Grafana, Loki, and nginx, isolated on your machine, ready to break and rebuild.

Full-Stack Templates

Choose from battle-tested templates for your backend (Spring Boot, FastAPI, Express, Go Chi) and frontend (React+Vite, Next.js). Each generated project is immediately yours, modify, delete, and recreate as many times as you want.

AI-Powered Development

A built-in AI debugging agent connects to your running sandbox via MCP. Ask Claude to diagnose errors, check service health, read logs, trigger builds, and deploy, without leaving your chat window.

Developer Dashboard

A local web UI gives you real-time log streaming, CPU/memory/latency metrics, Jenkins pipeline status, deployment history, and AI chat in one place at http://localhost:3002. Your own mission control, running offline.

What gets created

Running blissful-infra start my-app scaffolds a complete project directory and boots all services:

Service	URL	Purpose
Frontend	http://localhost:3000	React + Vite app served via nginx
Backend API	http://localhost:8080	Spring Boot REST + WebSocket API
Dashboard	http://localhost:3002	blissful-infra management UI
Grafana	http://localhost:3001	Pre-provisioned dashboards (metrics, logs, traces)
Prometheus	http://localhost:9090	Metrics scraping from /actuator
Tempo	http://localhost:3200	Distributed tracing (view traces inside Grafana)
Jenkins	http://localhost:8081	CI/CD pipelines (admin/admin)
Kafka	localhost:9092	Event streaming message bus
Postgres	localhost:5432	Primary relational database
Redis	localhost:6379	Cache layer (with postgres-redis)
Loki	localhost:3100	Structured log aggregation
Registry	localhost:5050	Local Docker image registry

Your sandbox, your rules

blissful-infra runs entirely on your laptop. Docker Desktop is the only external dependency. There are no cloud accounts to set up, no Kubernetes clusters to provision, no YAML to hand-write, and no per-hour costs ticking up while you work.

Spin up a project, experiment with the architecture, blow it away, and start fresh. The entire stack is isolated, reproducible, and disposable on demand. Everything that would normally require a DevOps team, service discovery, observability wiring, CI/CD pipelines, database migrations, is handled for you, and it all runs offline.

Deploy in two commands

Build locally. Ship with one more command.

# Build your sandbox
blissful-infra start my-app

# When you're ready to go live
blissful-infra deploy
# → Live at https://my-app.blissful-infra.com

Your local stack maps automatically to Cloudflare’s edge infrastructure, no config changes, no cloud account to set up. The same blissful-infra.yaml that defines your local environment defines your production one.

Local service	Hosted equivalent
React + Vite frontend	Cloudflare Pages
Express / Go backend	Cloudflare Worker
Postgres	Cloudflare D1
Redis	Cloudflare KV
Kafka	Cloudflare Queues

Vercel and AWS deploy targets are coming. Follow along on GitHub →