Two roles, zero friction

Operators set up the infrastructure once. Users deploy with a single command. Everyone stays productive.

User

Deploy in three steps

You're a developer who needs to share static sites quickly. Your operator has already set up bassh—you just need an invite code to get started.

Install the CLI

One command installs bassh and adds it to your PATH.

curl -fsSL https://raw.githubusercontent.com/get-bassh/bassh-site/main/install.sh | bash

source ~/.zshrc

Register with your invite code

Your operator gives you an invite code. Use it to create your account.

bassh register your-username --invite subdomain:secretcode

✓ Registered as your-username

Deploy your site

Point bassh at any folder. Add a password for protection.

bassh ./my-project -p "secret123"

Deploying 3 files...

✓ Site deployed successfully

https://you-my-project.pages.dev

Operator

Set up once, invite your team

You manage the Cloudflare infrastructure. Deploy the Worker, generate invite codes, and let your team deploy without any Cloudflare account setup.

Create Cloudflare resources

Create an API token with Workers and Pages permissions. Create a KV namespace for user data.

# In Cloudflare dashboard:

# 1. Create API token (Workers + Pages permissions)

# 2. Create KV namespace: bassh-users

# 3. Note your Account ID

Deploy the Worker

Clone the repo, configure wrangler.toml with your values, and deploy.

git clone https://github.com/get-bassh/bassh-site

cd bassh/worker

# Edit wrangler.toml with your account_id, kv_namespace_id

wrangler secret put CF_API_TOKEN

wrangler deploy

Generate invite codes

Create invite codes for your team members. Each code is single-use.

curl -X POST https://your-worker.workers.dev/admin/invite \

-H "Authorization: Bearer $ADMIN_TOKEN"

{"invite": "yoursubdomain:abc123xyz"}

Share invite codes

Send the invite code to team members. They run the install + register commands and start deploying.