@theda/cli

Theda development CLI — local dev server with hot-reload, manifest validation, and build tooling.

Install

npm install -D @theda/cli

Commands

theda dev              # Start the local dev server + Studio dashboard
theda build            # Bundle and validate, output build artifacts
theda check            # Validate your app manifest (like tsc --noEmit)
theda init             # Initialize Theda in an existing project
theda export-manifest  # Output the app manifest as JSON

theda dev

Starts a local development server with hot-reload:

npx theda dev --port 4321

• Bundles your theda.config.ts or src/app.ts
• Serves your routes at http://localhost:4321
• Opens Studio dashboard at http://localhost:4321/_studio
• Watches for file changes and hot-reloads
• Validates your manifest on every save

theda build

Produces deployment artifacts:

npx theda build --output .theda/build

Outputs manifest.json and handler.mjs to the output directory.

theda check

Fast manifest validation without building:

npx theda check

Options

All commands support --app <path> to specify the app file explicitly.

License

Apache-2.0