ZimaOS App Store Developer DocsBuild a compatible app store from scratch

Start here if you are creating a new store.

Start from scratch

Create the minimum source repository, add store identity, add app compose files, build dist, and publish static files.

Create a store

Find the required files, x-casaos fields, output files, assets, locale behavior, and field meanings.

Browse specs

Understand validation, release artifacts, gh-pages publishing, and how to reuse the official build action.

Set up CI/CD

Get short answers for ID conflicts, hosting, base URLs, build requirements, and minimum store structure.

Read FAQ

Discover community third-party store sources and copy the one you want to import into ZimaOS.

Browse awesome stores

If you already have a v1 store, follow the migration guide to add v2 support while preserving compatibility.

Open migration guide