Skip to content

Commit 4eee8a8

Browse files
committed
docs: add UI design system
1 parent 09242ad commit 4eee8a8

1 file changed

Lines changed: 52 additions & 0 deletions

File tree

docs/UI_DESIGN_SYSTEM.md

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
# UI Design System
2+
3+
Use this design system for the default theme, customer helper app, screenshots, and future website.
4+
5+
## Visual style
6+
7+
- Premium dark UI
8+
- Desert Sand accent
9+
- Rounded cards
10+
- Soft glass look
11+
- Clear spacing
12+
- Strong title hierarchy
13+
- Minimal motion
14+
- Mobile-first layout
15+
16+
## Colors
17+
18+
| Token | Value | Usage |
19+
|---|---|---|
20+
| Background | `#0f0f10` | Main dark background |
21+
| Surface | `#1a1a1d` | Cards and panels |
22+
| Surface soft | `#242429` | Secondary cards |
23+
| Accent | `#e2b884` | Buttons, active states, highlights |
24+
| Text primary | `#f5f2ea` | Main text |
25+
| Text muted | `#b9b1a3` | Notes and descriptions |
26+
| Warning | `#ffcc66` | Experimental or test-required labels |
27+
| Success | `#8fd694` | Safe or supported labels |
28+
29+
## Layout rules
30+
31+
- Use 16dp screen padding minimum
32+
- Use 20dp to 28dp card radius
33+
- Keep cards under 5 lines of text
34+
- Show feature status badges clearly
35+
- Avoid heavy blur on low-end phones
36+
- Avoid long animations
37+
- Use compressed preview images
38+
39+
## Customer screen order
40+
41+
1. Default theme
42+
2. Wallpaper setup
43+
3. Lock screen setup
44+
4. Home screen setup
45+
5. Device support status
46+
6. Lag fix checklist
47+
7. Support report
48+
8. Rollback help
49+
50+
## Motion rule
51+
52+
Animations should feel premium, but never make the app slower. Use short fade or slide transitions only.

0 commit comments

Comments
 (0)