Theme
Last updated: 2026-08-25
A feature rarely lands in one package. The SDK exposes the API, the simulator learns to render it, the CLI adjusts what it stamps at pack time, and the Even Realities App has to be new enough to carry it. This page groups releases by the area they moved, so one rollout reads as one entry instead of a version number per package.
Dates are npm publish dates - the day a version became installable. The raw per-package lists live in each package README on npm: SDK, CLI, simulator.
Current versions
| Package | Version | Shipped |
|---|---|---|
SDK @evenrealities/even_hub_sdk | 0.0.14 | 2026-08-20 |
CLI @evenrealities/evenhub-cli | 0.1.14 | 2026-08-20 |
Simulator @evenrealities/evenhub-simulator | 0.9.3 | 2026-08-22 |
Install commands are in Install Even Hub tooling; what to pin and when to bump is in Versioning Policy.
Release map
| Area | Latest move | Packages |
|---|---|---|
| Contextual menu and tap then long press | 2026-08 | SDK 0.0.14, simulator 0.9.0-0.9.1, CLI 0.1.14 |
| Display and images | 2026-08 | SDK 0.0.12 and 0.0.14, simulator 0.8.0 and 0.9.0-0.9.3 |
| Phone and sensor access | 2026-08 | SDK 0.0.11 and 0.0.14 |
| Version floors and packaging | 2026-08 | SDK 0.0.13, CLI 0.1.14 |
| Simulator automation | 2026-04 | Simulator 0.7.0-0.7.3, CLI 0.1.12-0.1.13 |
| Earlier releases | 2026-04 | SDK 0.0.1-0.0.10, CLI 0.1.5-0.1.11, simulator 0.1.0-0.6.2 |
Contextual menu and tap then long press
The overlay the glasses OS raises on tap then long press, plus the gesture itself reaching your app as a pair of events. Guides: Contextual Menu and Device APIs.
| Package | Version | What landed | Shipped |
|---|---|---|---|
| Simulator | 0.9.1 | long_press and long_press_release on the automation API, so both the gesture and the menu are scriptable in CI | 2026-08-21 |
| SDK | 0.0.14 | menuObject on createStartUpPageContainer and rebuildPageContainer - up to 10 action items, with menuItemClickEvent delivered through onEvenHubEvent and SDK-side validation of item count, ID uniqueness, and UTF-8 name length. LONG_PRESS_EVENT (9) and LONG_PRESS_RELEASE_EVENT (10) parsing on list, text, and system events | 2026-08-20 |
| Simulator | 0.9.0 | Draws and navigates your menu; simulates the gesture in the window with holdable controls and a keyboard shortcut; context_menu action on the automation API | 2026-08-20 |
| CLI | 0.1.14 | Stamps the Even App 2.2.9 floor at pack time | 2026-08-20 |
Needs Even App 2.2.9. On an older app your items silently never appear, so the CLI stamps the floor and the plugin is blocked at open. See the open-time gate.
Display and images
Text brightness, container stacking, and the image transfer path. Guide: Display & UI System.
| Package | Version | What landed | Shipped |
|---|---|---|---|
| Simulator | 0.9.3 | Grayscale conversion for encoded images matches the glasses; cover resizing and center cropping match when image and container dimensions differ | 2026-08-22 |
| Simulator | 0.9.2 | Accepts SDK raw Gray8 and packed Gray4 image data alongside encoded images | 2026-08-22 |
| SDK | 0.0.14 | textColor on text containers and on textContainerUpgrade - five brightness levels, 0 to 4. updateImageRawData holds the image path for 100ms and flushes a held call on the next one | 2026-08-20 |
| Simulator | 0.9.0 | Renders the five textColor levels | 2026-08-20 |
| SDK | 0.0.12 | zOrderIndex on list, text, and image containers - larger renders in front, all-or-nothing per page, values unique. updateImageRawData payloads are LZ4-compressed in transit, with no code change | 2026-07-10 |
| Simulator | 0.8.0 | Sorts draw order by zOrderIndex with the same all-or-nothing and uniqueness rules the SDK enforces; caps decoded image pixel dimensions | 2026-07-08 |
Two things the simulator will not settle for you:
- It does not decompress LZ4 - it decodes payload bytes as an ordinary uncompressed image. Validate the compressed transfer path on hardware.
- Its brightness levels are not photometrically matched to the glasses. Use them to check hierarchy; sign off on legibility on hardware.
Phone and sensor access
What a plugin can reach beyond the display. Guide: Device APIs.
| Package | Version | What landed | Shipped |
|---|---|---|---|
| SDK | 0.0.14 | direction and speakerRole on AudioEvent - direction is the raw glasses direction tag for that PCM frame, speakerRole is an AudioSpeakerRole of self, other, or unknown | 2026-08-20 |
| SDK | 0.0.11 | One-shot location and continuous location updates; phone album image picker, single-select; phone camera capture; mic source selection between glasses and phone | 2026-06-22 |
speakerRole comes from an app-side algorithm and carries no firmware identity guarantee. Phone-mic capture and older host apps fall back to direction: null and speakerRole: unknown, so code written before 0.0.14 keeps working unchanged.
Version floors and packaging
You stop hand-writing the phone-app floor; the CLI derives it from your SDK version. Guide: Auto-deriving min_app_version.
| Package | Version | What landed | Shipped |
|---|---|---|---|
| CLI | 0.1.14 | Derives and stamps min_app_version at pack time; adds --sdk-ver and --enforce-manual-version; adds shell completion for evenhub and eh; returns a failing exit status when packing fails | 2026-08-20 |
| SDK | 0.0.13 | First release to publish its floor as minAppVersion in npm metadata - 2.2.6 | 2026-07-31 |
SDK 0.0.12 and older predate the minAppVersion field. npm versions are immutable, so those floors cannot be backfilled - the CLI falls back to a bundled map and prints an info line.
Simulator automation
The simulator gained an HTTP control surface, which is what makes CI runs and agent-driven testing possible. Guide: Headless automation.
| Package | Version | What landed | Shipped |
|---|---|---|---|
| CLI | 0.1.13 | TERM / COLORTERM detection when printing a QR code in the terminal | 2026-04-20 |
| Simulator | 0.7.3 | Native webview capture on each desktop platform, fixing blank /api/screenshot/webview results; list items capped at 63 bytes and 20 items | 2026-04-20 |
| CLI | 0.1.12 | qrcode-terminal for terminal QR codes, qr-image for external ones; login command fix | 2026-04-16 |
| Simulator | 0.7.2 | Emoji rendering coverage; steadier bounce and spring animations | 2026-04-15 |
| Simulator | 0.7.1 | Firmware-matching fixes - no scrollbar past full screen, capped single-container width and height, 999-byte text container limit | 2026-04-09 |
| Simulator | 0.7.0 | --automation-port <PORT> starts an HTTP server for screenshots, console logs, and glasses input. Default border_color becomes 0 (invisible) to match the glasses. Unknown-glyph handling matches firmware | Not on npm |
0.7.0 has upstream notes but no npm release. The first installable build carrying the automation API is 0.7.1, published 2026-04-09.
Earlier releases
Notes below are the upstream package entries, unedited in substance. Coverage is partial in both directions: SDK 0.0.2 through 0.0.7 and simulator 0.1.1, 0.1.2, 0.4.0, and 0.6.0 shipped without upstream notes, while simulator 0.2.0, 0.2.2, and 0.5.1 have notes but were never published to npm. Rows marked Not on npm were never installable.
SDK 0.0.1 - 0.0.10
| Version | What landed | Shipped |
|---|---|---|
0.0.10 | Stronger WebView background keep-alive | 2026-04-10 |
0.0.9 | EventSourceType compatibility, a default source enum fallback, refined event source parsing | 2026-03-25 |
0.0.8 | Launch source events appMenu and glassesMenu; startup containers raised from 4 to 12; IMU control and IMU data events | 2026-03-25 |
0.0.2 - 0.0.7 | No upstream notes | 2026-01-22 to 2026-02-11 |
0.0.1 | Initial bridge, storage, device info, EvenHub protocol, and event APIs | 2026-01-22 |
CLI 0.1.5 - 0.1.11
| Version | What landed | Shipped |
|---|---|---|
0.1.11 | Windows packing fix | 2026-03-25 |
0.1.10 | app.json restriction adjustments | 2026-03-24 |
0.1.9 | app.json size limit adjustments | 2026-03-21 |
0.1.8 | app.json format adjustments | 2026-03-19 |
0.1.7 | -d option fix on init | 2026-03-13 |
0.1.6 | app.json format adjustments | 2026-03-12 |
0.1.5 | First published release, no upstream notes | 2026-01-28 |
Simulator 0.1.0 - 0.6.2
| Version | What landed | Shipped |
|---|---|---|
0.6.2 | Container limits brought closer to firmware | 2026-03-25 |
0.6.1 | Tracks SDK 0.0.8 - borderRadius typo fixed and unknown property fields now error; Sys_ItemEvent gains fields, with eventSource hardcoded to 1 (TOUCH_EVENT_FROM_GLASSES_R), imuData always null, and systemExitReasonCode ignored | 2026-03-25 |
0.6.0 | No upstream notes | 2026-03-25 |
0.5.3 | Logs the original JSON to stdout on payload parse errors under RUST_LOG=debug; x_position / y_position become i32 | 2026-03-03 |
0.5.2 | 4-bit color rendering; brightness filter removed from the glasses canvas | 2026-02-28 |
0.5.1 | Rendering mechanism adjustments; better image rendering | Not on npm |
0.5.0 | Screenshots | 2026-02-27 |
0.4.1 | Performance work; a flag to print the default config file location; completion command fix | 2026-02-20 |
0.4.0 | No upstream notes | 2026-02-20 |
0.3.2 | Config file location description fix | 2026-02-19 |
0.3.1 | Audio input device listing format | 2026-02-17 |
0.3.0 | Shell completion | 2026-02-17 |
0.2.2 | Audio resampling and input device selection; config file support; more flags to override config options | Not on npm |
0.2.0 | lvgl-sys upgraded to v9; lighter CJK font; preliminary audio event support | Not on npm |
0.1.2 | No upstream notes | 2026-02-13 |
0.1.1 | No upstream notes | 2026-02-13 |
0.1.0 | First published release, no upstream notes | 2026-02-13 |
Related
- Versioning Policy - semver contract, deprecation windows, pinning, and the
min_app_versiongate - Install Even Hub tooling - install commands and the current version of each package
- Packaging & Deployment - what the CLI stamps into your
.ehpk