6.5 KiB
Hardware | Documentation
Skip to contentDocumentationSearch⌘CtrlK Main Navigation PortalThemeMenuReturn to top Sidebar Navigation
Get Started
Overview
Quickstart
Sign inHardwareInstall Node.js & npmInstall Even Hub toolingYour First AppTemplatesArchitecture
Build
Page LifecycleDisplay & UI SystemUI/UX Design GuidelinesDevice APIsContextual MenuNetworkingBackground & Lifecycle
Test
SimulatorLocal TestingPrivate TestingBeta Testing
Ship
Packaging & DeploymentApp Submission & QA Guidelines
Reference
GlossaryCLIVersioning PolicyChangelogFAQ
AI Tooling
Claude CodeOn this pageLast updated: 2026-06-04You can build a lot in the simulator alone, but the rest of the docs assume your glasses are paired and on current firmware. This page gets you there - hardware setup, Developer Mode, and the firewall / Wi-Fi gotchas that QR sideloading runs into.
Set up your Even G2 & R1
If you only have the simulator for now, jump to Your First App and come back once the glasses arrive.
Naming convention
Throughout the docs and the phone app:
- Even G2 - the glasses.
- Even R1 - the optional input ring.Your devices appear under these names in the Bluetooth pairing list.
Exit shipping mode
New glasses arrive in shipping mode - battery isolated so they don't drain in transit. They look dead out of the box. Wake them:
- Drop both arms into the charging case and close it.
- Watch the case light:
- White - charged and ready.
- Orange (≈3 s) - seating feedback when you insert the glasses.
- Open the case. The glasses are now powered and discoverable.
Pairing
- Open the Even Realities App and sign in.
- Go to Devices → Add device and select Even G2.
- Confirm the pairing prompt. The glasses display a brief confirmation.
Firmware update
The app checks for firmware right after pairing. Take the update before doing anything else - most early connection failures trace back to stale firmware.
- The app prompts when an update is available, or check Devices → Firmware manually.
- Keep the glasses in the case and the phone nearby until the flash finishes.
- Don't interrupt it.
Pair the R1 ring (optional)
The R1 adds a touchpad you can use without raising a hand to your temple.
- In the app, go to Devices → Add device → Even R1.
- Follow the same confirm-prompt flow as the glasses.The R1 gesture and event model lives in Device APIs → Inputs.
Enable Developer Mode
There is no toggle. Signing in to the web hub flips your account to developer; the next restart of the phone app surfaces the developer section.
1. Sign in to the web hub
Log in at hub.evenrealities.com/login with the same account you registered in the phone app. See Sign in for the full flow.
2. Restart the Even Realities App
Force-quit the app - swipe it away from recents, not just background - and reopen it.
3. Check the Even Hub tab
A developer section appears in the top-right of the Even Hub tab. That's where the Scan QR button lives, alongside the rest of the dev features Your First App uses.
Known issue: manual Link jump in Dev Preview
In Dev Preview, a manually triggered Link jump may fail - no response, the wrong page, or a bounce to the home screen. The mobile team is on it. Workaround: re-scan the QR instead of relying on in-app Link navigation. This page updates once the fix ships.
Network & Firewall Setup
If QR sideloading already works, skip this section. What follows is for the case where the QR scans but the app never loads.QR sideloading points the phone at a dev server on your laptop (http://192.168.1.100:5173 or similar). For that to work, the phone and laptop have to be on the same network with nothing silently dropping the connection between them - the single most common reason the QR scans and nothing happens.
1. Find your LAN IP
You need your laptop's address on the local network - not localhost.bash
# macOS
ipconfig getifaddr en0 # Wi-Fi; try en1 if blank
# Linux
hostname -I | awk '{print $1}'
# Windows (PowerShell)
ipconfig | findstr /i "IPv4"
Use that address in the QR URL:bash
evenhub qr --url "http://<your-lan-ip>:5173"
2. Allow Node through the firewall
macOS - Application Firewall macOS silently drops the first inbound phone-to-laptop connection. Allow Node explicitly:
- System Settings → Network → Firewall → Options…
- Add your node binary and set it to Allow incoming connections.
- To confirm the firewall is the culprit, toggle it off, retry, then re-enable with the allow rule in place.TIPWith a version manager, the node binary lives under ~/.fnm/... or ~/.nvm/.... Add that path - not a stale /usr/local/bin/node.Windows Defender Defender often blocks node.exe inbound without prompting, especially the shimmed node.exe from fnm/nvm-windows. Add an inbound rule on the dev port:
- Windows Security → Firewall & network protection → Advanced settings.
- Inbound Rules → New Rule → Port → TCP → 5173 (or your dev port) → Allow.
- Apply to the Private profile at minimum.
3. Wi-Fi AP isolation
Corporate Wi-Fi and a lot of home routers ship with AP / client isolation on. It blocks device-to-device traffic even on the same SSID. The symptom: ping and connection silently fail with the firewall already open.Fallbacks, in order of convenience: | | | Fallback | How | | Phone hotspot | Tether the laptop to the phone's hotspot; both are then on the phone's network with no isolation. | | Different network | Use a home/guest network without client isolation. | | Tailscale | Put phone and laptop on the same Tailscale tailnet and use the Tailscale IP in the QR URL.
Quick diagnosis
If the QR scans but the app never loads, work this list top-down. | | | Step | Check | If it fails | | 1 | Open http://:5173 in your phone's browser | Phone can't reach the laptop - go to step 2 | | 2 | Confirm the dev server is actually running (npm run dev shows Local: line) | Restart the dev server, re-generate the QR | | 3 | Confirm the IP in the QR matches the laptop's current LAN IP (Wi-Fi networks reassign on reconnect) | Re-run evenhub qr --url "http://:5173" | | 4 | macOS / Windows firewall allowing Node / port 5173? (see step 2 above) | Add the allow rule, retry step 1 | | 5 | Router has AP / client isolation enabled? (see step 3 above) | Fall back to phone hotspot or Tailscale
Next
Your First App - scaffold, run, and sideload via QR.PagerPrevious pageSign inNext pageInstall Node.js & npm