Documentation
Everything you need to give every git branch its own preview URL.
The fastest setup: let your AI assistant do it
Install the BTS Claude Code skill and ask Claude Code to set your repo up. It maps your services, writes a Dockerfile.bts per service and nexos.yaml, creates the project, and opens your first preview PR, asking you whenever there's a real choice to make.
curl -fsSL https://test.buildingswell.com/install-skill.sh | shUsing a different assistant? Point it at the AI Agent Spec.
The mental model
Three concepts and you have it.
Project
One GitHub repository. Configured once via nexos.yaml or the dashboard.
Environment
One branch of a project. Its own app, database, cache, storage, and preview URL.
Deployment
One push or pull-request event. A new non-draft PR creates the environment; every push to its branch redeploys it.
Browse the docs
Getting Started
Sign in, connect a GitHub repo, push a commit — your first preview URL in under five minutes.
Claude Code Skill
Install bts-setup and let Claude Code put your repo (or repos) on BTS — Dockerfiles, nexos.yaml, project, GitHub, first preview PR.
nexos.yaml
One file at the root of your repo configures the entire preview environment. Full field reference.
AI Agent Spec
The page to hand to your AI assistant. Self-contained instructions for generating nexos.yaml + Dockerfile.nexos.
Projects
Connect a repo, configure builds, services, and lifecycle hooks.
Deployments
What happens between git push and a live URL — brand new vs incremental, preview URLs, environment actions.
Environment Variables
Encrypted secrets, auto-injected service URLs, bulk import.
Workflows
Run your tests on BTS against the preview environment they belong to — triggers, jobs, steps, caching, and the exact check names.
Nodes
Run your own private compute nodes alongside the BTS-operated shared pool.
Install the Agent
Download the nexos-agent binary, verify checksums, run it under systemd.
Resource Limits
Per-project vCPU / vRAM ceilings, build constraints, and account quotas.
API Reference
Automate BTS programmatically. Authentication, endpoints, examples.