Documentation

Last updated: 2026-04-22

This page walks you through the tooling you need on your machine — the Even Hub SDK, simulator, and CLI — plus the hardware (or simulator) you will use to exercise Even G2 apps end to end.

Prerequisites ​

  • Node.js — v20 LTS or v22+ (the SDK declares engines.node = "^20.0.0 || >=22.0.0"; Node 18 is not supported)
  • A web framework of your choice (Vite recommended)
  • A phone with the Even Realities App installed (for hardware testing)
  • Even G2 glasses (for hardware testing; the simulator covers early development)
  • Even R1 ring (optional — provides additional touchpad input)

Install the SDK ​

bash
npm install @evenrealities/even_hub_sdk

Current version: 0.0.10 (published 2026-04-10). The SDK provides typed methods for display control, input handling, audio, device info, and local storage. Update your app.json min_sdk_version examples to "0.0.10" accordingly.

npm: @evenrealities/even_hub_sdk

Install the Simulator ​

The simulator lets you preview UI layouts and test logic without physical hardware. It is a supplement to — not a replacement for — hardware testing.

bash
npm install -g @evenrealities/evenhub-simulator

Current version: 0.7.2 (published 2026-04-15). Cross-platform (macOS, Linux, Windows).

npm: @evenrealities/evenhub-simulator

See the full Simulator Reference for options and caveats.

Install the CLI ​

The CLI handles authentication, QR sideloading, and app packaging. The package ships an evenhub binary (and a shorter eh alias), so global installation is recommended:

bash
npm install -g @evenrealities/evenhub-cli

Alternative — pin the version per-repo:

bash
npm install -D @evenrealities/evenhub-cli

Current version: 0.1.12 (published 2026-04-16).

npm: @evenrealities/evenhub-cli

See the full CLI Reference for all commands, and Packaging & Deployment for the complete app.json schema and troubleshooting guide.