PRODUCT.md

Product

Register

product

Users

Pebblexus is for Plexus operators who want to glance at provider quotas and prepaid balances from a Pebble watch. They can be managing their agents away from a computer and need enough signal to understand each quota group without opening the Plexus management UI.

Product Purpose

Pebblexus presents Plexus quota checker data as small, readable watch pages grouped by provider or checker ID. Success means a user can browse groups sorted by most to least urgent according to meters where there's a total and a remaining amount. Groups with only numerical meters without a max, like an OpenRouter or Hyper balance, should sort after groups with meters that do have a max because we can't infer the former's criticality while we can the latter's.

Users must see each display name and group ID on each page, and avoid mistaking a prepaid meter for a percentage-based meter.

Brand Personality

Light, Pebble-native, charming. The app should feel like a polished native Pebble utility: glanceable, tactile, and a little delightful without making the data harder to read.

Anti-references

Do not copy Plexus' management UI directly. Avoid generic AI-dashboard dark mode, ornamental gradients, and heavy shadows.

Design Principles

  • Data semantics come first: balances are numbers, quotas are bars, and unknowns should be honest.
  • Group related quota meters together so one provider or checker feels like one page, then sort those pages so more urgent checkers surface first. Wraparound lets them predictably go back to checkers without an urgency signal.
  • Use calm, tactile, playful motion as feedback for state changes, not as constant decoration.
  • Prefer Pebble-native restraint: strong contrast, simple shapes, clear typography, small moments of charm.
  • Keep the app usable in a quick glance under imperfect ambient light.

Accessibility & Inclusion

Use high-contrast light mode as the default. Do not rely on color alone for quota state; pair color with numbers, labels, and page grouping. Keep animation brief and avoid continuous motion except during an active refresh. Dark mode will come later.