Skip to main content
Skybridge ships one CLI, available as both skybridge and sb once it’s installed in your project. It’s a project dependency, not a global install, so run it through your package manager, or the package scripts a scaffold sets up.

​
create

Scaffold a new project. Run it before the package is installed with npx: 
npx skybridge create
See Quickstart to scaffold and run a project.

​
dev

Start the development server with hot module reloading and DevTools. 
npx skybridge dev
  • Serves the MCP endpoint at http://localhost:3000/mcp
  • Opens DevTools for local testing at http://localhost:3000/
  • Watches files and restarts the server, with HMR for views
FlagDescription
-p, --port <number>Port to run on. Defaults to 3000, or the next free port if it’s taken.
--tunnelOpen an Alpic tunnel for remote testing and Playground access.
--no-openDon’t open DevTools when the server is ready.
-v, --verboseShow tunnel logs.
The scaffolded package.json adds a dev:tunnel script, shorthand for skybridge dev --tunnel. The port also reads from the PORT environment variable. Set SKYBRIDGE_OPEN=false in your shell profile to skip opening DevTools on every run, the equivalent of always passing --no-open.

​
build

Compile your views and MCP server for production. 
npx skybridge build
The output lands in dist/, ready for the deploy script or skybridge start.

​
start

Run the production server from the build output. Run skybridge build first. 
npx skybridge start
  • Serves the MCP endpoint at http://localhost:3000/mcp
  • Runs the compiled server and pre-built view assets from dist/
FlagDescription
-p, --port <number>Port to run on. Defaults to 3000, or the next free port if it’s taken. Also reads PORT.

​
telemetry

The CLI reports anonymous usage, on by default. Toggle it with skybridge telemetry disable, enable, or status. See Telemetry for what’s collected and every way to opt out.

​
Package scripts

A scaffolded project wires the commands into package.json:
ScriptCommandDescription
devskybridge devStart the development server.
dev:tunnelskybridge dev --tunnelStart the dev server behind an Alpic tunnel.
buildskybridge buildBuild for production.
startskybridge startServe the production build.
deployalpic deployDeploy through the Alpic CLI. See Deploy for per-platform setup.
Run them with your package manager: 
npm run dev
npm run build
npm start

Quickstart

Scaffold and run your first app

Ship

Deploy to your platform of choice

McpServer

The server the CLI builds and runs