design-guidelines

Even Hub G2 Design Guidelines

Display Constraints

• Resolution: 576 x 288 pixels per eye
• Color depth: 4-bit greyscale — 16 levels of green
• White pixels appear as bright green; black pixels are off (transparent)
• No background color or fill color property
• No CSS, no flexbox, no DOM — UI is built from absolute-positioned pixel containers
• Max 4 image containers and 8 other containers per page

Container Limits

• Max 12 containers total (8 text/list + 4 image)
• Exactly one container must have isEventCapture: 1
• containerID must be unique per page (integer)
• containerName must be unique per page (string, max 16 characters)
• Stacking order via zOrderIndex (SDK 0.0.12+) — all-or-nothing per page, unique values, larger = front; when omitted everywhere, declaration order determines overlap

Font & Text

• Single LVGL font baked into firmware
• Not monospaced
• No font selection, no font size control, no bold/italic
• Characters outside the font are silently skipped
• Text wraps at container width
• Use \n for line breaks
• ~400-500 characters fill a full-screen text container
• Unicode supported within the firmware font set

Common UI Patterns

Icon Design Principles

• Design at native resolution — work at actual pixel size (e.g., 24x24). Avoid designing large and scaling down.
• Keep it simple — aim for immediately recognizable silhouettes with minimal internal detail.
• Test on hardware — green-tinted greyscale rendering differs from your monitor. Always verify legibility on actual display or simulator with glow enabled.

Useful Unicode Characters

Full supported glyph tables: https://github.com/nickustinov/even-g2-notes

Image Containers

• Width: 20–288 px, Height: 20–144 px
• 4-bit greyscale
• Placeholder on creation — must call updateImageRawData to display content
• No concurrent image sends — wait for each to complete
• Use simple/flat colors; glasses have limited memory

Phone-Side App UI (Flutter WebView host)

The glasses render monochrome green on black, but the Flutter WebView that hosts your plugin on the phone has its own visual identity. Match the Even app design system when building phone-side config / settings / library screens so your plugin feels native inside Even Hub.

Color tokens

Brand rules:

• #FEF991 is Even brand yellow — use only for accent (buttons, highlights), never as a page background
• #3CFA44 is glasses-display green — use ONLY on the G2 display, NEVER in phone-side UI

Typography

Primary: FK Grotesk Neue (negative letter-spacing for a tight, editorial feel). Fallback: Source Han Sans for CJK, system sans for everything else.

Spacing

Use a 4/8 px grid: 4 8 12 16 24 32 48 64. Card padding: 16. Section spacing: 24–32. Screen edge padding: 20.

Figma Design Guidelines

Official design guidelines covering layout principles, component patterns, interaction models, and visual standards: https://www.figma.com/design/X82y5uJvqMH95jgOfmV34j/Even-Realities---Software-Design-Guidelines--Public-?node-id=2922-80782

Community Resources

• even-g2-notes (GitHub: https://github.com/nickustinov/even-g2-notes) — architecture deep-dives, full Unicode glyph tables, SDK quirks, error codes, reference implementations: chess, reddit reader, weather, Tesla vehicle status, pong, snake
• even-toolkit (GitHub: https://github.com/fabioglimb/even-toolkit, npm: even-toolkit) — 55+ React components, 191 pixel-art icons, design tokens, glasses SDK bridge utilities (useGlasses hook, buildActionBar, mapGlassEvent, canvas renderer, PNG utils, pagination helpers)
• Discord: https://discord.gg/Y4jHMCU4sv — developer community for support, bug reports, discussion

Task

$ARGUMENTS