# BeeOS Project Structure

```text
beeos/
├─ core/          Core OS simulation logic, registries, managers, runtime API
├─ ui/            Tkinter desktop simulator and drawing components
├─ mock/          Mock hardware providers used by the simulator
├─ data/          Local JSON databases and HiveStore indexes
├─ scripts/       Local BeeOS script examples
├─ sideload/      Local package folders for sideload testing
├─ packages/      Installed package folders
├─ storage/       Package-local runtime storage
├─ assets/        Source assets, including curated Lucide icons
└─ generated/     Generated firmware-facing assets
```

## Important tools

```text
tools/create_package_template.py
tools/create_hivestore_repo.py
tools/import_hivestore_repo.py
tools/convert_icons_for_lvgl.py
tools/export_themes_for_lvgl.py
tools/validate_project.py
tools/clean_project.py
```

## Runtime entry point

```text
run_beeos.py
```

Run it with:

```powershell
py run_beeos.py
```