1# Product
2
3## Register
4
5product
6
7## Users
8
9Pebblexus is for Plexus operators who want to glance at provider quotas
10and prepaid balances from a Pebble watch. They can be managing their
11agents away from a computer and need enough signal to understand each
12quota group without opening the Plexus management UI.
13
14## Product Purpose
15
16Pebblexus presents Plexus quota checker data as small, readable watch
17pages grouped by provider or checker ID. Success means a user can browse
18groups sorted by most to least urgent according to meters where there's
19a total and a remaining amount. Groups with only numerical meters
20without a max, like an OpenRouter or Hyper balance, should sort after
21groups with meters that do have a max because we can't infer the
22former's criticality while we can the latter's.
23
24Users must see each display name and group ID on each page, and avoid
25mistaking a prepaid meter for a percentage-based meter.
26
27## Brand Personality
28
29Light, Pebble-native, charming. The app should feel like a polished
30native Pebble utility: glanceable, tactile, and a little delightful
31without making the data harder to read.
32
33## Anti-references
34
35Do not copy Plexus' management UI directly. Avoid generic AI-dashboard
36dark mode, ornamental gradients, and heavy shadows.
37
38## Design Principles
39
40- Data semantics come first: balances are numbers, quotas are bars, and
41 unknowns should be honest.
42- Group related quota meters together so one provider or checker feels
43 like one page, then sort those pages so more urgent checkers surface
44 first. Wraparound lets them predictably go back to checkers without an
45 urgency signal.
46- Use calm, tactile, playful motion as feedback for state changes, not
47 as constant decoration.
48- Prefer Pebble-native restraint: strong contrast, simple shapes, clear
49 typography, small moments of charm.
50- Keep the app usable in a quick glance under imperfect ambient light.
51
52## Accessibility & Inclusion
53
54Use high-contrast light mode as the default. Do not rely on color alone
55for quota state; pair color with numbers, labels, and page grouping.
56Keep animation brief and avoid continuous motion except during an active
57refresh. Dark mode will come later.