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.
Files changed (209) hide show
  1. package/.claude/settings.local.json +8 -0
  2. package/.claude/skills/brief-to-tasks/SKILL.md +74 -0
  3. package/.claude/skills/design-brief/SKILL.md +120 -0
  4. package/.claude/skills/design-flow/SKILL.md +124 -0
  5. package/.claude/skills/design-review/SKILL.md +249 -0
  6. package/.claude/skills/design-tokens/SKILL.md +198 -0
  7. package/.claude/skills/frontend-design/SKILL.md +144 -0
  8. package/.claude/skills/grill-me/SKILL.md +21 -0
  9. package/.claude/skills/information-architecture/SKILL.md +111 -0
  10. package/.claude/skills/opsfuse-color-theme/SKILL.md +251 -0
  11. package/.claude/skills/opsfuse-components/SKILL.md +1439 -0
  12. package/.claude/skills/opsfuse-setup/SKILL.md +548 -0
  13. package/.claude/skills/opsfuse-ui-consistency/SKILL.md +160 -0
  14. package/README.md +356 -0
  15. package/dist/chunk-BdsCSvBP.js +20 -0
  16. package/dist/clsx-D7D_XZ_-.js +16 -0
  17. package/dist/components/logo/LogoMaker.d.ts +43 -0
  18. package/dist/components/logo/LogoMaker.d.ts.map +1 -0
  19. package/dist/components/logo/RecruitSmartly.d.ts +4 -0
  20. package/dist/components/logo/RecruitSmartly.d.ts.map +1 -0
  21. package/dist/components/logo/SkillReady.d.ts +4 -0
  22. package/dist/components/logo/SkillReady.d.ts.map +1 -0
  23. package/dist/components/logo/TalentScan.d.ts +4 -0
  24. package/dist/components/logo/TalentScan.d.ts.map +1 -0
  25. package/dist/components/logo/Verity.d.ts +4 -0
  26. package/dist/components/logo/Verity.d.ts.map +1 -0
  27. package/dist/components/logo/WorkLog.d.ts +4 -0
  28. package/dist/components/logo/WorkLog.d.ts.map +1 -0
  29. package/dist/components/opsfuse-root.d.ts +7 -0
  30. package/dist/components/opsfuse-root.d.ts.map +1 -0
  31. package/dist/components/opsfuse-theme-provider.d.ts +15 -0
  32. package/dist/components/opsfuse-theme-provider.d.ts.map +1 -0
  33. package/dist/components/ui/Header.d.ts +17 -0
  34. package/dist/components/ui/Header.d.ts.map +1 -0
  35. package/dist/components/ui/accordion.d.ts +20 -0
  36. package/dist/components/ui/accordion.d.ts.map +1 -0
  37. package/dist/components/ui/alert-dialog.d.ts +15 -0
  38. package/dist/components/ui/alert-dialog.d.ts.map +1 -0
  39. package/dist/components/ui/alert.d.ts +26 -0
  40. package/dist/components/ui/alert.d.ts.map +1 -0
  41. package/dist/components/ui/aspect-ratio.d.ts +4 -0
  42. package/dist/components/ui/aspect-ratio.d.ts.map +1 -0
  43. package/dist/components/ui/autocomplete.d.ts +24 -0
  44. package/dist/components/ui/autocomplete.d.ts.map +1 -0
  45. package/dist/components/ui/avatar.d.ts +9 -0
  46. package/dist/components/ui/avatar.d.ts.map +1 -0
  47. package/dist/components/ui/badge.d.ts +10 -0
  48. package/dist/components/ui/badge.d.ts.map +1 -0
  49. package/dist/components/ui/breadcrumb.d.ts +12 -0
  50. package/dist/components/ui/breadcrumb.d.ts.map +1 -0
  51. package/dist/components/ui/button-group.d.ts +12 -0
  52. package/dist/components/ui/button-group.d.ts.map +1 -0
  53. package/dist/components/ui/button.d.ts +14 -0
  54. package/dist/components/ui/button.d.ts.map +1 -0
  55. package/dist/components/ui/calendar.d.ts +11 -0
  56. package/dist/components/ui/calendar.d.ts.map +1 -0
  57. package/dist/components/ui/card.d.ts +14 -0
  58. package/dist/components/ui/card.d.ts.map +1 -0
  59. package/dist/components/ui/carousel.d.ts +29 -0
  60. package/dist/components/ui/carousel.d.ts.map +1 -0
  61. package/dist/components/ui/chart.d.ts +45 -0
  62. package/dist/components/ui/chart.d.ts.map +1 -0
  63. package/dist/components/ui/checkbox.d.ts +10 -0
  64. package/dist/components/ui/checkbox.d.ts.map +1 -0
  65. package/dist/components/ui/collapsible.d.ts +6 -0
  66. package/dist/components/ui/collapsible.d.ts.map +1 -0
  67. package/dist/components/ui/combobox.d.ts +40 -0
  68. package/dist/components/ui/combobox.d.ts.map +1 -0
  69. package/dist/components/ui/command.d.ts +19 -0
  70. package/dist/components/ui/command.d.ts.map +1 -0
  71. package/dist/components/ui/context-menu.d.ts +32 -0
  72. package/dist/components/ui/context-menu.d.ts.map +1 -0
  73. package/dist/components/ui/dialog.d.ts +30 -0
  74. package/dist/components/ui/dialog.d.ts.map +1 -0
  75. package/dist/components/ui/direction.d.ts +8 -0
  76. package/dist/components/ui/direction.d.ts.map +1 -0
  77. package/dist/components/ui/drawer.d.ts +14 -0
  78. package/dist/components/ui/drawer.d.ts.map +1 -0
  79. package/dist/components/ui/dropdown-menu.d.ts +30 -0
  80. package/dist/components/ui/dropdown-menu.d.ts.map +1 -0
  81. package/dist/components/ui/empty.d.ts +12 -0
  82. package/dist/components/ui/empty.d.ts.map +1 -0
  83. package/dist/components/ui/field.d.ts +25 -0
  84. package/dist/components/ui/field.d.ts.map +1 -0
  85. package/dist/components/ui/form.d.ts +27 -0
  86. package/dist/components/ui/form.d.ts.map +1 -0
  87. package/dist/components/ui/hover-card.d.ts +7 -0
  88. package/dist/components/ui/hover-card.d.ts.map +1 -0
  89. package/dist/components/ui/input-group.d.ts +18 -0
  90. package/dist/components/ui/input-group.d.ts.map +1 -0
  91. package/dist/components/ui/input-otp.d.ts +12 -0
  92. package/dist/components/ui/input-otp.d.ts.map +1 -0
  93. package/dist/components/ui/input.d.ts +12 -0
  94. package/dist/components/ui/input.d.ts.map +1 -0
  95. package/dist/components/ui/item.d.ts +24 -0
  96. package/dist/components/ui/item.d.ts.map +1 -0
  97. package/dist/components/ui/kbd.d.ts +4 -0
  98. package/dist/components/ui/kbd.d.ts.map +1 -0
  99. package/dist/components/ui/label.d.ts +5 -0
  100. package/dist/components/ui/label.d.ts.map +1 -0
  101. package/dist/components/ui/menubar.d.ts +31 -0
  102. package/dist/components/ui/menubar.d.ts.map +1 -0
  103. package/dist/components/ui/navigation-menu.d.ts +15 -0
  104. package/dist/components/ui/navigation-menu.d.ts.map +1 -0
  105. package/dist/components/ui/pagination.d.ts +15 -0
  106. package/dist/components/ui/pagination.d.ts.map +1 -0
  107. package/dist/components/ui/popover.d.ts +11 -0
  108. package/dist/components/ui/popover.d.ts.map +1 -0
  109. package/dist/components/ui/progress.d.ts +19 -0
  110. package/dist/components/ui/progress.d.ts.map +1 -0
  111. package/dist/components/ui/radio-group.d.ts +11 -0
  112. package/dist/components/ui/radio-group.d.ts.map +1 -0
  113. package/dist/components/ui/resizable.d.ts +8 -0
  114. package/dist/components/ui/resizable.d.ts.map +1 -0
  115. package/dist/components/ui/scroll-area.d.ts +6 -0
  116. package/dist/components/ui/scroll-area.d.ts.map +1 -0
  117. package/dist/components/ui/select.d.ts +27 -0
  118. package/dist/components/ui/select.d.ts.map +1 -0
  119. package/dist/components/ui/separator.d.ts +5 -0
  120. package/dist/components/ui/separator.d.ts.map +1 -0
  121. package/dist/components/ui/shadcn/shadcn-accordion.d.ts +8 -0
  122. package/dist/components/ui/shadcn/shadcn-accordion.d.ts.map +1 -0
  123. package/dist/components/ui/shadcn/shadcn-alert-dialog.d.ts +19 -0
  124. package/dist/components/ui/shadcn/shadcn-alert-dialog.d.ts.map +1 -0
  125. package/dist/components/ui/shadcn/shadcn-avatar.d.ts +12 -0
  126. package/dist/components/ui/shadcn/shadcn-avatar.d.ts.map +1 -0
  127. package/dist/components/ui/shadcn/shadcn-combobox.d.ts +33 -0
  128. package/dist/components/ui/shadcn/shadcn-combobox.d.ts.map +1 -0
  129. package/dist/components/ui/shadcn/shadcn-dropdown-menu.d.ts +30 -0
  130. package/dist/components/ui/shadcn/shadcn-dropdown-menu.d.ts.map +1 -0
  131. package/dist/components/ui/shadcn/shadcn-empty.d.ts +12 -0
  132. package/dist/components/ui/shadcn/shadcn-empty.d.ts.map +1 -0
  133. package/dist/components/ui/shadcn/shadcn-pagination.d.ts +18 -0
  134. package/dist/components/ui/shadcn/shadcn-pagination.d.ts.map +1 -0
  135. package/dist/components/ui/shadcn/shadcn-select.d.ts +24 -0
  136. package/dist/components/ui/shadcn/shadcn-select.d.ts.map +1 -0
  137. package/dist/components/ui/shadcn/shadcn-tabs.d.ts +12 -0
  138. package/dist/components/ui/shadcn/shadcn-tabs.d.ts.map +1 -0
  139. package/dist/components/ui/shadcn/shadcn-tooltip.d.ts +11 -0
  140. package/dist/components/ui/shadcn/shadcn-tooltip.d.ts.map +1 -0
  141. package/dist/components/ui/sheet.d.ts +28 -0
  142. package/dist/components/ui/sheet.d.ts.map +1 -0
  143. package/dist/components/ui/sidebar.d.ts +70 -0
  144. package/dist/components/ui/sidebar.d.ts.map +1 -0
  145. package/dist/components/ui/skeleton.d.ts +3 -0
  146. package/dist/components/ui/skeleton.d.ts.map +1 -0
  147. package/dist/components/ui/slider.d.ts +22 -0
  148. package/dist/components/ui/slider.d.ts.map +1 -0
  149. package/dist/components/ui/sonner.d.ts +5 -0
  150. package/dist/components/ui/sonner.d.ts.map +1 -0
  151. package/dist/components/ui/spinner.d.ts +3 -0
  152. package/dist/components/ui/spinner.d.ts.map +1 -0
  153. package/dist/components/ui/switch.d.ts +12 -0
  154. package/dist/components/ui/switch.d.ts.map +1 -0
  155. package/dist/components/ui/table.d.ts +11 -0
  156. package/dist/components/ui/table.d.ts.map +1 -0
  157. package/dist/components/ui/tabs.d.ts +22 -0
  158. package/dist/components/ui/tabs.d.ts.map +1 -0
  159. package/dist/components/ui/textarea.d.ts +9 -0
  160. package/dist/components/ui/textarea.d.ts.map +1 -0
  161. package/dist/components/ui/toggle-group.d.ts +11 -0
  162. package/dist/components/ui/toggle-group.d.ts.map +1 -0
  163. package/dist/components/ui/toggle.d.ts +10 -0
  164. package/dist/components/ui/toggle.d.ts.map +1 -0
  165. package/dist/components/ui/tooltip.d.ts +15 -0
  166. package/dist/components/ui/tooltip.d.ts.map +1 -0
  167. package/dist/core.d.ts +2 -0
  168. package/dist/core.d.ts.map +1 -0
  169. package/dist/core.js +3 -0
  170. package/dist/es6-D-3xKXBT.js +24045 -0
  171. package/dist/extended.d.ts +2 -0
  172. package/dist/extended.d.ts.map +1 -0
  173. package/dist/extended.js +3 -0
  174. package/dist/hooks/use-mobile.d.ts +2 -0
  175. package/dist/hooks/use-mobile.d.ts.map +1 -0
  176. package/dist/icons.d.ts +2 -0
  177. package/dist/icons.d.ts.map +1 -0
  178. package/dist/icons.js +2 -0
  179. package/dist/index.d.ts +2 -0
  180. package/dist/index.d.ts.map +1 -0
  181. package/dist/index.js +2194 -0
  182. package/dist/input-group-DIfVGMYe.js +5196 -0
  183. package/dist/input-otp-DwLGFwVo.js +11879 -0
  184. package/dist/lib/brand-theme.d.ts +4 -0
  185. package/dist/lib/brand-theme.d.ts.map +1 -0
  186. package/dist/lib/document-dark-mode.d.ts +8 -0
  187. package/dist/lib/document-dark-mode.d.ts.map +1 -0
  188. package/dist/lib/opsfuse-portal-theme.d.ts +21 -0
  189. package/dist/lib/opsfuse-portal-theme.d.ts.map +1 -0
  190. package/dist/lib/theme-scope.d.ts +3 -0
  191. package/dist/lib/theme-scope.d.ts.map +1 -0
  192. package/dist/lib/utils.d.ts +3 -0
  193. package/dist/lib/utils.d.ts.map +1 -0
  194. package/dist/lucide-react-DLVJK_zM.js +38405 -0
  195. package/dist/public-api-core.d.ts +61 -0
  196. package/dist/public-api-core.d.ts.map +1 -0
  197. package/dist/public-api-extended.d.ts +9 -0
  198. package/dist/public-api-extended.d.ts.map +1 -0
  199. package/dist/public-api.d.ts +73 -0
  200. package/dist/public-api.d.ts.map +1 -0
  201. package/dist/recharts.d.ts +2 -0
  202. package/dist/recharts.d.ts.map +1 -0
  203. package/dist/recharts.js +2 -0
  204. package/dist/style.css +3 -0
  205. package/dist/style.layered.css +3 -0
  206. package/dist/toggle-group-D21Ul2kd.js +10171 -0
  207. package/package.json +113 -0
  208. package/scripts/postinstall.mjs +67 -0
  209. package/scripts/unwrap-css-layers.mjs +36 -0
@@ -0,0 +1,198 @@
1
+ ---
2
+ name: design-tokens
3
+ description: Generate a design tokens file (CSS variables or Tailwind config) based on a chosen aesthetic philosophy, with light and dark mode palettes, spacing scale, type ramp, and component-level tokens. Use when starting a new project, establishing a visual system, setting up tokens, or mentions "tokens" or "design system".
4
+ ---
5
+
6
+ This skill generates the foundational design tokens for a project. Run this after the design brief and before building any components. Every component built after this references these tokens instead of hardcoding values.
7
+
8
+ ## Example prompts
9
+
10
+ - "Set up design tokens for this project"
11
+ - "Generate a token system based on Dieter Rams"
12
+ - "I need a spacing scale and color palette before I start building"
13
+ - "Create tokens that match our brief"
14
+
15
+ ## Process
16
+
17
+ 1. **Check what already exists.** Before generating anything, scan the codebase for:
18
+ - CSS variable definitions (`:root`, `[data-theme]`, custom property files)
19
+ - Tailwind config (`tailwind.config.js`, `tailwind.config.ts`) and any theme extensions
20
+ - Theme provider files (Material UI `createTheme`, Chakra `extendTheme`, shadcn `globals.css`)
21
+ - Design token JSON files (Style Dictionary format, Figma token exports)
22
+ - Any `tokens.css`, `variables.css`, `theme.css`, or similarly named files
23
+ - `package.json` for UI framework dependencies (tailwindcss, @mui/material, @chakra-ui/react, etc.)
24
+
25
+ If tokens already exist, **extend them** rather than replacing. Identify gaps (missing dark mode, incomplete spacing scale, no motion tokens) and fill those.
26
+
27
+ 2. **Read the brief.** Look for a design brief at `.design/*/DESIGN_BRIEF.md`. If multiple subfolders exist, use the most recently modified one, or ask the user which feature they are working on. If a philosophy is named, use the parameters from `/frontend-design` to derive token values. If no brief exists, ask the user what direction they want.
28
+
29
+ 3. **Generate tokens** in the format that matches the project's tech stack:
30
+ - Tailwind project → extend `tailwind.config.js` and write to `globals.css`
31
+ - CSS/HTML project → write to a `tokens.css` file
32
+ - CSS-in-JS project → write to a `theme.ts` or `theme.js` file
33
+ - If unclear, default to CSS custom properties (most portable)
34
+
35
+ 4. **Always generate both light and dark mode palettes.** Use `[data-theme="dark"]` or `prefers-color-scheme` media query. Both palettes should feel intentional for the chosen philosophy, not just inverted values.
36
+
37
+ ## Token Categories
38
+
39
+ ### Color
40
+
41
+ ```css
42
+ /* Semantic color tokens, not raw values */
43
+ --color-bg-primary: /* Main background */
44
+ --color-bg-secondary: /* Secondary/card background */
45
+ --color-bg-tertiary: /* Subtle background (inputs, wells) */
46
+ --color-bg-inverse: /* Inverted background */
47
+
48
+ --color-text-primary: /* Main text */
49
+ --color-text-secondary: /* Subdued text */
50
+ --color-text-tertiary: /* Placeholder, disabled text */
51
+ --color-text-inverse: /* Text on inverse backgrounds */
52
+ --color-text-link: /* Link color */
53
+
54
+ --color-border-primary: /* Default borders */
55
+ --color-border-secondary: /* Subtle borders */
56
+ --color-border-focus: /* Focus ring color */
57
+
58
+ --color-accent-primary: /* Primary action color */
59
+ --color-accent-primary-hover:
60
+ --color-accent-primary-active:
61
+ --color-accent-secondary: /* Secondary action color */
62
+
63
+ --color-status-success:
64
+ --color-status-warning:
65
+ --color-status-error:
66
+ --color-status-info:
67
+
68
+ --color-surface-overlay: /* Modal/dropdown backdrop */
69
+ ```
70
+
71
+ **OpsFuse UI (this repo):** Prefer the shadcn-aligned variables defined in `src/brands.css` — e.g. `--background`, `--foreground`, `--card`, `--muted`, `--accent`, `--popover`, `--destructive`, `-*-foreground`, and semantic `-*-muted` / `-*-muted-foreground`. See the `opsfuse-color-theme` skill for the full ladder and usage rules.
72
+
73
+ ### Spacing
74
+
75
+ Generate a consistent scale. The base unit should match the philosophy:
76
+ - Tight philosophies (Brutalist, Swiss): 4px base
77
+ - Balanced philosophies (Rams, Scandinavian): 4px or 8px base
78
+ - Spacious philosophies (Japanese Minimalism, Editorial): 8px base with larger multipliers
79
+
80
+ ```css
81
+ --space-0: 0;
82
+ --space-1: /* base * 0.25 */
83
+ --space-2: /* base * 0.5 */
84
+ --space-3: /* base * 0.75 */
85
+ --space-4: /* base * 1 */
86
+ --space-5: /* base * 1.5 */
87
+ --space-6: /* base * 2 */
88
+ --space-7: /* base * 3 */
89
+ --space-8: /* base * 4 */
90
+ --space-9: /* base * 6 */
91
+ --space-10: /* base * 8 */
92
+ --space-11: /* base * 12 */
93
+ --space-12: /* base * 16 */
94
+ ```
95
+
96
+ ### Typography
97
+
98
+ ```css
99
+ --font-family-display: /* Headline/display font */
100
+ --font-family-body: /* Body text font */
101
+ --font-family-mono: /* Code/monospace font */
102
+
103
+ --font-size-xs:
104
+ --font-size-sm:
105
+ --font-size-base:
106
+ --font-size-md:
107
+ --font-size-lg:
108
+ --font-size-xl:
109
+ --font-size-2xl:
110
+ --font-size-3xl:
111
+ --font-size-4xl: /* Hero/display size */
112
+
113
+ --font-weight-normal:
114
+ --font-weight-medium:
115
+ --font-weight-semibold:
116
+ --font-weight-bold:
117
+
118
+ --line-height-tight: /* Headings: 1.1-1.3 */
119
+ --line-height-normal: /* Body: 1.4-1.6 */
120
+ --line-height-relaxed: /* Spacious body: 1.6-1.8 */
121
+
122
+ --letter-spacing-tight: /* Display type */
123
+ --letter-spacing-normal:
124
+ --letter-spacing-wide: /* All-caps, labels */
125
+ ```
126
+
127
+ ### Layout
128
+
129
+ ```css
130
+ --max-width-content: /* Max reading width (65-75ch equivalent) */
131
+ --max-width-wide: /* Wide content area */
132
+ --max-width-page: /* Full page max width */
133
+
134
+ --border-radius-sm:
135
+ --border-radius-md:
136
+ --border-radius-lg:
137
+ --border-radius-full: /* Pill/circle */
138
+
139
+ --shadow-sm:
140
+ --shadow-md:
141
+ --shadow-lg:
142
+ --shadow-focus: /* Focus ring shadow */
143
+ ```
144
+
145
+ ### Motion
146
+
147
+ ```css
148
+ --duration-instant: 50ms;
149
+ --duration-fast: 150ms;
150
+ --duration-normal: 250ms;
151
+ --duration-slow: 400ms;
152
+ --duration-slower: 600ms;
153
+
154
+ --easing-default: cubic-bezier(0.4, 0, 0.2, 1);
155
+ --easing-in: cubic-bezier(0.4, 0, 1, 1);
156
+ --easing-out: cubic-bezier(0, 0, 0.2, 1);
157
+ --easing-bounce: cubic-bezier(0.34, 1.56, 0.64, 1);
158
+ ```
159
+
160
+ ### Responsive Breakpoints
161
+
162
+ ```css
163
+ --breakpoint-sm: 375px; /* Mobile */
164
+ --breakpoint-md: 768px; /* Tablet */
165
+ --breakpoint-lg: 1024px; /* Small desktop */
166
+ --breakpoint-xl: 1280px; /* Desktop */
167
+ --breakpoint-2xl: 1536px; /* Wide desktop */
168
+ ```
169
+
170
+ ## Dark Mode
171
+
172
+ Always generate dark mode tokens alongside light mode. Rules:
173
+
174
+ - Do not simply invert colors. Dark backgrounds should be warm or cool depending on the philosophy.
175
+ - Reduce contrast slightly in dark mode (pure white text on pure black is harsh).
176
+ - Shadows should use darker, more transparent values in dark mode, not the same shadows as light.
177
+ - Accent colors may need lightness adjustments to maintain contrast ratios.
178
+ - Include a `prefers-color-scheme` media query AND a `[data-theme="dark"]` attribute selector so the user can support both system preference and manual toggle.
179
+
180
+ ```css
181
+ :root {
182
+ /* Light mode tokens */
183
+ }
184
+
185
+ [data-theme="dark"] {
186
+ /* Dark mode overrides */
187
+ }
188
+
189
+ @media (prefers-color-scheme: dark) {
190
+ :root:not([data-theme="light"]) {
191
+ /* System-preference dark mode, unless user explicitly chose light */
192
+ }
193
+ }
194
+ ```
195
+
196
+ ## Output
197
+
198
+ Save the tokens file in the appropriate location for the project's tech stack. State which philosophy the tokens are derived from and note any deviations or choices made.
@@ -0,0 +1,144 @@
1
+ ---
2
+ name: frontend-design
3
+ description: Build distinctive, production-grade frontend interfaces with high design quality, guided by named aesthetic philosophies. Use when building components, pages, or applications. Generates working code with exceptional attention to aesthetic details and creative choices that avoid generic AI output.
4
+ ---
5
+
6
+ This skill guides creation of distinctive, production-grade frontend interfaces. Implement real working code with exceptional attention to aesthetic detail.
7
+
8
+ ## Example prompts
9
+
10
+ - "Build the hero section from the brief"
11
+ - "Create a card component in a Scandinavian style"
12
+ - "I want this to feel like a Japanese magazine. Build the layout."
13
+ - "Build the settings page. Use whatever style fits."
14
+
15
+ ## Before You Write Any Code
16
+
17
+ 1. **Explore the existing codebase first.** Scan specifically for:
18
+ - **Component directories**: `components/`, `ui/`, `shared/` and list every component by name and its props/API
19
+ - **CSS variables / tokens**: files named `tokens.css`, `variables.css`, `theme.css`, or `:root` declarations with custom properties
20
+ - **Tailwind config**: `tailwind.config.js` or `tailwind.config.ts`, check `theme.extend` for custom values
21
+ - **UI framework themes**: Material UI `createTheme`, Chakra `extendTheme`, shadcn `globals.css` and `components.json`
22
+ - **Storybook**: `.storybook/` directory or `*.stories.*` files indicating documented components
23
+ - **Font loading**: Google Fonts links, `@font-face` declarations, font imports
24
+ - **Layout patterns**: how existing pages handle grid, containers, breakpoints, and spacing
25
+ - **Package.json UI dependencies**: tailwindcss, @mui/material, @chakra-ui/react, @radix-ui, lucide-react, framer-motion, etc.
26
+ - If components exist that match or partially match what you need to build, extend or compose them. Do not create duplicates.
27
+
28
+ 2. **Understand the context:**
29
+ - What problem does this interface solve? Who uses it?
30
+ - What is the intended emotional tone?
31
+ - What are the hard constraints (framework, devices, performance, accessibility)?
32
+
33
+ 3. **Commit to an aesthetic direction.** Either the user names one (see philosophies below) or you choose one that fits the context. State your choice and why before writing code.
34
+
35
+ ## Aesthetic Philosophies
36
+
37
+ When the user names a philosophy or describes a vibe, use these as concrete implementation guides. Each philosophy defines typography, color, layout, spacing, motion, and detail treatment.
38
+
39
+ ### Dieter Rams (Functionalist)
40
+ Less but better. Every element earns its place. Nothing decorative without function.
41
+ - **Typography**: Clean sans-serif (Helvetica Neue, Suisse Intl, Akkurat). Tight letterspacing on headings. Generous line height on body. One size scale, used strictly.
42
+ - **Color**: Restrained. Monochromatic with a single functional accent. White or light grey backgrounds. Color is information, not decoration.
43
+ - **Layout**: Strict grid. Clear functional hierarchy. Components aligned to a spatial system. No asymmetry for its own sake.
44
+ - **Spacing**: Consistent, mathematical scale (4px/8px base). Generous padding. Breathing room between elements.
45
+ - **Motion**: Minimal. Purposeful transitions only (state changes, reveals). No decorative animation.
46
+ - **Details**: Subtle borders and dividers over shadows. Precise alignment. Rounded corners used sparingly and consistently.
47
+
48
+ ### Swiss / International Typographic
49
+ Objectivity through structure. The grid is sacred. Content is king.
50
+ - **Typography**: Strong sans-serifs (Neue Haas Grotesk, Univers, Aktiv Grotesk). Dramatic scale contrast between headings and body. All-caps subheadings with generous letterspacing.
51
+ - **Color**: High contrast. Black, white, and one primary color. Bold color blocks as compositional elements.
52
+ - **Layout**: Rigid multi-column grid. Asymmetric balance. Text and image in dialogue. Alignment across elements is non-negotiable.
53
+ - **Spacing**: Defined by the grid module. Gutters are part of the design, not afterthought.
54
+ - **Motion**: Page transitions and scroll-triggered reveals that respect the grid. No playful bounce.
55
+ - **Details**: Rules (horizontal lines) as structural elements. No gradients. No shadows. Flatness is the point.
56
+
57
+ ### Japanese Minimalism (Ma)
58
+ Negative space is content. Restraint communicates sophistication. Quiet over loud.
59
+ - **Typography**: Thin-weight sans-serifs or elegant serifs (Noto Sans, Cormorant). Generous line height (1.8-2.0). Small body size with large whitespace margins.
60
+ - **Color**: Muted naturals (warm greys, stone, sage, washi). Subtle tonal shifts over hard contrasts. Near-monochrome.
61
+ - **Layout**: Asymmetric but balanced. Off-center content. Large empty areas are intentional. Content floats in space.
62
+ - **Spacing**: Extreme whitespace. Padding and margins 2-3x what feels "normal." Elements breathe.
63
+ - **Motion**: Slow, gentle fades (400-600ms). No bounce, no overshoot. Opacity transitions over position shifts.
64
+ - **Details**: Hairline borders. Subtle texture (paper grain, linen). No sharp shadows. Soft, diffused effects.
65
+
66
+ ### Brutalist / Raw
67
+ Structure is visible. No polish. Anti-aesthetic is the aesthetic.
68
+ - **Typography**: System fonts, monospace (JetBrains Mono, IBM Plex Mono, Courier), or aggressive display faces. Mixed sizes. Text as texture.
69
+ - **Color**: Black and white primary. If color, it is raw and clashing (construction yellow, hazard orange, terminal green). No gradients.
70
+ - **Layout**: Visible borders. Box model exposed. Stacked blocks. Deliberate roughness. Content first, beauty never.
71
+ - **Spacing**: Tight or intentionally uneven. Padding that feels compressed.
72
+ - **Motion**: None, or jarring (instant state changes, hard cuts). No easing.
73
+ - **Details**: Visible outlines. Default browser form elements can be intentional. Text-only interfaces. No icons unless functional.
74
+
75
+ ### Scandinavian
76
+ Warmth plus restraint. Functional beauty. Accessible by default.
77
+ - **Typography**: Rounded, friendly sans-serifs (Nunito, Poppins, Circular, Cera Pro). Medium weights. Comfortable reading sizes.
78
+ - **Color**: Natural palette. Warm whites, soft blues, muted greens, clay. Pastel accents. No pure black (use charcoal).
79
+ - **Layout**: Clean and open. Card-based. Rounded corners (8-12px). Comfortable, generous layouts.
80
+ - **Spacing**: Generous but not extreme. Everything feels approachable and uncluttered.
81
+ - **Motion**: Gentle, natural easing. Subtle hover lifts. Content that settles into place.
82
+ - **Details**: Soft shadows (large blur, low opacity). Rounded elements. Warm undertones in greys. Illustration-friendly.
83
+
84
+ ### Art Deco / Geometric
85
+ Bold symmetry. Decorative precision. Statement and luxury.
86
+ - **Typography**: Geometric display faces (Futura, Poiret One, Josefin Sans). All-caps headlines with extreme letterspacing. Serif body text for contrast.
87
+ - **Color**: Rich and deep. Gold/champagne, emerald, navy, burgundy, black. Metallic accents (gold gradients, shimmer effects).
88
+ - **Layout**: Symmetrical and centered. Strong vertical axis. Decorative frames and borders. Layered depth.
89
+ - **Spacing**: Structured and formal. Padding is architectural.
90
+ - **Motion**: Elegant reveals. Staggered entrance animations. Parallax depth.
91
+ - **Details**: Geometric patterns (chevrons, sunbursts, fan shapes). Ornamental borders. Texture (marble, brushed metal). Statement typography at hero scale.
92
+
93
+ ### Neo-Memphis
94
+ Playful chaos. Anti-corporate. Shapes as characters.
95
+ - **Typography**: Mix of weights and styles. Clashing fonts is intentional. Oversized headlines. Text at angles.
96
+ - **Color**: Bold primaries and neons. Clashing combinations (pink and yellow, blue and orange). No muted tones. Flat color, no gradients.
97
+ - **Layout**: Broken grid. Overlapping elements. Shapes (circles, triangles, squiggles) as compositional elements. Asymmetric on purpose.
98
+ - **Spacing**: Dense in some areas, empty in others. Rhythm is irregular.
99
+ - **Motion**: Bouncy, playful. Exaggerated hover effects. Elements that wiggle, rotate, or pop.
100
+ - **Details**: Thick borders. Geometric shapes as decoration. Patterns (dots, dashes, zigzags). Drop shadows with hard edges and bright colors.
101
+
102
+ ### Editorial / Magazine
103
+ Content-led design. Typography does the heavy lifting. Every page is a spread.
104
+ - **Typography**: Display serif for headlines (Playfair Display, Fraunces, Instrument Serif). Clean sans for body (DM Sans, Source Sans). Dramatic scale (hero headlines at 72-120px). Pull quotes. Drop caps.
105
+ - **Color**: Minimal. Black and white with one accent. Color used editorially (to highlight, not decorate).
106
+ - **Layout**: Strong column grid (3-5 columns). Full-bleed images. Text wrapping. Mixed column widths. Vertical rhythm.
107
+ - **Spacing**: Generous margins. Tight leading on headlines, open on body. Whitespace as a compositional tool.
108
+ - **Motion**: Scroll-triggered reveals. Parallax on images. Smooth page transitions.
109
+ - **Details**: Thin rules as dividers. Caption typography. Issue/date metadata. Print-inspired details (folio numbers, running headers).
110
+
111
+ ## Implementation Guidelines
112
+
113
+ - **Typography**: Choose distinctive fonts loaded via Google Fonts or CDN. Avoid generic defaults (Inter, Roboto, Arial, system fonts). Pair a display font with a body font.
114
+ - **Color**: Use CSS variables for consistency. Dominant color with sharp accents outperforms safe, evenly-distributed palettes.
115
+ - **Motion**: CSS transitions for HTML. Framer Motion / Motion library for React. Focus on high-impact moments (page load reveals, state changes) over scattered micro-interactions.
116
+ - **Spatial composition**: Unexpected layouts earn attention. Asymmetry, overlap, diagonal flow, grid-breaking elements. Or, if the philosophy demands it, strict grids executed with precision.
117
+ - **Backgrounds and depth**: Create atmosphere. Gradient meshes, noise textures, geometric patterns, layered transparencies, grain overlays. Match the chosen philosophy.
118
+
119
+ NEVER produce generic AI aesthetics: purple gradients on white, Inter font, predictable card grids, cookie-cutter component layouts. Every output should feel designed for its specific context.
120
+
121
+ Match implementation complexity to the aesthetic vision. A Dieter Rams interface is 50 lines of precise CSS. A Neo-Memphis interface is 300 lines of creative chaos. Both are correct.
122
+
123
+ ## Mobile-First
124
+
125
+ Build mobile layout first, then scale up. This is non-negotiable.
126
+
127
+ - Start with a single-column layout at 375px width.
128
+ - Add complexity at each breakpoint (`min-width` media queries, not `max-width`).
129
+ - Touch targets must be at least 44x44px on mobile.
130
+ - Body text must be at least 16px on mobile (prevents iOS zoom on input focus).
131
+ - Navigation must have a mobile-specific pattern (hamburger, bottom tabs, or drawer). Do not rely on horizontal nav bars that overflow.
132
+ - Test that line lengths stay comfortable (45-75 characters) at every breakpoint.
133
+
134
+ ## Dark Mode
135
+
136
+ If a design tokens file exists (from `/design-tokens`), use its dark mode palette. If not, generate dark mode support alongside the light theme.
137
+
138
+ - Use CSS custom properties so switching themes means changing variable values, not rewriting components.
139
+ - Support both `prefers-color-scheme` media query (system preference) and a `[data-theme="dark"]` attribute (manual toggle).
140
+ - Do not simply invert colors. Dark backgrounds should be warm or cool to match the philosophy (warm charcoal for Scandinavian, cool slate for Swiss, near-black for Brutalist).
141
+ - Reduce pure white text to off-white (e.g., `#E5E5E5` or `rgba(255,255,255,0.87)`) to reduce eye strain.
142
+ - Shadows in dark mode should be darker and more transparent, not the same values as light mode.
143
+ - Accent colors may need lightness adjustments to maintain WCAG contrast ratios against dark backgrounds.
144
+ - Include a `prefers-reduced-motion` media query for users who need it. Disable or simplify all animations and transitions within that query.
@@ -0,0 +1,21 @@
1
+ ---
2
+ name: grill-me
3
+ description: Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, challenge an approach, or mentions "grill me".
4
+ ---
5
+
6
+ ## Example prompts
7
+
8
+ - "Grill me on this landing page idea"
9
+ - "I want to build a dashboard for tracking team metrics. Challenge my thinking."
10
+ - "Stress-test my approach to this settings page"
11
+ - "I have a rough idea for a portfolio site. Help me think it through."
12
+
13
+ ## Instructions
14
+
15
+ Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one by one.
16
+
17
+ If a question can be answered by exploring the codebase, explore the codebase instead of asking me.
18
+
19
+ If a question can be answered by examining existing components, styles, or design tokens in the project, examine them instead of asking me.
20
+
21
+ For each question, provide your recommended answer.
@@ -0,0 +1,111 @@
1
+ ---
2
+ name: information-architecture
3
+ description: Define the structural layer of a product or site before visual design begins. Covers navigation, content hierarchy, page structure, URL patterns, and user flows. Use when user wants to plan site structure, define navigation, map user flows, organize content, or mentions "IA" or "information architecture".
4
+ ---
5
+
6
+ This skill defines the structural skeleton of a product or site. It sits between the design brief and the build. Run this after the brief is written and before tasks are created.
7
+
8
+ ## Example prompts
9
+
10
+ - "Plan the IA for this app before I start building"
11
+ - "Map out the navigation and page structure"
12
+ - "I need to organize the content for a documentation site"
13
+ - "Define user flows for the onboarding experience"
14
+
15
+ ## Process
16
+
17
+ 1. Look for an existing design brief at `.design/*/DESIGN_BRIEF.md`. If multiple subfolders exist, use the most recently modified one, or ask the user which feature they are working on. If no brief exists, ask the user what they are building and for whom.
18
+
19
+ 2. Explore the existing codebase to understand what structure already exists:
20
+ - **Routing**: Next.js `app/` or `pages/` directory, React Router config, Vue Router, SvelteKit routes, or static HTML page files
21
+ - **Navigation components**: header, sidebar, navbar, breadcrumb, footer components
22
+ - **Layout components**: root layouts, nested layouts, page wrappers, container components
23
+ - **Page directories**: how pages are currently organized in the file system
24
+ - **URL patterns**: existing slugs, dynamic segments, query parameter conventions
25
+ - **CMS or data layer**: content models, API routes, data fetching patterns, MDX/content directories
26
+ - If structure exists, this skill extends and improves it. Do not propose a new architecture that ignores what is already built.
27
+
28
+ 3. Interview the user about structural decisions. For each question, provide your recommended answer.
29
+
30
+ Cover at minimum:
31
+ - What are the primary things a user needs to find or do? Rank by frequency.
32
+ - How many levels of navigation depth are acceptable?
33
+ - What content will grow over time vs. what is fixed?
34
+ - Are there distinct user types who need different entry points?
35
+ - What is the one page/view where the user spends 80% of their time?
36
+
37
+ 4. Once you have a shared understanding, produce the IA document using the template below and save it as `INFORMATION_ARCHITECTURE.md` in the same `.design/<feature-slug>/` subfolder as the design brief.
38
+
39
+ ## IA Document Template
40
+
41
+ ```markdown
42
+ # Information Architecture: [Product/Site Name]
43
+
44
+ ## Site Map
45
+
46
+ A hierarchical map of every page or view. Use indentation to show nesting. Include the URL pattern for each.
47
+
48
+ - Home `/`
49
+ - Feature A `/feature-a`
50
+ - Sub-page `/feature-a/detail`
51
+ - Feature B `/feature-b`
52
+ - Settings `/settings`
53
+ - Profile `/settings/profile`
54
+
55
+ ## Navigation Model
56
+
57
+ Describe the navigation system:
58
+ - **Primary navigation**: What appears in the main nav? Maximum items.
59
+ - **Secondary navigation**: Sidebar, tabs, or contextual links within sections.
60
+ - **Utility navigation**: Account, settings, help, and anything outside the main content hierarchy.
61
+ - **Mobile navigation**: How navigation adapts. Hamburger, bottom tabs, or something else.
62
+
63
+ ## Content Hierarchy
64
+
65
+ For each major page or view, define the content priority:
66
+
67
+ ### [Page Name]
68
+ 1. [Highest priority content] -- Why this comes first
69
+ 2. [Second priority] -- Why this comes second
70
+ 3. [Third priority] -- Rationale
71
+ 4. [Below the fold / secondary]
72
+
73
+ ## User Flows
74
+
75
+ The critical paths through the product. Each flow is a sequence of steps with decision points noted.
76
+
77
+ ### [Flow Name] (e.g., "New user onboarding" or "Create a project")
78
+ 1. User lands on [page]
79
+ 2. User sees [content/prompt]
80
+ 3. User takes action: [action]
81
+ - If [condition A] -> [outcome]
82
+ - If [condition B] -> [outcome]
83
+ 4. User arrives at [destination]
84
+
85
+ ## Naming Conventions
86
+
87
+ A glossary of terms used in the interface. Consistency matters. Pick one word and use it everywhere.
88
+
89
+ | Concept | Label in UI | Notes |
90
+ |---------|-------------|-------|
91
+ | [thing] | [what we call it] | [why this word] |
92
+
93
+ ## Component Reuse Map
94
+
95
+ Which structural components (layouts, containers, navigation elements) are shared across pages.
96
+
97
+ | Component | Used on | Behavior differences |
98
+ |-----------|---------|---------------------|
99
+ | [layout/component] | [pages] | [any variations] |
100
+
101
+ ## Content Growth Plan
102
+
103
+ Which sections of the site will accumulate content over time and how the IA accommodates that growth (pagination, filtering, search, archive patterns).
104
+
105
+ ## URL Strategy
106
+
107
+ Rules for URL construction:
108
+ - Pattern: [e.g., `/section/subsection/item-slug`]
109
+ - Dynamic segments: [what is parameterized]
110
+ - Query parameters: [filtering, sorting, pagination]
111
+ ```