even-g2/README.md

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

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/