umbrel-apps

Use when designing or building an upstream self-hosted app intended to run well on umbrelOS before packaging. Covers one-click browser setup, Docker readiness, persistence, app-owned migrations, and avoiding env-var/log/SSH setup flows.

Use when packaging a new app for the Umbrel App Store, including upstream discovery, manifest and compose authoring, Umbrel runtime rules, persistence, and readiness for testing.

Use when testing or verifying an Umbrel App Store package, including linting, Umbrel device or local umbrelOS test environments, fresh install and update-path testing, browser verification, logs, persistence, dependencies, and PR evidence.

Use when updating an existing Umbrel App Store package, including upstream version bumps, package fixes, metadata-only App Store changes, manifest version and release notes, image verification, update-path safety, linting, Umbrel testing, and PR readiness.