3.2 KiB
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