TUTORIAL INTERACTIVE GUIDE

Ship anything.
In 30 seconds.

A step-by-step animated walkthrough of every feature in Build & Ship. Scroll to begin.

Start Tutorial →
1
command
30s
to deploy
20+
frameworks
$0
forever
01 INSTALL

One line. That's it.

Install Build & Ship with a single command. Works on macOS and Linux.

Terminal
🍎
macOS
Apple Silicon & Intel. Homebrew or curl install.
🐧
Linux
x86_64 & ARM64. Single binary, zero dependencies.
🔄
Auto-Update
Silent background updates every 6 hours. Always on the latest.
02 FIRST DEPLOY

bs deploy. Done.

No config. No Dockerfile. No CI/CD setup. One command does everything.

🔍
Detect Framework
Scans your project, picks the right stack
📦
Build Container
Generates Dockerfile, builds with Docker/OrbStack
🚀
Launch & Route
Starts container, creates tunnel, provisions TLS
🌐
Live on the Internet
Public URL with HTTPS. QR code for mobile.
~/my-nextjs-app
03 SMART DETECTION

20+ frameworks. Zero config.

Build & Ship reads your code and knows exactly what to do. If it can't figure it out, AI takes over.

Next.jsReactVue NuxtSvelteKitAstro AngularRemixVite DjangoFlaskFastAPI ExpressNestJSFastify GoGinEcho Rust / ActixRailsSpring Boot DockerStatic HTMLHugo

AI Fallback

For unusual projects, the AI classifier kicks in. It reads your code, understands the structure, and either figures out how to deploy it — or tells you why it can't with a friendly explanation.

Try deploying an iOS project and you'll get a helpful message like: "This looks like an iOS app — it needs Xcode and the App Store, not a server."

~/my-ios-app
$ bs deploy
Analyzing project...
This is an iOS/Swift app
 
iOS apps need to be built with Xcode
and distributed through the App Store
or TestFlight — not a web server.
 
Try: open MyApp.xcodeproj
04 DEPLOY UI

Beautiful progress.
In your browser.

Add --ui and watch the deploy in a real-time web dashboard.

Terminal
$ bs deploy --ui
Opening browser...
Real-time SSE streaming

Framework detection, build progress, and deploy status stream live to your browser via Server-Sent Events. No polling, no websockets — just clean, instant updates.

localhost:54621/ui
BUILD & SHIP
Detecting framework
Next.js 14 detected
Building container
Built in 12.3s
Deploying
Container healthy
🎉
Deployed successfully!
https://my-app.buildandship.it
05 DEPLOY FROM ANYWHERE

Terminal. Finder. VS Code.

Three ways to deploy. Pick whichever feels right.

⌨️
Terminal
The classic. bs deploy from any directory.
$ bs deploy
Live!
🖱️
Finder Quick Action
Right-click any folder in macOS Finder.
📁 components
📁 my-app
📄 README.md
Quick Actions
🚀 Deploy with Build & Ship
💻
VS Code Extension
Deploy from the command palette or sidebar.
Command Palette
> Build & Ship: Deploy
⬡ Deploy current project
06 AI SELF-HEALING

Build fails?
AI fixes it.

When Docker builds fail, Claude analyzes the error, rewrites the Dockerfile, and retries — automatically.

~/my-django-app
🔨
Build Failures
Missing system deps, wrong Node version, broken installs — AI reads the error log, generates a fixed Dockerfile, and retries.
💊
Deploy Failures
Wrong port, missing env vars, crash loops — AI diagnoses health check failures and auto-fixes the configuration.
07 THE SWARM

Your machines.
Your cloud.

Turn any machine into a hosting node. Push code, and it deploys across your own infrastructure.

💻
You
git push
Controller
orchestrate
🖥
Node 1
● online
🖥
Node 2
● online
🖥
Node 3
● online
my-server
$ bs host start --name my-server
Node agent installed as system service
Connected to controller
Waiting for deploy tasks...

Self-Healing Nodes

Nodes recover from crashes, restarts, and network failures automatically. Containers are restored on boot. Health checks run continuously with auto-restart on failure.

Boot recovery WebSocket reconnect Container health checks Auto-restart
08 AUTO-DEPLOY

Push to deploy.

Link your GitHub repo and every push auto-deploys. No CI/CD config needed.

Terminal
$ bs link
Detected: myuser/my-app
GitHub Actions workflow created
Auto-deploy enabled on push to main
📝
git push origin main
GitHub Actions
Build → Push to GHCR
Controller
WebSocket → Node → Container
🌐
Live
Auto-TLS, zero downtime
09 THE TOOLKIT

Everything you need.
Nothing you don't.

Databases, domains, env vars, rollbacks, logs — the full stack, all from one CLI.

🗄️
Managed Services
bs service add postgres
One-click Postgres, MySQL, Redis, or MongoDB with auto-generated credentials.
🌍
Custom Domains
bs domain add myapp.com
Point any domain. Auto-TLS certificates via Cloudflare.
🔐
Encrypted Env Vars
bs env set SECRET=abc
AES-256-GCM encryption for sensitive keys. Auto-injected at deploy.
Instant Rollback
bs rollback
Blue-green rollback to any previous deploy. Zero downtime.
📋
Live Logs
bs logs my-app
Stream real-time container logs with follow mode.
🩺
Health Diagnostics
bs doctor
Full system check: runtime, disk, DNS, ports, tunnel, SSL.

Ready to ship?

Install in 10 seconds. Deploy in 30 more.

Terminal
$ curl -fsSL https://buildandship.it/install.sh | sh
Installed!
 
$ cd my-app && bs deploy
https://my-app.buildandship.it
← Back to Home Read the Docs