umbrel-apps  by getumbrel

App store packaging for self-hosted OS

Created 4 years ago
748 stars

Top 45.6% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

This repository serves as the official package registry for the Umbrel App Store, enabling developers to submit and manage applications for the umbrelOS platform. It provides a structured way to integrate third-party software, offering users a curated selection of self-hostable applications accessible via a web interface without requiring command-line interaction.

How It Works

The core of the project involves standardized app packages, each residing in a top-level directory. Packaging rules, updates, and verification are managed by skills located in .claude/skills/, as detailed in AGENTS.md. This system ensures apps adhere to the "App Store Standard," prioritizing browser-based UIs, sensible defaults, predictable updates, and secure user data handling, making them seamlessly usable on umbrelOS.

Quick Start & Requirements

This repository is for app developers and maintainers. To contribute or update app packages, developers must consult AGENTS.md for detailed packaging rules and verification steps. The target platform is umbrelOS. Further details on the app store can be found at https://apps.umbrel.com.

Highlighted Details

  • Developers can utilize generated Umbrel App Store badges (both dark and light variants) for their own project documentation or websites, linking back to their published apps.

Maintenance & Community

Contribution guidelines and packaging standards are detailed in AGENTS.md, which directs developers to repo-local skills for managing app packaging, updates, and testing. Specific community channels or contributor information are not detailed in this README.

Licensing & Compatibility

The README does not specify a license for the repository or the app packages it contains. Compatibility is primarily with the umbrelOS platform.

Limitations & Caveats

This repository exclusively manages app packages for the Umbrel App Store; it does not host the applications themselves. The README implies strict adherence to the "App Store Standard" for usability and integration, which may present a barrier for apps not designed with a web UI-first approach.

Health Check
Last Commit

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
101
Issues (30d)
16
Star History
9 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.