EvenHub Simulator

A development tool for rapid iteration and early-stage debugging of evenhub applications. This simulator allows developers to preview UI layouts and logic before running on physical hardware.

Installation

npm install -g @evenrealities/evenhub-simulator

Usage

EvenHub glasses app simulator

Usage: evenhub-simulator [OPTIONS] [targetUrl]

Arguments:
  [targetUrl]  The URL to load on startup

Options:
  -g, --glow...         Enable glow effect on glasses display
      --anim-spring...  Use spring bounce animation instead of default
  -h, --help            Print help (see more with '--help')
  -V, --version         Print version

Options

| Option | Description | |--------|-------------| | -g, --glow | Adds a glow effect to the display. Disabled by default as it can appear overly bold. | | --anim-spring | Replaces bounce animations with spring-style motion. Simulator-only feature. |

Caveats

Display & UI Rendering

The firmware runs LVGL v9, while the simulator uses v8 (via lvgl-sys in Rust).

Due to library differences and other implementation differences, the overall display characteristics, like font rendering, may not perfectly mirror the hardware. However, the current fidelity is sufficient for layout validation and logic testing.

List Behavior

List scrolling mechanics, specifically the screen positioning of focused items, vary across environments. This is because the simulator re-implements drawing logic rather than sharing the embedded source code directly.

Error Handling

Under normal conditions, the simulator behaves nearly identically to the hardware. Error response handling (e.g., invalid inputs) may diverge but will converge as the codebase matures.

Image Processing

The simulator processes images faster and currently does not impose constraints on image size or similar limitations. Future versions may introduce stricter checks to simulate hardware behavior.

Audio & Events

• Audio: Not currently supported. Planned for a future release.
• Status Events: Not emitted; user profiles and device statuses are hardcoded.
• Supported Inputs: Up, Down, Click, Double-click.

Final Note

This simulator is a supplement to, not a replacement for, hardware testing. Always validate on actual hardware before deployment.