Quickstart

1. Install

curl -fsSL https://assets.cluster.app/serve/cstatic-assets/releases/ccp/install.sh | sh

See Installation for other install methods and shell completions.

2. Log In

ccp auth login

On a desktop, this opens your browser to approve the login. Over SSH or on a headless host it automatically prints a device code to approve instead — see Authentication for details and the --browser / --device overrides.

3. Create a project directory

ccp init my-app
cd my-app

This scaffolds a TypeScript project directory with a handler template. When prompted, select an organization and create an App to link it (not a platform Project — that's the organization-level container your App lands in).

4. Start Dev Server

ccp dev
# ◼ Dev Server started!
# › http://0.0.0.0:8000

Open http://localhost:8000 — you'll see "Hello from Clusterbase!". Edit index.ts and the server hot-reloads automatically.

5. Deploy

ccp deploy --prod

Your function is live at https://my-app.clusterbase.dev.

What Just Happened?

1. ccp deploy bundled your TypeScript
2. Uploaded the bundle to Clusterbase's storage
3. Activated a deployment on the serverless runtime
4. The runtime created a V8 isolate for your function
5. my-app.clusterbase.dev was routed to your isolate

Next Steps

• Edit your handler — learn about the Request/Response model
• Add a custom domain — serve from your own domain
• Serve static files — deploy an SPA with --public-dir
• Explore the runtime — see all available Web APIs