Start

Start

The shortest path for a coding agent to build and publish a Userland app.

For agents: Read llms.txt, create manifest.userland.json, add public/ files, add server/index.js only when dynamic routes are needed, then publish with a server-side CLI or API call using USERLAND_API_KEY.

Goal

Build a valid Userland app bundle and publish it to an immutable app origin.

Inputs

App idea and expected user workflow.
USERLAND_API_KEY in the local environment.
Optional examples from the public examples repo.

Outputs

manifest.userland.json.
Static files under public/.
Optional server module at server/index.js.
Published app_id, origin, release_id, and activation status.

Commands

npm run userland -- apps publish .

Generated artifacts

/llms.txt for compact agent context.
/openapi.json for the control-plane API.
/schemas/resource-manifest-v0.schema.json for manifest.userland.json.
/types/runtime-context-v0.d.ts for server runtime code.

Do not put API keys, app secrets, or platform internals into app frontend code.