Initial BeeOS simulator and asset pipeline

2026-08-25 20:29:05 +00:00
commit 7d4d683a8f
265 changed files with 16676 additions and 0 deletions
@@ -0,0 +1,124 @@
+# BeeOS
+
+BeeOS is a MicroPython-first smartwatch OS concept and desktop simulator for the PineTime Pro direction.
+
+The current project is a Windows-friendly Tkinter simulator plus project framework. It does **not** require LVGL or MicroPython on Windows yet.
+
+## Current capabilities
+
+- BeeOS watch face and 2x2 app launcher
+- Notifications shade
+- Built-in apps: Clock, Health, HiveStore, Settings, Scripts, Resource Monitor, GPS, Battery, About, Developer Tools
+- Runtime API for installed apps/scripts
+- Live app sessions with touch events
+- Permission approval prompts
+- HiveStore package install/remove/update simulation
+- Multi-repo HiveStore support
+- GitHub-compatible HiveStore repo imports
+- Curated Lucide icon asset subset
+- PNG icon renders for the desktop simulator
+- LVGL v8/v9 icon descriptor export
+- Theme registry and C/JSON theme export
+
+## Run the simulator
+
+```powershell
+py run_beeos.py
+```
+
+or:
+
+```powershell
+python run_beeos.py
+```
+
+## Useful tools
+
+Validate the project:
+
+```powershell
+py tools/validate_project.py --project-root .
+```
+
+Clean Python cache files:
+
+```powershell
+py tools/clean_project.py --project-root .
+```
+
+Create a package template:
+
+```powershell
+py tools/create_package_template.py app local.test.app "Test App"
+```
+
+Create a starter HiveStore repo:
+
+```powershell
+py tools/create_hivestore_repo.py .\my-hivestore "My HiveStore Repo"
+```
+
+Import a HiveStore repo:
+
+```powershell
+py tools/import_hivestore_repo.py .\my-hivestore\hivestore_index.json --project-root .
+```
+
+Rebuild icon assets:
+
+```powershell
+py tools/convert_icons_for_lvgl.py --project-root . --sizes 24,34
+```
+
+Rebuild theme assets:
+
+```powershell
+py tools/export_themes_for_lvgl.py --project-root .
+```
+
+## Documentation
+
+```text
+docs/PROJECT_STRUCTURE.md
+docs/DEVELOPMENT.md
+docs/HIVESTORE_REPOS.md
+docs/history/
+```
+
+## Important note
+
+This is not firmware yet. It is the simulator, package model, runtime API shape, HiveStore model, and asset pipeline that can later be ported toward MicroPython/LVGL on the actual watch.
+
+
+## Dev Tools cleanup build
+
+Developer Tools now uses a 2x2 paged tool hub instead of a long crowded list. Use mouse wheel or swipe-style page controls to move between tool pages.
+
+
+## Dev Tools v2 dashboard fix
+
+The previous Dev Tools cleanup package accidentally still shipped the old long-row list. This build replaces it with a visibly different **Dev Hub** dashboard:
+
+- Header summary card
+- 2x2 dashboard tiles
+- Prev/Next page controls
+- Page dots
+- Mouse wheel page switching
+
+
+## Scripts scrolling update
+
+The Scripts app is now scrollable. It shows four scripts at a time and supports:
+
+- Mouse wheel scrolling
+- Up/Down keyboard scrolling
+- Scroll position indicator
+- Runtime launch from the currently visible rows
+
+Additional sample scripts were added so scrolling is visible immediately.
+
+
+## Scripts scroll crash fix
+
+Fixed missing `self.scripts_scroll_index` initialization in `BeeOSSimulator.__init__`.
+The Scripts screen also now has a defensive fallback so it cannot crash if the field is missing.