The official scaffolding CLI for building apps on top of Chass. Sets up a ready-to-run project with the Chass SDK.

Quick start

npx create-chass-app@latest my-chass-app
cd my-chass-app
yarn chass dev

The scaffolder will:

1. Create a new project with TypeScript, linting, tests, and a preconfigured chass CLI
2. Start a local Chass server via Docker (pulls the latest image automatically)
3. Authenticate with the development API key

Options

| Flag | Description | | ---------------------------------- | --------------------------------------------------------------------- | | --name <name> | Set the app name | | --display-name <displayName> | Set the display name | | --description <description> | Set the description | | --url <url> | Chass workspace URL (default: http://localhost:2020) | | --authentication-method <method> | oauth or apiKey (default: apiKey for local, oauth for remote) |

Documentation

Full documentation is available at docs.chass.app/developers/extend/apps:

• Quick Start — scaffold, run a local server, sync your code
• Concepts — how apps work: entity model, sandboxing, lifecycle
• Operations — CLI, testing, CI, deploy and publish

Troubleshooting

• Server not starting: check Docker is running (docker info), then try yarn chass docker:logs.
• Auth not working: run yarn chass remote:add to re-authenticate.
• Types not generated: ensure yarn chass dev is running — it auto-generates the typed client.