CLI

Command-line interface for Shovel.

Commands

shovel create

shovel create [name]
npm create shovel

Templates

shovel develop

shovel develop <entrypoint> [options]

Options

Examples

shovel develop src/server.ts
shovel develop src/server.ts --port 8080
shovel develop src/server.ts --host 0.0.0.0

shovel build

shovel build <entrypoint> [options]

Options

Examples

shovel build src/server.ts
shovel build src/server.ts --platform cloudflare
shovel build src/server.ts --lifecycle

Output

Node.js / Bun:

dist/
├── server/
│   ├── worker.js
│   ├── server.js
│   └── config.js
└── public/

Cloudflare:

dist/
├── server/
│   └── server.js
└── public/

--lifecycle

Runs ServiceWorker lifecycle events without starting server.

Platform Detection

1. CLI --platform option
2. platform in shovel.json
3. Cloudflare Workers environment
4. Runtime detection (bun or node)

Environment Variables

See Also

• shovel.json - Configuration reference