Skip to main content
01Developer infrastructure

Build & Ship

by Yashesh Bharti
A peer-to-peer deployment platform built by Yashesh Bharti for developers who want to ship software without traditional cloud complexity. One command, your own hardware, no vendor lock-in.
Status
Live
Version
v0.10.2
Price
Free
01Problem

The deployment tax

A developer can build a working app with AI in twenty minutes and then spend two hours wiring up a deployment. Pick a cloud, configure a project, set environment variables, learn a vendor's deploy graph, hit a free-tier ceiling, and finally pay a monthly bill for something that used to be a single binary on a single box. Build & Ship exists because that tax should not be the cost of shipping software.
02Product

One command, your hardware

bs deploy takes the project in your current directory and ships it to a node you own. Auto-detects 15+ frameworks, generates a Dockerfile when needed, performs a blue-green swap behind a health check, and hands back a live URL. Average end-to-end time is around eight seconds for a warmed-up node.

bs link wires the repo to GitHub so every push redeploys. Three surfaces ship in the box: the CLI, a VS Code extension, and a macOS Finder right-click that lets you deploy any folder without a terminal.

03What I built

Capabilities

Detection
Framework auto-detect at ~97% accuracy across 15+ frameworks. Generates a Dockerfile when one is missing.
Deploys
Blue-green strategy. Health-checked version swap with automatic rollback on failure.
CI/CD
GitHub OAuth. One command links a repo and redeploys on every push.
Security
API keys encrypted with AES-256 and stored locally. Secrets never leave your machine.
Node Swarm
Multi-machine deploys. A 6-factor placement algorithm picks which node runs which workload.
Monitoring
Real-time observability. Per-node CPU, memory, and bandwidth, SSE event streaming, full audit log of every mutation.
04Architecture

Five layers, purpose-built

No third-party orchestrator. Build & Ship is five layers of custom Go code: a placement scorer, a 100-point node reliability scorer, a three-layer health prober, a WireGuard control plane, and a blue-green swap engine. Failures are caught in under fifteen seconds through WebSocket heartbeats, HTTP probes, and Docker inspection running in parallel.

DNS, TLS provisioning, and preview deploys are all done in-process. The same binary runs as the local CLI, the relay, and the node agent.

05Technical stack

Stack

Core
Go (~15k LOC)
Networking
WireGuard mesh
Secrets
AES-256, local
Containers
Docker isolation
Surfaces
CLI, VS Code extension, Finder right-click
Auth
GitHub OAuth
06Product decisions

Choices that matter

  • Reject Kubernetes and Terraform as a baseline. Most users do not need an orchestrator. A binary, a tunnel, and a swap engine handle 95% of single-product deploys, and the remaining 5% can be solved with the swarm layer.
  • Secrets stay on the machine that knows them. No central vault, no cloud KMS dependency. AES-256 locally and a short-lived relay token are enough for the threat model.
  • One binary, three surfaces. CLI for engineers, VS Code for editors, Finder right-click for non-engineers on the same team. The deploy itself is identical from each.
  • Free forever, by construction. There is no cloud to bill. The user provides the hardware, the binary does the work, and the relay is cheap enough to run as a public service.
07Security and privacy

Threat model

Secrets are encrypted with AES-256 at rest on the user's machine. Node-to-node traffic is carried over WireGuard. The relay holds short-lived tokens for routing only and cannot decrypt secrets or read application traffic. There is no central database of customer code, customer secrets, or customer logs.

08Outcome

What ships today

Build & Ship is live at version 0.10.2 with support for the major Node, Python, Go, and Rust frameworks plus static sites. Install is a single curl command on macOS and Linux. A dashboard at controller.buildandship.it gives fleet metrics, deploy history, and real-time alerts.

09Links

Read more

← All work notesBuild & Ship / by Yashesh Bharti