| name | control-panel-ui-ux |
| description | Minimal UI/UX rules for BuckyOS control_panel: pick a style, build a design system, and keep RPC-aligned. |
Control Panel UI/UX Skill
Use this when designing or implementing control_panel UI.
When to Apply
- New UI page or component
- Visual refresh or UX fix
- Aligning UI with RPC data
Rule Priorities
- Accessibility: contrast, focus, keyboard nav
- Interaction: touch targets >= 44x44px, no layout shift on hover
- Layout: responsive, no horizontal scroll
- Typography & color: consistent scale and palette
- Motion: respect prefers-reduced-motion
Design System (current)
- Primary color: #0f766e
- Accent color: #f59e0b
- Fonts: Space Grotesk (headings), Work Sans (body)
Design Tokens (add/update)
- Neutrals: #0f172a (ink), #52606d (muted), #d7e1df (border), #f4f8f7 (surface muted), #ffffff (surface)
- Radius scale: 8 / 12 / 18 / 24
- Shadow scale: soft / strong (avoid heavy blur)
- Spacing scale: 4 / 8 / 12 / 16 / 24 / 32
Typography Scale
- Sizes: 12 / 14 / 16 / 20 / 24 / 32
- Line-height: body 1.5, headings 1.2
Icon System
- Use one SVG icon set only
- Sizes: 16 / 20 / 24
- No emoji icons
Layout Rules
- Max content width: 1280
- Sidebar width: 260
- Card gap: 16-24
- Page padding: 24 (desktop), 16 (mobile)
Component Rules
- Buttons: >= 44px touch target, clear hover/active/disabled
- Tables: header sticky when overflow, row height >= 44px
- Forms: label + helper text, error in place
Data Density
- Default density: medium
- Keep line length <= 75 chars
States
- Loading: skeleton or subtle shimmer
- Empty: explain why + next action
- Error: clear message + retry
Charts
- Series colors: primary then accent, avoid low-contrast pairs
- Gridlines light, labels muted
Motion
- 150-300ms transitions
- Respect prefers-reduced-motion
Workflow
- Define a design system (style, palette, typography, spacing).
- Apply UX rules above while building components.
- Match UI data fields to backend contracts (see
doc/dashboard/control_panel.md).
Quick Checks
- No emoji icons; use one SVG icon set.
- 375/768/1024/1440 widths verified.
- Focus states visible.
References
doc/dashboard/control_panel.md
