# matic even

> We measured a pair of Even Realities G2 glasses. Here is what we found, and the parts to build a G2 app on them: glasses UI, phone UI, test tools, a demo app and a skill for your AI.

The page is https://even.matic.sh. The files below are markdown in https://github.com/maticsh/matic-even.

## Setup

- [Set up a computer for matic even](https://github.com/maticsh/matic-even/raw/main/docs/ai/setup.md): steps for an AI to follow. Also at https://even.matic.sh/setup.md

## Findings

- [Display](https://github.com/maticsh/matic-even/raw/main/docs/findings/display.md): H1 Blink a small, solid shape to alert; H2 Text brightness levels look too alike to rank text; H18 The display sits above the line of sight; H20 A page rebuild cannot animate; H21 Overflowing text scrolls in firmware
- [Images and bandwidth](https://github.com/maticsh/matic-even/raw/main/docs/findings/images.md): H3 Images show all 16 grey levels; H4 A small image lands in 150 to 300 ms; H5 Image replacement does not flicker, and rapid sends all land
- [Sensors](https://github.com/maticsh/matic-even/raw/main/docs/findings/sensors.md): H6 The wearing sensor reports while a plugin is open; H17 Wear detection is a user setting; H13 The IMU is an accelerometer in g; H14 The IMU can tell what the wearer is doing, even at 1 Hz
- [Lifecycle and the phone](https://github.com/maticsh/matic-even/raw/main/docs/findings/lifecycle.md): H7 OS overlays fire foreground events: ENTER on open, EXIT on close; H10 A sideload runs without gaps with the phone unlocked; H15 A QR sideload kept running for 18 minutes with the iPhone locked
- [Fonts and scripts](https://github.com/maticsh/matic-even/raw/main/docs/findings/fonts.md): H8 The simulator makes glyphs look heavier than they are; H9 The firmware font reads a little large; H23 The firmware font has no Hindi. Send it as an image
- [Input](https://github.com/maticsh/matic-even/raw/main/docs/findings/input.md): H11 Quick repeated taps become a double tap; H12 One long swipe can arrive as several scroll events; H16 A plain long press reaches the app; H19 Users can take long press for a system action
- [The WebView](https://github.com/maticsh/matic-even/raw/main/docs/findings/webview.md): H22 Share, clipboard and mail links fail in the WebView

## Review lessons

- [No URL strings off the whitelist](https://github.com/maticsh/matic-even/raw/main/docs/review/urls.md): Even Hub review scans your built bundle for URL-shaped strings.
- [Switch sensors off at exit](https://github.com/maticsh/matic-even/raw/main/docs/review/sensors.md): When your app exits, turn off every sensor it turned on.
- [The store listing and the manifest](https://github.com/maticsh/matic-even/raw/main/docs/review/listing.md): Lessons from filling in the Even Hub developer portal, and the manifest rules that a check can catch before you upload.

## Open questions

- [P3: Does a plugin survive a 30-minute phone lock?](https://github.com/maticsh/matic-even/raw/main/docs/probes/P3.md)
- [P4: How fast does the wearing sensor react?](https://github.com/maticsh/matic-even/raw/main/docs/probes/P4.md)
- [P8: What fires when the phone backgrounds the Even app or locks?](https://github.com/maticsh/matic-even/raw/main/docs/probes/P8.md)
- [P10: What does an IMU and a slow animation cost in battery over 30 minutes?](https://github.com/maticsh/matic-even/raw/main/docs/probes/P10.md)
- [P12: Why did the IMU stream stop for 29 seconds?](https://github.com/maticsh/matic-even/raw/main/docs/probes/P12.md)
- [P13: Do image updates wipe text that was upgraded earlier?](https://github.com/maticsh/matic-even/raw/main/docs/probes/P13.md)
- [P14: Is the Even AI Agent setting shown to every user?](https://github.com/maticsh/matic-even/raw/main/docs/probes/P14.md)

## Packages

- [@maticsh/glasses](https://github.com/maticsh/matic-even/raw/main/packages/glasses/README.md): Primitives for the glasses side of an Even Realities G2 app.
- [@maticsh/phone](https://github.com/maticsh/matic-even/raw/main/packages/phone/README.md): Parts for the phone page of an Even Realities G2 app.
- [@maticsh/testing](https://github.com/maticsh/matic-even/raw/main/packages/testing/README.md): Test tools for Even Realities G2 apps.

## Apps

- [Checklist, the demo app](https://github.com/maticsh/matic-even/raw/main/apps/checklist/README.md): A demo G2 app: three short lists, ticked from the glasses and edited on the phone.
- [How Checklist is built](https://github.com/maticsh/matic-even/raw/main/docs/architecture.md): its folders, the screen model, input, writes to the glasses, state and tests
- [Relay server](https://github.com/maticsh/matic-even/raw/main/apps/relay/README.md): A small server that fetches outside data for a G2 app.

## Skills

- [even-g2](https://github.com/maticsh/matic-even/raw/main/skills/skills/even-g2/SKILL.md): Build apps for Even Realities G2 smart glasses (and the R1 ring) on the Even Hub platform.
- [even-g2-preflight](https://github.com/maticsh/matic-even/raw/main/skills/skills/even-g2-preflight/SKILL.md): Check an Even Realities G2 app before you pack it for Even Hub store review.
- [even-g2: references/sdk.md](https://github.com/maticsh/matic-even/raw/main/skills/skills/even-g2/references/sdk.md)