Even G2 dev workspace: docs snapshot (28 pages), README, toolchain notes

This commit is contained in:
drjones
2026-09-02 19:33:07 -07:00
commit a51178e83e
89 changed files with 4828 additions and 0 deletions

35
README.md Normal file
View File

@@ -0,0 +1,35 @@
# Even Realities G2 — App Lab
Dev workspace for Even G2 smart glasses apps. Naming theme: constellations/stars.
## Toolchain (all installed globally)
| Tool | Command | Version |
|---|---|---|
| Even Hub CLI | `evenhub` / `eh` | 0.1.13 |
| Simulator | `evenhub-simulator` | 0.8.0 |
| SDK (per-app dep) | `@evenrealities/even_hub_sdk` | 0.0.14 |
| Node | v26.8.1 | — |
## Layout
- `apps/` — one folder per app (web apps: Vite + TypeScript + SDK)
- `docs/` — full Even Realities developer docs snapshot
- `docs/pages/` — per-page markdown
- `docs/site-data.json` / `docs/links.txt` — doc index
## Quick loop
```bash
cd apps/<name>
npm run dev # Vite on :5173
evenhub-simulator http://localhost:5173/ --automation-port 9898
curl http://127.0.0.1:9898/api/ping # -> pong
curl -X POST http://127.0.0.1:9898/api/input -H 'Content-Type: application/json' -d '{"action":"click"}'
curl -s http://127.0.0.1:9898/api/screenshot/glasses -o frame.png
```
## Critical platform notes
- Simulator sends clicks as `sysEvent`, hardware as `textEvent` — handlers must accept BOTH.
- `min_sdk_version` in app.json must match the installed SDK version.
- HMR reloads break the bridge — restart simulator after code changes.
- `waitForEvenAppBridge()` before any SDK call.
- Network whitelist ≠ CORS bypass — remote API needs real CORS headers too.
- Full reference: docs/pages/