opsfuse-ui 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/settings.local.json +8 -0
- package/.claude/skills/brief-to-tasks/SKILL.md +74 -0
- package/.claude/skills/design-brief/SKILL.md +120 -0
- package/.claude/skills/design-flow/SKILL.md +124 -0
- package/.claude/skills/design-review/SKILL.md +249 -0
- package/.claude/skills/design-tokens/SKILL.md +198 -0
- package/.claude/skills/frontend-design/SKILL.md +144 -0
- package/.claude/skills/grill-me/SKILL.md +21 -0
- package/.claude/skills/information-architecture/SKILL.md +111 -0
- package/.claude/skills/opsfuse-color-theme/SKILL.md +251 -0
- package/.claude/skills/opsfuse-components/SKILL.md +1439 -0
- package/.claude/skills/opsfuse-setup/SKILL.md +548 -0
- package/.claude/skills/opsfuse-ui-consistency/SKILL.md +160 -0
- package/README.md +356 -0
- package/dist/chunk-BdsCSvBP.js +20 -0
- package/dist/clsx-D7D_XZ_-.js +16 -0
- package/dist/components/logo/LogoMaker.d.ts +43 -0
- package/dist/components/logo/LogoMaker.d.ts.map +1 -0
- package/dist/components/logo/RecruitSmartly.d.ts +4 -0
- package/dist/components/logo/RecruitSmartly.d.ts.map +1 -0
- package/dist/components/logo/SkillReady.d.ts +4 -0
- package/dist/components/logo/SkillReady.d.ts.map +1 -0
- package/dist/components/logo/TalentScan.d.ts +4 -0
- package/dist/components/logo/TalentScan.d.ts.map +1 -0
- package/dist/components/logo/Verity.d.ts +4 -0
- package/dist/components/logo/Verity.d.ts.map +1 -0
- package/dist/components/logo/WorkLog.d.ts +4 -0
- package/dist/components/logo/WorkLog.d.ts.map +1 -0
- package/dist/components/opsfuse-root.d.ts +7 -0
- package/dist/components/opsfuse-root.d.ts.map +1 -0
- package/dist/components/opsfuse-theme-provider.d.ts +15 -0
- package/dist/components/opsfuse-theme-provider.d.ts.map +1 -0
- package/dist/components/ui/Header.d.ts +17 -0
- package/dist/components/ui/Header.d.ts.map +1 -0
- package/dist/components/ui/accordion.d.ts +20 -0
- package/dist/components/ui/accordion.d.ts.map +1 -0
- package/dist/components/ui/alert-dialog.d.ts +15 -0
- package/dist/components/ui/alert-dialog.d.ts.map +1 -0
- package/dist/components/ui/alert.d.ts +26 -0
- package/dist/components/ui/alert.d.ts.map +1 -0
- package/dist/components/ui/aspect-ratio.d.ts +4 -0
- package/dist/components/ui/aspect-ratio.d.ts.map +1 -0
- package/dist/components/ui/autocomplete.d.ts +24 -0
- package/dist/components/ui/autocomplete.d.ts.map +1 -0
- package/dist/components/ui/avatar.d.ts +9 -0
- package/dist/components/ui/avatar.d.ts.map +1 -0
- package/dist/components/ui/badge.d.ts +10 -0
- package/dist/components/ui/badge.d.ts.map +1 -0
- package/dist/components/ui/breadcrumb.d.ts +12 -0
- package/dist/components/ui/breadcrumb.d.ts.map +1 -0
- package/dist/components/ui/button-group.d.ts +12 -0
- package/dist/components/ui/button-group.d.ts.map +1 -0
- package/dist/components/ui/button.d.ts +14 -0
- package/dist/components/ui/button.d.ts.map +1 -0
- package/dist/components/ui/calendar.d.ts +11 -0
- package/dist/components/ui/calendar.d.ts.map +1 -0
- package/dist/components/ui/card.d.ts +14 -0
- package/dist/components/ui/card.d.ts.map +1 -0
- package/dist/components/ui/carousel.d.ts +29 -0
- package/dist/components/ui/carousel.d.ts.map +1 -0
- package/dist/components/ui/chart.d.ts +45 -0
- package/dist/components/ui/chart.d.ts.map +1 -0
- package/dist/components/ui/checkbox.d.ts +10 -0
- package/dist/components/ui/checkbox.d.ts.map +1 -0
- package/dist/components/ui/collapsible.d.ts +6 -0
- package/dist/components/ui/collapsible.d.ts.map +1 -0
- package/dist/components/ui/combobox.d.ts +40 -0
- package/dist/components/ui/combobox.d.ts.map +1 -0
- package/dist/components/ui/command.d.ts +19 -0
- package/dist/components/ui/command.d.ts.map +1 -0
- package/dist/components/ui/context-menu.d.ts +32 -0
- package/dist/components/ui/context-menu.d.ts.map +1 -0
- package/dist/components/ui/dialog.d.ts +30 -0
- package/dist/components/ui/dialog.d.ts.map +1 -0
- package/dist/components/ui/direction.d.ts +8 -0
- package/dist/components/ui/direction.d.ts.map +1 -0
- package/dist/components/ui/drawer.d.ts +14 -0
- package/dist/components/ui/drawer.d.ts.map +1 -0
- package/dist/components/ui/dropdown-menu.d.ts +30 -0
- package/dist/components/ui/dropdown-menu.d.ts.map +1 -0
- package/dist/components/ui/empty.d.ts +12 -0
- package/dist/components/ui/empty.d.ts.map +1 -0
- package/dist/components/ui/field.d.ts +25 -0
- package/dist/components/ui/field.d.ts.map +1 -0
- package/dist/components/ui/form.d.ts +27 -0
- package/dist/components/ui/form.d.ts.map +1 -0
- package/dist/components/ui/hover-card.d.ts +7 -0
- package/dist/components/ui/hover-card.d.ts.map +1 -0
- package/dist/components/ui/input-group.d.ts +18 -0
- package/dist/components/ui/input-group.d.ts.map +1 -0
- package/dist/components/ui/input-otp.d.ts +12 -0
- package/dist/components/ui/input-otp.d.ts.map +1 -0
- package/dist/components/ui/input.d.ts +12 -0
- package/dist/components/ui/input.d.ts.map +1 -0
- package/dist/components/ui/item.d.ts +24 -0
- package/dist/components/ui/item.d.ts.map +1 -0
- package/dist/components/ui/kbd.d.ts +4 -0
- package/dist/components/ui/kbd.d.ts.map +1 -0
- package/dist/components/ui/label.d.ts +5 -0
- package/dist/components/ui/label.d.ts.map +1 -0
- package/dist/components/ui/menubar.d.ts +31 -0
- package/dist/components/ui/menubar.d.ts.map +1 -0
- package/dist/components/ui/navigation-menu.d.ts +15 -0
- package/dist/components/ui/navigation-menu.d.ts.map +1 -0
- package/dist/components/ui/pagination.d.ts +15 -0
- package/dist/components/ui/pagination.d.ts.map +1 -0
- package/dist/components/ui/popover.d.ts +11 -0
- package/dist/components/ui/popover.d.ts.map +1 -0
- package/dist/components/ui/progress.d.ts +19 -0
- package/dist/components/ui/progress.d.ts.map +1 -0
- package/dist/components/ui/radio-group.d.ts +11 -0
- package/dist/components/ui/radio-group.d.ts.map +1 -0
- package/dist/components/ui/resizable.d.ts +8 -0
- package/dist/components/ui/resizable.d.ts.map +1 -0
- package/dist/components/ui/scroll-area.d.ts +6 -0
- package/dist/components/ui/scroll-area.d.ts.map +1 -0
- package/dist/components/ui/select.d.ts +27 -0
- package/dist/components/ui/select.d.ts.map +1 -0
- package/dist/components/ui/separator.d.ts +5 -0
- package/dist/components/ui/separator.d.ts.map +1 -0
- package/dist/components/ui/shadcn/shadcn-accordion.d.ts +8 -0
- package/dist/components/ui/shadcn/shadcn-accordion.d.ts.map +1 -0
- package/dist/components/ui/shadcn/shadcn-alert-dialog.d.ts +19 -0
- package/dist/components/ui/shadcn/shadcn-alert-dialog.d.ts.map +1 -0
- package/dist/components/ui/shadcn/shadcn-avatar.d.ts +12 -0
- package/dist/components/ui/shadcn/shadcn-avatar.d.ts.map +1 -0
- package/dist/components/ui/shadcn/shadcn-combobox.d.ts +33 -0
- package/dist/components/ui/shadcn/shadcn-combobox.d.ts.map +1 -0
- package/dist/components/ui/shadcn/shadcn-dropdown-menu.d.ts +30 -0
- package/dist/components/ui/shadcn/shadcn-dropdown-menu.d.ts.map +1 -0
- package/dist/components/ui/shadcn/shadcn-empty.d.ts +12 -0
- package/dist/components/ui/shadcn/shadcn-empty.d.ts.map +1 -0
- package/dist/components/ui/shadcn/shadcn-pagination.d.ts +18 -0
- package/dist/components/ui/shadcn/shadcn-pagination.d.ts.map +1 -0
- package/dist/components/ui/shadcn/shadcn-select.d.ts +24 -0
- package/dist/components/ui/shadcn/shadcn-select.d.ts.map +1 -0
- package/dist/components/ui/shadcn/shadcn-tabs.d.ts +12 -0
- package/dist/components/ui/shadcn/shadcn-tabs.d.ts.map +1 -0
- package/dist/components/ui/shadcn/shadcn-tooltip.d.ts +11 -0
- package/dist/components/ui/shadcn/shadcn-tooltip.d.ts.map +1 -0
- package/dist/components/ui/sheet.d.ts +28 -0
- package/dist/components/ui/sheet.d.ts.map +1 -0
- package/dist/components/ui/sidebar.d.ts +70 -0
- package/dist/components/ui/sidebar.d.ts.map +1 -0
- package/dist/components/ui/skeleton.d.ts +3 -0
- package/dist/components/ui/skeleton.d.ts.map +1 -0
- package/dist/components/ui/slider.d.ts +22 -0
- package/dist/components/ui/slider.d.ts.map +1 -0
- package/dist/components/ui/sonner.d.ts +5 -0
- package/dist/components/ui/sonner.d.ts.map +1 -0
- package/dist/components/ui/spinner.d.ts +3 -0
- package/dist/components/ui/spinner.d.ts.map +1 -0
- package/dist/components/ui/switch.d.ts +12 -0
- package/dist/components/ui/switch.d.ts.map +1 -0
- package/dist/components/ui/table.d.ts +11 -0
- package/dist/components/ui/table.d.ts.map +1 -0
- package/dist/components/ui/tabs.d.ts +22 -0
- package/dist/components/ui/tabs.d.ts.map +1 -0
- package/dist/components/ui/textarea.d.ts +9 -0
- package/dist/components/ui/textarea.d.ts.map +1 -0
- package/dist/components/ui/toggle-group.d.ts +11 -0
- package/dist/components/ui/toggle-group.d.ts.map +1 -0
- package/dist/components/ui/toggle.d.ts +10 -0
- package/dist/components/ui/toggle.d.ts.map +1 -0
- package/dist/components/ui/tooltip.d.ts +15 -0
- package/dist/components/ui/tooltip.d.ts.map +1 -0
- package/dist/core.d.ts +2 -0
- package/dist/core.d.ts.map +1 -0
- package/dist/core.js +3 -0
- package/dist/es6-D-3xKXBT.js +24045 -0
- package/dist/extended.d.ts +2 -0
- package/dist/extended.d.ts.map +1 -0
- package/dist/extended.js +3 -0
- package/dist/hooks/use-mobile.d.ts +2 -0
- package/dist/hooks/use-mobile.d.ts.map +1 -0
- package/dist/icons.d.ts +2 -0
- package/dist/icons.d.ts.map +1 -0
- package/dist/icons.js +2 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +2194 -0
- package/dist/input-group-DIfVGMYe.js +5196 -0
- package/dist/input-otp-DwLGFwVo.js +11879 -0
- package/dist/lib/brand-theme.d.ts +4 -0
- package/dist/lib/brand-theme.d.ts.map +1 -0
- package/dist/lib/document-dark-mode.d.ts +8 -0
- package/dist/lib/document-dark-mode.d.ts.map +1 -0
- package/dist/lib/opsfuse-portal-theme.d.ts +21 -0
- package/dist/lib/opsfuse-portal-theme.d.ts.map +1 -0
- package/dist/lib/theme-scope.d.ts +3 -0
- package/dist/lib/theme-scope.d.ts.map +1 -0
- package/dist/lib/utils.d.ts +3 -0
- package/dist/lib/utils.d.ts.map +1 -0
- package/dist/lucide-react-DLVJK_zM.js +38405 -0
- package/dist/public-api-core.d.ts +61 -0
- package/dist/public-api-core.d.ts.map +1 -0
- package/dist/public-api-extended.d.ts +9 -0
- package/dist/public-api-extended.d.ts.map +1 -0
- package/dist/public-api.d.ts +73 -0
- package/dist/public-api.d.ts.map +1 -0
- package/dist/recharts.d.ts +2 -0
- package/dist/recharts.d.ts.map +1 -0
- package/dist/recharts.js +2 -0
- package/dist/style.css +3 -0
- package/dist/style.layered.css +3 -0
- package/dist/toggle-group-D21Ul2kd.js +10171 -0
- package/package.json +113 -0
- package/scripts/postinstall.mjs +67 -0
- package/scripts/unwrap-css-layers.mjs +36 -0
|
@@ -0,0 +1,251 @@
|
|
|
1
|
+
# Color Theme & Typography Guide — OpsFuse UI
|
|
2
|
+
|
|
3
|
+
You are an expert on the OpsFuse UI design token system. When invoked, answer questions about which color token, typography class, or theme variable to use — and when and why.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Token Philosophy
|
|
8
|
+
|
|
9
|
+
Every token has **one name and one purpose**. Color names follow **shadcn/ui** conventions in `brands.css` (`--background`, `--foreground`, `--destructive`, …). Never use arbitrary colors or Tailwind palette classes (e.g. `blue-500`). Always reach for the semantic token that describes the *role*, not the appearance.
|
|
10
|
+
|
|
11
|
+
**File locations:**
|
|
12
|
+
- Color tokens → `src/brands.css`
|
|
13
|
+
- Non-color tokens (spacing, radius, motion, z-index) → `src/index.css`
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## Surface Tokens — Elevation Ladder (shadcn-aligned)
|
|
18
|
+
|
|
19
|
+
Use the surface that matches the element's visual elevation. Names match shadcn/ui (`--background`, `--card`, `--muted`, …). Light mode uses borders to define depth; dark mode uses surface tones.
|
|
20
|
+
|
|
21
|
+
| Level | When to use | Token |
|
|
22
|
+
|-------|-------------|-------|
|
|
23
|
+
| 0 — Page canvas | Root background, app shell | `--background` |
|
|
24
|
+
| 1 — Cards & panels | Card bodies, sidebars, list items | `--card` + `--border` |
|
|
25
|
+
| 2 — Inset / recessed | Input backgrounds, code blocks, inset sections | `--muted` |
|
|
26
|
+
| 2.5 — Overlays | Hover highlights, selected rows, subtle overlays | `--accent` |
|
|
27
|
+
| 3 — Dropdowns / popovers | Dropdown menus, command palette, tooltip panels | `--popover` + `--shadow-md` |
|
|
28
|
+
| 4 — Modals | Dialog overlays, drawer contents | `--popover` + `--shadow-lg` |
|
|
29
|
+
|
|
30
|
+
**Rules:**
|
|
31
|
+
- Never skip levels (e.g. don't put a modal on `--background` alone when you need popover elevation)
|
|
32
|
+
- Never use `white` or `black` directly — they break dark mode
|
|
33
|
+
- `--card` is for things that "float" above the page canvas
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## Text Tokens
|
|
38
|
+
|
|
39
|
+
| Token | Role | Examples |
|
|
40
|
+
|-------|------|---------|
|
|
41
|
+
| `--foreground` | Headings, critical labels, active states | `<h1>` – `<h4>`, selected nav items |
|
|
42
|
+
| `--subtle-foreground` | Body copy, descriptions, general text | `<p>`, card descriptions, list items |
|
|
43
|
+
| `--muted-foreground` | Meta, timestamps, placeholder-adjacent hints | Captions, helper text, subtitles (also shadcn `muted-foreground`) |
|
|
44
|
+
| `--disabled-foreground` | Disabled state labels | Disabled form fields, dimmed text |
|
|
45
|
+
|
|
46
|
+
**Rule:** Never use `--muted-foreground` for interactive text. It fails contrast in some brand themes.
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
## Primary Action Tokens
|
|
51
|
+
|
|
52
|
+
| Token | Use |
|
|
53
|
+
|-------|-----|
|
|
54
|
+
| `--primary` | Button bg, active underlines, accent dots |
|
|
55
|
+
| `--primary-foreground` | Text/icon on top of `--primary` bg (shadcn name) |
|
|
56
|
+
| `--primary-hover` | Hover state for primary bg |
|
|
57
|
+
| `--primary-active` | Pressed/active state |
|
|
58
|
+
| `--primary-muted` | Tinted bg for selected/highlighted items (not buttons) |
|
|
59
|
+
| `--primary-muted-hover` | Hover on a primary-tinted surface |
|
|
60
|
+
| `--primary-border` | Border on primary-tinted surfaces |
|
|
61
|
+
| `--primary-muted-foreground` | Text inside primary-tinted surfaces (NOT on filled primary bg) |
|
|
62
|
+
|
|
63
|
+
**Rule:** Use `--primary-foreground` when text sits on `--primary` itself. Use `--primary-muted-foreground` when text sits on `--primary-muted`.
|
|
64
|
+
|
|
65
|
+
---
|
|
66
|
+
|
|
67
|
+
## AI Identity Tokens
|
|
68
|
+
|
|
69
|
+
The AI system is visually distinct — cool teal, separate from the warm indigo primary. Keep AI surfaces limited to AI-generated content.
|
|
70
|
+
|
|
71
|
+
| Token | Use |
|
|
72
|
+
|-------|-----|
|
|
73
|
+
| `--ai` | AI accent dot, pulsing indicator |
|
|
74
|
+
| `--ai-foreground` | Icon/text directly on `--ai` bg |
|
|
75
|
+
| `--ai-muted` | Background of AI response panels |
|
|
76
|
+
| `--ai-muted-hover` | Hover on AI surfaces |
|
|
77
|
+
| `--ai-border` | Border around AI panels / `.strip-ai` |
|
|
78
|
+
| `--ai-muted-foreground` | Text inside AI surfaces |
|
|
79
|
+
|
|
80
|
+
**CSS utilities available:**
|
|
81
|
+
- `.badge-ai` — animated pulsing badge with "AI" label
|
|
82
|
+
- `.strip-ai` — left-bordered AI response panel
|
|
83
|
+
- `.pill-ai` — small AI status pill
|
|
84
|
+
- `.score-fill-ai` — teal score bar fill
|
|
85
|
+
- `.prose-ai` — open-tracked text style for AI output
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## Semantic State Tokens
|
|
90
|
+
|
|
91
|
+
Each semantic state uses a **muted + foreground** pattern (aligned with destructive naming in shadcn). **Destructive** replaces the old `danger` prefix.
|
|
92
|
+
|
|
93
|
+
| State | Solid / indicator | On-solid text | Tinted bg | Border on tint | Text on tint |
|
|
94
|
+
|-------|---------------------|---------------|-----------|----------------|---------------|
|
|
95
|
+
| `success` | `--success` | `--success-foreground` | `--success-muted` | `--success-border` | `--success-muted-foreground` |
|
|
96
|
+
| `warning` | `--warning` | `--warning-foreground` | `--warning-muted` | `--warning-border` | `--warning-muted-foreground` |
|
|
97
|
+
| `destructive` | `--destructive` | `--destructive-foreground` | `--destructive-muted` | `--destructive-border` | `--destructive-muted-foreground` |
|
|
98
|
+
| `info` | `--info` | `--info-foreground` | `--info-muted` | `--info-border` | `--info-muted-foreground` |
|
|
99
|
+
|
|
100
|
+
**CSS pill utilities:** `.pill-success`, `.pill-warning`, `.pill-danger` (class name unchanged; tokens are `--destructive*`)
|
|
101
|
+
**Score bar fills:** `.score-fill-good`, `.score-fill-warn`, `.score-fill-danger`
|
|
102
|
+
|
|
103
|
+
**When to use which state:**
|
|
104
|
+
- `success` → completed actions, passing scores, confirmations
|
|
105
|
+
- `warning` → partial, below-threshold, user attention needed
|
|
106
|
+
- `destructive` → errors, deletion, destructive consequences
|
|
107
|
+
- `info` → neutral callouts, help text, tips
|
|
108
|
+
|
|
109
|
+
---
|
|
110
|
+
|
|
111
|
+
## Border Tokens
|
|
112
|
+
|
|
113
|
+
| Token | Use |
|
|
114
|
+
|-------|-----|
|
|
115
|
+
| `--border-subtle` | Very faint dividers, zebra rows, barely-there separators |
|
|
116
|
+
| `--border` | Standard card/input borders (Level 1 elevation; shadcn default border token) |
|
|
117
|
+
| `--border-strong` | Hover states on cards, active inputs, emphasized separators |
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
## Shadow Tokens
|
|
122
|
+
|
|
123
|
+
| Token | When |
|
|
124
|
+
|-------|------|
|
|
125
|
+
| `--shadow-focus` | Focus rings (3px ring on interactive elements) |
|
|
126
|
+
| `--shadow-sm` | Subtle card lift, Level 1 hover |
|
|
127
|
+
| `--shadow-md` | Dropdowns, popovers (Level 3) |
|
|
128
|
+
| `--shadow-lg` | Modals, drawers (Level 4) |
|
|
129
|
+
|
|
130
|
+
---
|
|
131
|
+
|
|
132
|
+
## Brand Themes
|
|
133
|
+
|
|
134
|
+
Apply via CSS class on the `.opsfuse-ui` root or the `OpsfuseThemeProvider` `brand` prop.
|
|
135
|
+
|
|
136
|
+
| Class | Brand | Personality | Primary color |
|
|
137
|
+
|-------|-------|-------------|---------------|
|
|
138
|
+
| *(none)* | **OpsFuse Default** | Warm Minimal · Deep · Intelligent | Indigo `oklch(0.56 0.19 278)` |
|
|
139
|
+
| `brand-skillready` | **SkillReady** | Warm · Confident · Growth-Oriented | Burnt Orange `#c2561a` |
|
|
140
|
+
| *(other brand classes defined in brands.css)* | ... | ... | ... |
|
|
141
|
+
|
|
142
|
+
**How to apply:** `<OpsfuseThemeProvider brand="skillready">` or add `brand-skillready` class.
|
|
143
|
+
|
|
144
|
+
---
|
|
145
|
+
|
|
146
|
+
## Gradient Tokens
|
|
147
|
+
|
|
148
|
+
| Token | Use |
|
|
149
|
+
|-------|-----|
|
|
150
|
+
| `--brand-gradient` | Hero sections, logo backgrounds, marquee CTAs |
|
|
151
|
+
| `--brand-gradient-subtle` | Gentle page headers, section tints |
|
|
152
|
+
|
|
153
|
+
**Rule:** Limit `--brand-gradient` to 1–2 elements per page. It's a premium accent, not a background fill.
|
|
154
|
+
|
|
155
|
+
---
|
|
156
|
+
|
|
157
|
+
## Chart Tokens
|
|
158
|
+
|
|
159
|
+
Use in order: `--chart-1` through `--chart-6` for multi-series data. Then `--chart-grid` for gridlines and `--chart-axis` for axis labels.
|
|
160
|
+
|
|
161
|
+
**Score display tokens** (ordered worst → best):
|
|
162
|
+
`--score-poor` → `--score-below` → `--score-average` → `--score-good` → `--score-excellent`
|
|
163
|
+
|
|
164
|
+
---
|
|
165
|
+
|
|
166
|
+
## Typography Classes
|
|
167
|
+
|
|
168
|
+
Defined in `index.css` `@layer components`. Use these instead of manual font/size/color combos.
|
|
169
|
+
|
|
170
|
+
| Class | Size | Color | Line-height | Use |
|
|
171
|
+
|-------|------|-------|-------------|-----|
|
|
172
|
+
| `.prose-body` | 1rem | `--subtle-foreground` | 1.75 | Long-form paragraphs, articles |
|
|
173
|
+
| `.prose-ui` | 0.9rem | `--subtle-foreground` | 1.6 | Interface text, descriptions, form help |
|
|
174
|
+
| `.prose-ai` | 0.925rem | `--subtle-foreground` | 1.8 | AI-generated text (open letter-spacing signals machine output) |
|
|
175
|
+
| `.prose-mono` | 0.82rem | `--subtle-foreground` | 1.6 | Code snippets, scores, statistics |
|
|
176
|
+
| `.caption` | 0.75rem | `--muted-foreground` | 1.5 | Timestamps, meta, helper text |
|
|
177
|
+
| `.label-sm` | 0.7rem | `--muted-foreground` | 1 | Uppercase section labels (uppercase + tracked) |
|
|
178
|
+
|
|
179
|
+
**Heading elements** (`h1`–`h4`) are styled directly on `.opsfuse-ui` children — no extra class needed. They all use `--foreground`.
|
|
180
|
+
|
|
181
|
+
---
|
|
182
|
+
|
|
183
|
+
## Motion / Transition Classes
|
|
184
|
+
|
|
185
|
+
| Class | Use |
|
|
186
|
+
|-------|-----|
|
|
187
|
+
| `.transition-micro` | Buttons, chips, icons, hover color flips. Includes `scale(0.97)` on `:active` |
|
|
188
|
+
| `.transition-smooth` | Inputs, panels, dropdowns, tabs |
|
|
189
|
+
| `.transition-data` | Score bars, progress reveals, animated widths |
|
|
190
|
+
|
|
191
|
+
**Motion tokens:**
|
|
192
|
+
- `--duration-fast`: 120ms — hover colors, focus rings
|
|
193
|
+
- `--duration-base`: 200ms — inputs, buttons, dropdowns
|
|
194
|
+
- `--duration-slow`: 500ms — charts, score bars, page transitions
|
|
195
|
+
- `--ease-standard`: `cubic-bezier(0.16, 1, 0.3, 1)` — most transitions
|
|
196
|
+
- `--ease-spring`: `cubic-bezier(0.34, 1.56, 0.64, 1)` — snappy button presses
|
|
197
|
+
|
|
198
|
+
---
|
|
199
|
+
|
|
200
|
+
## Spacing Tokens
|
|
201
|
+
|
|
202
|
+
| Token | Value | Use |
|
|
203
|
+
|-------|-------|-----|
|
|
204
|
+
| `--space-1` | 4px | Tight: icon↔text, inline gaps |
|
|
205
|
+
| `--space-2` | 8px | Compact: badge padding, small gaps |
|
|
206
|
+
| `--space-3` | 12px | Standard: input padding-x, list gaps |
|
|
207
|
+
| `--space-4` | 16px | Default: card padding, section gaps |
|
|
208
|
+
| `--space-5` | 24px | Comfortable: between card sections |
|
|
209
|
+
| `--space-6` | 32px | Major: between groups of content |
|
|
210
|
+
| `--space-8` | 48px | Large: page-level vertical rhythm |
|
|
211
|
+
| `--space-10` | 64px | Hero: top-level, hero sections |
|
|
212
|
+
|
|
213
|
+
---
|
|
214
|
+
|
|
215
|
+
## Radius Tokens
|
|
216
|
+
|
|
217
|
+
| Token | Value | Use |
|
|
218
|
+
|-------|-------|-----|
|
|
219
|
+
| `--radius-sm` | 6px | Badges, chips, small inline elements |
|
|
220
|
+
| `--radius` | 10px | Inputs, buttons, standard components |
|
|
221
|
+
| `--radius-lg` | 14px | Cards, panels, modals |
|
|
222
|
+
| `--radius-xl` | 20px | Hero cards, featured containers |
|
|
223
|
+
|
|
224
|
+
---
|
|
225
|
+
|
|
226
|
+
## Do / Don't
|
|
227
|
+
|
|
228
|
+
| ✅ Do | ❌ Don't |
|
|
229
|
+
|-------|---------|
|
|
230
|
+
| `color: var(--subtle-foreground)` | `color: #6b7280` |
|
|
231
|
+
| `background: var(--card)` | `background: white` |
|
|
232
|
+
| `border-color: var(--border)` | Hardcoded gray border hex |
|
|
233
|
+
| `var(--primary-muted-foreground)` on primary-tinted surfaces | `var(--primary-foreground)` on those surfaces (wrong pairing) |
|
|
234
|
+
| `.caption` class for meta text | `text-xs text-gray-400` |
|
|
235
|
+
| `var(--destructive)` for error icons / destructive actions | Raw `red-600` / hex reds |
|
|
236
|
+
|
|
237
|
+
**Shadcn alignment:** Canonical color variables in `brands.css` use the same names shadcn/ui expects (`--background`, `--foreground`, `--card`, `--muted`, `--destructive`, `-*-foreground`, semantic `-*-muted` / `-*-muted-foreground`). Tailwind utilities (`bg-background`, `text-foreground`, …) are wired in `src/index.css` `@theme inline` to those variables. Use **`--subtle-foreground`** and **`--disabled-foreground`** for the extra text steps beyond shadcn's single `muted-foreground`.
|
|
238
|
+
|
|
239
|
+
---
|
|
240
|
+
|
|
241
|
+
## Z-Index Scale
|
|
242
|
+
|
|
243
|
+
| Token | Value | Layer |
|
|
244
|
+
|-------|-------|-------|
|
|
245
|
+
| `--z-base` | 0 | Normal flow |
|
|
246
|
+
| `--z-raised` | 10 | Sticky elements, floating buttons |
|
|
247
|
+
| `--z-dropdown` | 100 | Dropdown menus |
|
|
248
|
+
| `--z-sticky` | 200 | Sticky headers |
|
|
249
|
+
| `--z-modal` | 300 | Modals, dialogs |
|
|
250
|
+
| `--z-popover` | 400 | Popovers, tooltips |
|
|
251
|
+
| `--z-toast` | 500 | Toast notifications |
|