beeos/docs/HIVESTORE_REPOS.md

HiveStore Repos

BeeOS supports multiple curated HiveStore repositories.

A HiveStore repo can be hosted on GitHub by committing a hivestore_index.json file.

Create a starter repo

py tools/create_hivestore_repo.py .\my-hivestore "My HiveStore Repo"

Import a local repo index

py tools/import_hivestore_repo.py .\my-hivestore\hivestore_index.json --project-root .

Import a GitHub-hosted repo

py tools/import_hivestore_repo.py https://github.com/example/my-hivestore --project-root .

Repo format

{
  "schema": 1,
  "source_name": "My HiveStore Repo",
  "source_url": "https://github.com/example/my-hivestore",
  "packages": [
    {
      "id": "example.app.hello",
      "name": "Hello Bee",
      "type": "app",
      "version": "0.1.0",
      "author": "Example Developer",
      "description": "A simple BeeOS app.",
      "entry": "app.py",
      "permissions": ["display", "storage"],
      "repository": "https://github.com/example/hello-bee",
      "curated": true
    }
  ]
}

If duplicate package IDs appear across enabled repos, the first enabled source wins.