Last updated: 2026-07-04
With Node in place, install the two global tools used before you create your first app:
bash
npm install -g @evenrealities/evenhub-cli @evenrealities/evenhub-simulatorThe SDK is different: it is a project dependency, not a global tool. Install it only after you have an app project with a package.json.
Simulator
Installed by the global tooling command above.
Current version: 0.8.0. Runs on macOS, Linux, and Windows. 0.8.0 tracks SDK 0.0.12 for zOrderIndex stacking. Usage and caveats are in Simulator.
CLI
Installed by the global tooling command above. The CLI handles QR sideloading, manifest scaffolding, and .ehpk packaging. It ships an evenhub binary and a shorter eh alias.
Current version: 0.1.12.
Full command list in the CLI Reference; the manifest schema and packaging walkthrough is in Packaging & Deployment.
SDK
The SDK is a project dependency - your app imports from it, so it lives in your app's node_modules, not on the system. No -g.
Route A in Your First App creates a Vite project first, then runs this command from inside that project directory (the one with package.json):
bash
npm install @evenrealities/even_hub_sdk@latestRoute B uses the official templates, which already include the SDK. For templates, run npm install for the template dependencies; do not install the SDK separately.
Current version: 0.0.12, published 2026-07-04. It adds zOrderIndex container stacking and LZ4-compressed image updates on top of display control, input, audio (glasses or phone mic), IMU, location, photo album / phone camera, device info, and local storage. Whatever version you install, match it in app.json's min_sdk_version.