UI/UX CraftKit — Design Intelligence
Comprehensive design guide for web and mobile applications. Contains 50+ styles, 161 color palettes, 57 font pairings, 161 product types with reasoning rules, 99 UX guidelines, and 25 chart types across 10 technology stacks. Searchable database with priority-based recommendations.
Open source on GitHub: github.com/hardikamal/ui-ux-craft-kit
Search Command
python3 <skill_dir>/scripts/search.py "<query>" --domain <domain> [-n <max_results>]
Replace <skill_dir> with the absolute path to this skill directory.
Domains:
product — Product type recommendations (SaaS, e-commerce, portfolio)
style — UI styles (glassmorphism, minimalism, brutalism) + AI prompts
typography — Font pairings with Google Fonts imports
color — Color palettes by product type
landing — Page structure and CTA strategies
chart — Chart types and library recommendations
ux — Best practices and anti-patterns
icons — Icon library recommendations
react — React/Next.js performance guidelines
web — Web accessibility and interface patterns
google-fonts — Google Fonts search
Stack-specific search:
python3 <skill_dir>/scripts/search.py "<query>" --stack react-native
Design system generation:
python3 <skill_dir>/scripts/search.py "<query>" --design-system [-p "Project Name"]
When to Apply
Use this skill when the task involves UI structure, visual design decisions, interaction patterns, or user experience quality control.
Must Use
- Designing new pages (Landing Page, Dashboard, Admin, SaaS, Mobile App)
- Creating or refactoring UI components (buttons, modals, forms, tables, charts)
- Choosing color schemes, typography systems, spacing standards, or layout systems
- Reviewing UI code for accessibility or visual consistency
- Implementing navigation structures, animations, or responsive behavior
- Making product-level design decisions (style, information hierarchy, brand)
- Improving perceived quality, clarity, or usability of interfaces
Skip
- Pure backend logic development
- API or database design only
- Performance optimization unrelated to the interface
- Infrastructure or DevOps work
Rule: If the task changes how a feature looks, feels, moves, or is interacted with → use this skill.
How to Use (Step by Step)
Step 1: Identify the Task Domain
Run a search to get relevant design context before generating UI code:
# Get style recommendations for a product type
python3 <skill_dir>/scripts/search.py "SaaS dashboard" --domain product
# Get color palette
python3 <skill_dir>/scripts/search.py "fintech app" --domain color
# Get font pairing
python3 <skill_dir>/scripts/search.py "modern minimal" --domain typography
# Generate a full design system
python3 <skill_dir>/scripts/search.py "fitness tracking app" --design-system -p "FitTrack"
Step 2: Apply Results
Use the search results to inform your design decisions. The search returns prioritized, ranked results from the database.
Step 3: Quality Check Against Priority Rules
| Priority |
Category |
Key Checks |
| 1 |
Accessibility |
Contrast 4.5:1, Alt text, Keyboard nav, Aria-labels |
| 2 |
Touch & Interaction |
Min 44×44px targets, Loading feedback |
| 3 |
Performance |
WebP/AVIF, Lazy loading, CLS < 0.1 |
| 4 |
Style Selection |
Match product type, Consistency, SVG icons |
| 5 |
Layout & Responsive |
Mobile-first, No horizontal scroll |
| 6 |
Typography & Color |
Base 16px, Line-height 1.5, Semantic tokens |
| 7 |
Animation |
150–300ms duration, transform/opacity only |
| 8 |
Forms & Feedback |
Visible labels, Error near field |
| 9 |
Navigation |
Predictable back, Bottom nav ≤5 items |
| 10 |
Charts & Data |
Legends, Tooltips, Accessible colors |
Quick Reference
Accessibility (CRITICAL)
- Minimum 4.5:1 contrast ratio for normal text
- Visible focus rings on all interactive elements
- Descriptive alt text for meaningful images
- aria-labels for icon-only buttons
- Tab order matches visual order
- Support
prefers-reduced-motion
Touch & Interaction (CRITICAL)
- Min 44×44pt (Apple) / 48×48dp (Material) touch targets
- Minimum 8px gap between touch targets
- Use click/tap for primary interactions, not hover-only
- Disable button + show spinner during async operations
- Add
cursor-pointer to clickable elements
Performance (HIGH)
- Use WebP/AVIF + responsive
srcset
- Declare
width/height to prevent CLS
font-display: swap to avoid FOIT
- Lazy load below-fold images
- Virtualize lists with 50+ items
Style Selection (HIGH)
- Match style to product type (run
--domain product)
- Use SVG icons (Heroicons, Lucide) — never emoji as icons
- One icon set/visual language across the product
- Each screen has only one primary CTA
Layout & Responsive (HIGH)
width=device-width, initial-scale=1 viewport meta
- Design mobile-first: 375 → 768 → 1024 → 1440
- No horizontal scroll on mobile
- Use 4pt/8dp spacing scale
min-h-dvh instead of 100vh on mobile
Typography & Color (MEDIUM)
- Minimum 16px body text (avoids iOS auto-zoom)
- Line height 1.5–1.75 for body text
- 65–75 chars per line on desktop
- Use semantic color tokens, not raw hex in components
- Bold headings (600–700), Regular body (400), Medium labels (500)
Animation (MEDIUM)
- 150–300ms for micro-interactions
- Use
transform/opacity only — never animate width/height
- Respect
prefers-reduced-motion
- Exit animations 60–70% of enter duration
- Every animation must convey meaning, not just decoration
Forms & Feedback (MEDIUM)
- Visible label per input (not placeholder-only)
- Show error below the related field
- Validate on blur, not keystroke
- Confirm before destructive actions
- Auto-dismiss toasts in 3–5s
Navigation (HIGH)
- Bottom nav max 5 items with labels
- Back navigation must be predictable
- All key screens reachable via deep link
- State preservation when navigating back
Charts & Data (LOW)
- Match chart type to data type (trend → line, comparison → bar)
- Always show legend near chart
- Provide tooltips on hover/tap
- Use accessible color palettes (not red/green only)
1---
2name: ui-ux-craft-kit
3description: "UI/UX design intelligence for web and mobile. Includes 50+ styles, 161 color palettes, 57 font pairings, 161 product types, 99 UX guidelines, and 25 chart types across 10 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui, and HTML/CSS). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, and check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, and mobile app. Elements: button, modal, navbar, sidebar, card, table, form, and chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, and flat design. Topics: color systems, accessibility, animation, layout, typography, font pairing, spacing, interaction states, shadow, and gradient."
4metadata:
5 source: https://skillmd.com/skills/aaaaqwq/ui-ux-craft-kit
6---
7
8# UI/UX CraftKit — Design Intelligence
9
10Comprehensive design guide for web and mobile applications. Contains 50+ styles, 161 color palettes, 57 font pairings, 161 product types with reasoning rules, 99 UX guidelines, and 25 chart types across 10 technology stacks. Searchable database with priority-based recommendations.
11
12Open source on GitHub: [github.com/hardikamal/ui-ux-craft-kit](https://github.com/hardikamal/ui-ux-craft-kit)
13
14## Search Command
15
16```bash
17python3 <skill_dir>/scripts/search.py "<query>" --domain <domain> [-n <max_results>]
18```
19
20Replace `<skill_dir>` with the absolute path to this skill directory.
21
22**Domains:**
23- `product` — Product type recommendations (SaaS, e-commerce, portfolio)
24- `style` — UI styles (glassmorphism, minimalism, brutalism) + AI prompts
25- `typography` — Font pairings with Google Fonts imports
26- `color` — Color palettes by product type
27- `landing` — Page structure and CTA strategies
28- `chart` — Chart types and library recommendations
29- `ux` — Best practices and anti-patterns
30- `icons` — Icon library recommendations
31- `react` — React/Next.js performance guidelines
32- `web` — Web accessibility and interface patterns
33- `google-fonts` — Google Fonts search
34
35**Stack-specific search:**
36```bash
37python3 <skill_dir>/scripts/search.py "<query>" --stack react-native
38```
39
40**Design system generation:**
41```bash
42python3 <skill_dir>/scripts/search.py "<query>" --design-system [-p "Project Name"]
43```
44
45## When to Apply
46
47Use this skill when the task involves **UI structure, visual design decisions, interaction patterns, or user experience quality control**.
48
49### Must Use
50
51- Designing new pages (Landing Page, Dashboard, Admin, SaaS, Mobile App)
52- Creating or refactoring UI components (buttons, modals, forms, tables, charts)
53- Choosing color schemes, typography systems, spacing standards, or layout systems
54- Reviewing UI code for accessibility or visual consistency
55- Implementing navigation structures, animations, or responsive behavior
56- Making product-level design decisions (style, information hierarchy, brand)
57- Improving perceived quality, clarity, or usability of interfaces
58
59### Skip
60
61- Pure backend logic development
62- API or database design only
63- Performance optimization unrelated to the interface
64- Infrastructure or DevOps work
65
66**Rule**: If the task changes how a feature **looks, feels, moves, or is interacted with** → use this skill.
67
68## How to Use (Step by Step)
69
70### Step 1: Identify the Task Domain
71Run a search to get relevant design context before generating UI code:
72
73```bash
74# Get style recommendations for a product type
75python3 <skill_dir>/scripts/search.py "SaaS dashboard" --domain product
76
77# Get color palette
78python3 <skill_dir>/scripts/search.py "fintech app" --domain color
79
80# Get font pairing
81python3 <skill_dir>/scripts/search.py "modern minimal" --domain typography
82
83# Generate a full design system
84python3 <skill_dir>/scripts/search.py "fitness tracking app" --design-system -p "FitTrack"
85```
86
87### Step 2: Apply Results
88Use the search results to inform your design decisions. The search returns prioritized, ranked results from the database.
89
90### Step 3: Quality Check Against Priority Rules
91
92| Priority | Category | Key Checks |
93|----------|----------|------------|
94| 1 | Accessibility | Contrast 4.5:1, Alt text, Keyboard nav, Aria-labels |
95| 2 | Touch & Interaction | Min 44×44px targets, Loading feedback |
96| 3 | Performance | WebP/AVIF, Lazy loading, CLS < 0.1 |
97| 4 | Style Selection | Match product type, Consistency, SVG icons |
98| 5 | Layout & Responsive | Mobile-first, No horizontal scroll |
99| 6 | Typography & Color | Base 16px, Line-height 1.5, Semantic tokens |
100| 7 | Animation | 150–300ms duration, transform/opacity only |
101| 8 | Forms & Feedback | Visible labels, Error near field |
102| 9 | Navigation | Predictable back, Bottom nav ≤5 items |
103| 10 | Charts & Data | Legends, Tooltips, Accessible colors |
104
105## Quick Reference
106
107### Accessibility (CRITICAL)
108- Minimum 4.5:1 contrast ratio for normal text
109- Visible focus rings on all interactive elements
110- Descriptive alt text for meaningful images
111- aria-labels for icon-only buttons
112- Tab order matches visual order
113- Support `prefers-reduced-motion`
114
115### Touch & Interaction (CRITICAL)
116- Min 44×44pt (Apple) / 48×48dp (Material) touch targets
117- Minimum 8px gap between touch targets
118- Use click/tap for primary interactions, not hover-only
119- Disable button + show spinner during async operations
120- Add `cursor-pointer` to clickable elements
121
122### Performance (HIGH)
123- Use WebP/AVIF + responsive `srcset`
124- Declare `width`/`height` to prevent CLS
125- `font-display: swap` to avoid FOIT
126- Lazy load below-fold images
127- Virtualize lists with 50+ items
128
129### Style Selection (HIGH)
130- Match style to product type (run `--domain product`)
131- Use SVG icons (Heroicons, Lucide) — never emoji as icons
132- One icon set/visual language across the product
133- Each screen has only one primary CTA
134
135### Layout & Responsive (HIGH)
136- `width=device-width, initial-scale=1` viewport meta
137- Design mobile-first: 375 → 768 → 1024 → 1440
138- No horizontal scroll on mobile
139- Use 4pt/8dp spacing scale
140- `min-h-dvh` instead of `100vh` on mobile
141
142### Typography & Color (MEDIUM)
143- Minimum 16px body text (avoids iOS auto-zoom)
144- Line height 1.5–1.75 for body text
145- 65–75 chars per line on desktop
146- Use semantic color tokens, not raw hex in components
147- Bold headings (600–700), Regular body (400), Medium labels (500)
148
149### Animation (MEDIUM)
150- 150–300ms for micro-interactions
151- Use `transform`/`opacity` only — never animate `width`/`height`
152- Respect `prefers-reduced-motion`
153- Exit animations 60–70% of enter duration
154- Every animation must convey meaning, not just decoration
155
156### Forms & Feedback (MEDIUM)
157- Visible label per input (not placeholder-only)
158- Show error below the related field
159- Validate on blur, not keystroke
160- Confirm before destructive actions
161- Auto-dismiss toasts in 3–5s
162
163### Navigation (HIGH)
164- Bottom nav max 5 items with labels
165- Back navigation must be predictable
166- All key screens reachable via deep link
167- State preservation when navigating back
168
169### Charts & Data (LOW)
170- Match chart type to data type (trend → line, comparison → bar)
171- Always show legend near chart
172- Provide tooltips on hover/tap
173- Use accessible color palettes (not red/green only)