Development

Requirements

Bun for workspace installs and scripts
Node.js 18+
tmux and cloudflared for end-to-end tests
Daytona API key + git credentials for the sandbox integration test (optional)
Playwright for UI e2e tests

bun install

bun run dev:beam

This builds the CLI, starts the local server on a fixed port, and launches the Vite dev UI with proxies for /api, /ws, and /s.

TERMBRIDGE_SESSIONS=2 bun run dev:beam

Or use the shortcut:

bun run dev:beam:multi

When developing without HTTPS:

TERMBRIDGE_INSECURE_COOKIE=1 bun run dev:beam

bun run test

test:mocked runs unit/integration tests with 100% coverage.
test:cli runs real CLI + UI e2e tests (tmux + cloudflared + Playwright). It also runs the Daytona sandbox test when TERMBRIDGE_E2E_DAYTONA=1 and the Daytona env vars are set in termbridge-test-app/.env.

The docs live in apps/docs and use Onedocs + Fumadocs.

bun run --cwd apps/docs dev

Build:

bun run --cwd apps/docs build