# 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.