third-party-store-guide.md

Third-party Store Guide

This page is kept as a compact compatibility entry for older links. The documentation now uses five clearer sections.

Choose your path

• New store: Create a Store
• Existing v1 store: Migrate from v1
• File and field reference: Protocol Reference
• Build and publish automation: CI/CD Overview
• Short answers: FAQ

Core v2 flow

1. Write source files such as store-config.json, supported-languages.json, and Apps/*/docker-compose.yml.
2. Run the public build action or ./scripts/build_dist.sh.
3. Publish the generated dist/ directory.
4. Let clients consume store.json, index.json, built compose files, metadata files, and assets.

Minimal source structure

my-appstore/
├── Apps/
│   └── MyApp/
│       ├── docker-compose.yml
│       └── icon.svg
├── store-config.json
└── supported-languages.json

For local builds, optionally add scripts/build_dist.sh.

Key references

• Repository Structure
• Store Config
• Compose and x-casaos
• Build Output
• Assets and Localization
• Official Actions Reuse