Concepts

Apps And Releases

How Userland app identity, immutable releases, activation, and rollback work.

For agents: Treat app_id as stable identity and release ids as immutable deployment snapshots. Rollback moves the live pointer only.

Model

Publishing creates an app or release. The runtime origin is always https://<app_id>.apps.userland.fun/.

App names and summaries are mutable metadata. They are not routing identity.

Activation

Activation can be live, pending_secrets, or requires_migration. Non-live releases are stored but do not replace the live pointer.