# 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

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

## Import a local repo index

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

## Import a GitHub-hosted repo

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

## Repo format

```json
{
  "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.