beeos/docs/PROJECT_STRUCTURE.md

BeeOS Project Structure

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

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

run_beeos.py

Run it with:

py run_beeos.py