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

docs/md/app-submission-qa-guidelines.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/app-submission.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/architecture.md

@@ -0,0 +1,45 @@
+Architecture | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to topLast updated: 2026-06-11Even Hub apps are web apps - HTML, CSS, and JavaScript - glued to the glasses by the Even Hub SDK. You build them on your laptop, package them up, and submit them through the dev portal for users to install.
+## Connection model ​
+
+```
+┌──────────────────┐    HTTPS     ┌────────────────────┐   Bluetooth    ┌─────────────────────┐
+│  Even Hub Cloud  │ ◄──────────► │  Phone             │ ◄────────────► │  Even G2 Glasses    │
+│  (distribution   │              │  (Even Realities   │                │  (display + input)  │
+│   & hosting)     │              │   App + WebView)   │                │                     │
+└──────────────────┘              └────────────────────┘                └─────────────────────┘
+```
+
+- The phone runs the Even Realities App (Flutter), which hosts your plugin in a WebView - Chromium on Android, WKWebView on iOS. Your app logic runs inside that WebView. The Even Realities App relays everything to and from the glasses over Bluetooth.
+- The glasses render UI containers and emit input events - presses, scrolls, swipes. Apart from native scroll handling, no app logic runs on them.Network whitelist is not a CORS bypassThe app.json network whitelist is an Even-side permission check - it controls which domains your plugin is allowed to call from the WebView. It does not bypass CORS.In production, fetch() requires both:
+- The remote domain listed in your app.json network whitelist, and
+- Correct CORS headers (Access-Control-Allow-Origin, etc.) returned by that remote API.APIs that work on localhost but fail inside the WebView are almost always CORS misconfigurations on the remote side, not Even bugs. See Networking for the full request flow and debugging tips.
+## Testing your app ​
+Three ways to run your app during development:
+- QR sideload - the CLI prints a QR pointing at your local dev server; scan it from the Even Realities App and your app loads on the glasses with hot reload.
+- Private build - evenhub pack produces an .ehpk; upload it through the dev portal to install on your own devices.
+- Simulator - preview layouts and exercise logic entirely on your laptop, no hardware needed.
+## PWA as an alternative ​
+If you'd rather stay outside the Even Hub distribution flow, build a Progressive Web App and point users at your hosted URL. You keep full control over distribution and hosting; you also skip the dev portal entirely - no packaging, no review.
+## The SDK bridge ​
+The SDK injects a JavaScript bridge (EvenAppBridge) into the WebView. Your frontend calls into it to drive the display and receive input.Web → Glasses: your JS calls bridge.callEvenApp(method, params) → WebView bridge → Even Realities App → Bluetooth → glasses.Glasses → Web: input events travel Bluetooth → Even Realities App → window._listenEvenAppMessage(...) → your callback.For the project layout and a working scaffold, see Your First App § Project structure.

docs/md/background-lifecycle.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/beta-testing.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/build.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/changelog.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/claude-code.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/cli.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/contextual-menu.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/device-apis.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/display-ui-system.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/faq.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/glossary.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/hardware.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/install-even-hub-tooling.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/install-nodejs-npm.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/local-testing.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/networking.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/overview.md

@@ -0,0 +1,38 @@
+Overview | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to topLast updated: 2026-08-07The Even G2 is a pair of smart glasses with a dual micro-LED display - one per lens - a four-mic array, touchpads on both temples, and an optional R1 ring for extra input. It pairs with your phone over Bluetooth LE 5.2. Everything you build runs there; the glasses are the screen.
+## Key hardware specs ​
+SpecValueDisplay576 x 288 px per eyeColor depthMonochrome green, 16 levelsConnectivityBluetooth Low Energy 5.2Audio input4-mic array, single stream, 16 kHz PCMEven G2 touchpadsPress, double press, swipe up, swipe down, tap then long press and releaseR1 touchpadsSame gestures as the Even G2 (optional accessory)Camera / SpeakerNoneNo camera, no speaker on the glasses - the omission is the point. Your code lives on the phone; the glasses render and capture input. (Plugins can still reach the phone camera and album through the SDK when the user grants permission.)
+## What you can build ​
+Today, one surface is live: plugins. They are web apps, written in HTML, CSS, and JavaScript or TypeScript, glued to the glasses by the Even Hub SDK. Bring any stack - Vite, React, plain JS - the SDK takes it from there.Three more surfaces are coming: dashboard widgets, dashboard layouts, and AI skills.
+## What development looks like ​
+
+```
+1. Write code         Standard web app (Vite + SDK)
+2. Preview locally    evenhub-simulator http://localhost:5173
+3. Test on device     QR sideload, or private build in the dev portal
+4. Package            evenhub pack app.json dist -o myapp.ehpk
+5. Submit             Upload the .ehpk through the dev portal
+```
+
+## Quick reference ​
+ResourceLinkSDKnpm: @evenrealities/even_hub_sdkSimulatornpm: @evenrealities/evenhub-simulatorCLInpm: @evenrealities/evenhub-cliDesign GuidelinesFigma: Software Design GuidelinesCommunity notesGitHub: even-g2-notesCommunity toolkitGitHub: even-toolkitCommunity IDEGitHub: ER Studio - editor, simulator mirror, and one-click pack in one window (macOS Apple Silicon)Discorddiscord.gg/Y4jHMCU4sv

docs/md/packaging-deployment.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/page-lifecycle.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/private-testing.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/quickstart.md

@@ -0,0 +1,51 @@
+Quickstart | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to topLast updated: 2026-06-04The one-page path from zero to a running app. Read it top to bottom the first time; come back to it as a checklist after that.By the end you'll have an Even Realities account, a paired and updated pair of Even G2s, Developer Mode on, Node installed, and Hello from G2! rendering on the glasses via QR sideload.
+## 1. Install the Even Realities App and register ​
+On your phone, type this URL into your browser to download the app:
+```
+evenapp.evenrealities.com
+```
+Install the app, then register your Even Realities account inside it. The account you create here is the same one you'll use everywhere else (web hub, Developer Mode).
+## 2. Log in to the web hub ​
+Open hub.evenrealities.com/login and sign in with the same account.→ Detail: Sign in
+## 3. Wake the glasses out of shipping mode ​
+New Even G2s arrive in shipping mode so the battery doesn't drain in transit. To wake them, drop both arms into the charging case with the case plugged in. The case light comes on; the glasses are ready to pair.→ Detail: Set up your Even G2 & R1
+## 4. Pair over Bluetooth and update firmware ​
+Open the Even Realities App and walk through the in-app pairing tutorial. The app then offers a firmware update - take it before doing anything else. Most "it won't connect" reports trace back to stale firmware.→ Detail: Set up your Even G2 & R1
+## 5. Enable Developer Mode ​
+Developer Mode is what unlocks QR sideload and local testing.
+- Sign in to hub.evenrealities.com/login with the same account as the phone app.
+- Force-quit and reopen the Even Realities App.
+- The Even Hub tab now shows a developer section in the top right.→ Detail: Enable Developer Mode
+## 6. Install Node.js & npm ​
+You need Node 20 LTS or 22+. Coming from outside the JS world? The detail page walks through nvm, fnm, Homebrew, winget, and the PATH gotchas you'll otherwise hit.→ Detail: Install Node.js & npm
+## 7. Install Even Hub tooling ​
+bash
+```
+npm install -g @evenrealities/evenhub-cli @evenrealities/evenhub-simulator
+```
+→ Detail: Installation
+## 8. Run "Hello from G2!" ​
+Scaffold the minimal app, start the dev server, and sideload it via QR. If the phone scans the QR but the app never loads, it's almost always a firewall or Wi-Fi AP-isolation issue.Your First App shows both routes: the hand-built Vite route installs the SDK after creating the project directory, while the template route already includes the SDK and only needs npm install for the template dependencies.In a hurry? Templates lists ready-to-run starters from the official evenhub-templates repo.→ Detail: Your First App · Network & Firewall Setup
+## If you get stuck ​
+SymptomMost likely causeWhere to lookNo way to find the Scan QR entry in the appDeveloper Mode not enabled, or app not restarted after web loginEnable Developer ModeQR scans but app never loadsFirewall / AP isolation blocks phone-to-laptopNetwork & Firewall Setupnode / npm "command not found"PATH not set after installInstall Node.js & npmGlasses won't connect at allStill in shipment mode, or stale firmwareSet up your Even G2 & R1

docs/md/simulator.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/templates.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/ui-ux-design-guidelines.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/versioning-policy.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…

docs/md/your-first-app.md

@@ -0,0 +1,23 @@
+Even Realities Developer Docs | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlKThemeMenuReturn to top Redirecting to Get Started…