Design Fundamentals
Purpose
Create distinctive, beautiful UIs through intentional aesthetic choices backed by solid technical foundation.
Design Thinking
Choose Aesthetic Direction
Before coding, commit to clear aesthetic tone:
Minimal/Refined:
- Generous whitespace, restrained color palette
- Elegant serif or geometric sans-serif fonts
- Subtle interactions, high contrast
Bold/Vibrant:
- Saturated colors, strong contrasts
- Display fonts with personality
- Energetic interactions, dynamic layouts
Playful/Friendly:
- Rounded shapes, warm color palette
- Approachable fonts, comfortable spacing
- Delightful micro-interactions
Retro/Nostalgic:
- Period-specific typography
- Vintage color schemes, textured backgrounds
Organic/Natural:
- Earthy tones, soft shapes, flowing layouts
- Natural imagery, gentle transitions
Principle: Intentionality > intensity. Commit fully to chosen direction.
Avoid Generic AI Aesthetics
Never use these clichés:
❌ Purple gradients on white backgrounds
❌ System fonts everywhere (Inter, Roboto, Arial)
❌ Predictable 12-column grid layouts
❌ Safe, evenly-distributed color palettes
❌ Cookie-cutter card layouts
❌ Rounded corners on everything
Instead, be distinctive:
✅ Choose beautiful, characterful fonts
✅ Commit to bold colors OR refined neutrals
✅ Create unexpected layouts (asymmetry, overlap, diagonal flow)
✅ Use dominant colors with sharp accents
✅ Add visual details (textures, gradients, patterns, depth)
✅ Break the grid intentionally
Technical Foundation
Spacing System
Principle: Consistent scale creates visual rhythm and professionalism.
Choose ONE base unit and multiply:
- Smaller base (4): Finer control, granular spacing
- Larger base (8): Simpler system, bolder spacing
Build your scale:
- Start with base unit (4, 6, 8, or whatever fits)
- Create scale: base × 1, 2, 3, 4, 6, 8, 12, 16, 24
- Stick to scale values (avoid arbitrary in-between values)
Guidelines:
- Tighter spacing for related items
- Generous spacing separates major sections
- Whitespace = breathing room and importance
- Choose scale matching your aesthetic
Typography
Creative Direction:
- Choose distinctive, characterful fonts (not system fonts)
- Pair display font (headings) with refined body font
- Font conveys personality: geometric = modern, serif = elegant, rounded = friendly
- Avoid overused fonts: Inter, Roboto, Arial, Helvetica
Technical Specs:
- Body text: Readable size (typically 16px+, adjust based on font)
- Line height: 1.5-1.6 for body, 1.2-1.3 for headings
- Line length: 50-75 characters optimal
- Type scale: Choose ratio for consistent hierarchy
- Subtle/refined: Smaller ratio (1.2)
- Balanced: Medium ratio (1.25)
- Bold/dramatic: Larger ratio (1.333+)
Font Weights:
- Regular (400): Body text
- Semibold (600): Emphasis, subheadings
- Bold (700): Headings, strong emphasis
- Limit to 3-4 weights maximum
Hierarchy Levels:
- Primary: Page titles, main CTAs
- Secondary: Section headings, important actions
- Tertiary: Body text, labels
- Quaternary: Metadata, captions, helper text
Color System
Creative Direction:
- Commit to aesthetic: bold OR refined (not timid middle)
- Use dominant colors with sharp accents
- Color conveys mood: warm (energy), cool (calm), muted (sophistication)
- Consider color psychology for brand personality
Technical Specs:
- Primary: Main brand color for CTAs, key actions (1 color)
- Neutrals: Text, borders, backgrounds (5-7 shades from light to dark)
- Semantic: Success (green), error (red), warning (yellow), info (blue)
- Limit: 3-4 brand colors maximum
Contrast Requirements (WCAG AA - required for accessibility):
- Normal text: 4.5:1 minimum
- Large text: 3:1 minimum
- UI components: 3:1 minimum
- Use contrast checker tools to verify
Guidelines:
- Test all text/background combinations
- Don't rely on color alone (add icons, labels, patterns)
- Each color needs light/dark variants
Visual Hierarchy
Principle: Guide attention through size, weight, contrast, and spacing.
Create clear levels:
- Use size differences (headings larger than body)
- Use weight differences (bold for emphasis)
- Use spacing (more space = more importance)
- Use color sparingly for hierarchy
Hierarchy Techniques:
- Size: Primary elements significantly larger (2-3x+ size difference)
- Proximity: Group related items close, separate groups with generous space
- Contrast: Important elements use stronger contrast
- Alignment: Consistent alignment creates order
Spatial Composition
Layout Patterns
Create interest through:
- Asymmetry: Break symmetry for dynamic feel
- Overlap: Layer elements for depth
- Diagonal flow: Guide eye with angled layouts
- Whitespace: Generous negative space OR controlled density (intentional)
- Grid breaking: Intentionally break grid for emphasis
Alignment:
- Left-align text for readability (LTR languages)
- Center-align sparingly (titles, empty states)
- Right-align numbers in tables
- Be consistent within sections
Visual Details
Add Depth and Atmosphere
Backgrounds:
- Gradient meshes (soft, blended colors)
- Noise textures (subtle grain, paper texture)
- Geometric patterns (shapes, grids, dots)
- Layered transparencies (depth through layers)
Details:
- Shadows for elevation (subtle for cards, stronger for modals)
- Borders for definition (thin, subtle color difference)
- Subtle animations (hover states, quick transitions)
Common Mistakes
❌ Avoid:
- Generic AI aesthetics (purple gradients, system fonts)
- No aesthetic direction (mixing styles randomly)
- Arbitrary spacing (values outside your scale)
- Poor contrast (insufficient difference)
- Too many colors (overwhelming palette)
- Inconsistent font sizes (random values, no scale)
- No visual hierarchy (everything same size)
- Cramped layouts (insufficient whitespace)
✅ Do:
- Choose clear aesthetic and commit
- Use distinctive fonts with personality
- Follow spacing scale consistently
- Test contrast ratios (4.5:1 minimum)
- Limit to 3-4 brand colors
- Use type scale for predictable hierarchy
- Create clear levels (primary > secondary > tertiary)
- Give content generous whitespace
Validation Checklist
Creative:
Technical:
Key Takeaway
Distinctive + Correct = Beautiful UI
Technical correctness (spacing, contrast, hierarchy) ensures usability and professionalism.
Creative direction (aesthetic, fonts, colors, layouts) ensures memorability and distinctiveness.
Great design requires both: intentional aesthetic choices executed with technical precision.
Focus on intentionality - commit fully to chosen direction, then execute with consistency.
Avoid generic AI aesthetics through bold or refined choices, never timid middle ground.
1---2name: design-fundamentals3description: Core design principles for creating distinctive, beautiful UIs with technical excellence. Combines creative direction with practical foundation for memorable, accessible interfaces. Use when building UI without specific design specs (Figma, screenshots, design files): - Creating landing pages, home pages, marketing pages from scratch - Building web apps, dashboards, admin panels without design - Choosing design system: typography, colors, spacing, visual hierarchy - Need to propose complete design (fonts, colors, layout, spacing) - Building distinctive UIs that avoid generic AI aesthetics Keywords: landing page, design system, typography, colors, spacing, visual hierarchy Two-part approach: 1. Creative Direction: Choose aesthetic tone (minimal, bold, elegant, playful) 2. Technical Foundation: Spacing scales, typography specs, WCAG contrast, hierarchy Goal: Create UIs that are BOTH beautiful (distinctive, memorable) AND correct (accessible, consistent, professional).4---5
6# Design Fundamentals
7
8## Purpose
9Create distinctive, beautiful UIs through intentional aesthetic choices backed by solid technical foundation.
10
11---
12
13## Design Thinking
14
15### Choose Aesthetic Direction
16
17**Before coding, commit to clear aesthetic tone:**
18
19**Minimal/Refined:**
20- Generous whitespace, restrained color palette
21- Elegant serif or geometric sans-serif fonts
22- Subtle interactions, high contrast
23
24**Bold/Vibrant:**
25- Saturated colors, strong contrasts
26- Display fonts with personality
27- Energetic interactions, dynamic layouts
28
29**Playful/Friendly:**
30- Rounded shapes, warm color palette
31- Approachable fonts, comfortable spacing
32- Delightful micro-interactions
33
34**Retro/Nostalgic:**
35- Period-specific typography
36- Vintage color schemes, textured backgrounds
37
38**Organic/Natural:**
39- Earthy tones, soft shapes, flowing layouts
40- Natural imagery, gentle transitions
41
42**Principle:** Intentionality > intensity. Commit fully to chosen direction.
43
44---
45
46### Avoid Generic AI Aesthetics
47
48**Never use these clichés:**
49
50❌ Purple gradients on white backgrounds
51❌ System fonts everywhere (Inter, Roboto, Arial)
52❌ Predictable 12-column grid layouts
53❌ Safe, evenly-distributed color palettes
54❌ Cookie-cutter card layouts
55❌ Rounded corners on everything
56
57**Instead, be distinctive:**
58
59✅ Choose beautiful, characterful fonts
60✅ Commit to bold colors OR refined neutrals
61✅ Create unexpected layouts (asymmetry, overlap, diagonal flow)
62✅ Use dominant colors with sharp accents
63✅ Add visual details (textures, gradients, patterns, depth)
64✅ Break the grid intentionally
65
66---
67
68## Technical Foundation
69
70### Spacing System
71
72**Principle:** Consistent scale creates visual rhythm and professionalism.
73
74**Choose ONE base unit and multiply:**
75- Smaller base (4): Finer control, granular spacing
76- Larger base (8): Simpler system, bolder spacing
77
78**Build your scale:**
79- Start with base unit (4, 6, 8, or whatever fits)
80- Create scale: base × 1, 2, 3, 4, 6, 8, 12, 16, 24
81- Stick to scale values (avoid arbitrary in-between values)
82
83**Guidelines:**
84- Tighter spacing for related items
85- Generous spacing separates major sections
86- Whitespace = breathing room and importance
87- Choose scale matching your aesthetic
88
89---
90
91### Typography
92
93**Creative Direction:**
94- Choose distinctive, characterful fonts (not system fonts)
95- Pair display font (headings) with refined body font
96- Font conveys personality: geometric = modern, serif = elegant, rounded = friendly
97- Avoid overused fonts: Inter, Roboto, Arial, Helvetica
98
99**Technical Specs:**
100- **Body text**: Readable size (typically 16px+, adjust based on font)
101- **Line height**: 1.5-1.6 for body, 1.2-1.3 for headings
102- **Line length**: 50-75 characters optimal
103- **Type scale**: Choose ratio for consistent hierarchy
104 - Subtle/refined: Smaller ratio (1.2)
105 - Balanced: Medium ratio (1.25)
106 - Bold/dramatic: Larger ratio (1.333+)
107
108**Font Weights:**
109- Regular (400): Body text
110- Semibold (600): Emphasis, subheadings
111- Bold (700): Headings, strong emphasis
112- Limit to 3-4 weights maximum
113
114**Hierarchy Levels:**
115- Primary: Page titles, main CTAs
116- Secondary: Section headings, important actions
117- Tertiary: Body text, labels
118- Quaternary: Metadata, captions, helper text
119
120---
121
122### Color System
123
124**Creative Direction:**
125- Commit to aesthetic: bold OR refined (not timid middle)
126- Use dominant colors with sharp accents
127- Color conveys mood: warm (energy), cool (calm), muted (sophistication)
128- Consider color psychology for brand personality
129
130**Technical Specs:**
131- **Primary**: Main brand color for CTAs, key actions (1 color)
132- **Neutrals**: Text, borders, backgrounds (5-7 shades from light to dark)
133- **Semantic**: Success (green), error (red), warning (yellow), info (blue)
134- **Limit**: 3-4 brand colors maximum
135
136**Contrast Requirements (WCAG AA - required for accessibility):**
137- Normal text: 4.5:1 minimum
138- Large text: 3:1 minimum
139- UI components: 3:1 minimum
140- Use contrast checker tools to verify
141
142**Guidelines:**
143- Test all text/background combinations
144- Don't rely on color alone (add icons, labels, patterns)
145- Each color needs light/dark variants
146
147---
148
149### Visual Hierarchy
150
151**Principle:** Guide attention through size, weight, contrast, and spacing.
152
153**Create clear levels:**
154- Use size differences (headings larger than body)
155- Use weight differences (bold for emphasis)
156- Use spacing (more space = more importance)
157- Use color sparingly for hierarchy
158
159**Hierarchy Techniques:**
160- **Size**: Primary elements significantly larger (2-3x+ size difference)
161- **Proximity**: Group related items close, separate groups with generous space
162- **Contrast**: Important elements use stronger contrast
163- **Alignment**: Consistent alignment creates order
164
165---
166
167## Spatial Composition
168
169### Layout Patterns
170
171**Create interest through:**
172- **Asymmetry**: Break symmetry for dynamic feel
173- **Overlap**: Layer elements for depth
174- **Diagonal flow**: Guide eye with angled layouts
175- **Whitespace**: Generous negative space OR controlled density (intentional)
176- **Grid breaking**: Intentionally break grid for emphasis
177
178**Alignment:**
179- Left-align text for readability (LTR languages)
180- Center-align sparingly (titles, empty states)
181- Right-align numbers in tables
182- Be consistent within sections
183
184---
185
186## Visual Details
187
188### Add Depth and Atmosphere
189
190**Backgrounds:**
191- Gradient meshes (soft, blended colors)
192- Noise textures (subtle grain, paper texture)
193- Geometric patterns (shapes, grids, dots)
194- Layered transparencies (depth through layers)
195
196**Details:**
197- Shadows for elevation (subtle for cards, stronger for modals)
198- Borders for definition (thin, subtle color difference)
199- Subtle animations (hover states, quick transitions)
200
201---
202
203## Common Mistakes
204
205**❌ Avoid:**
2061. Generic AI aesthetics (purple gradients, system fonts)
2072. No aesthetic direction (mixing styles randomly)
2083. Arbitrary spacing (values outside your scale)
2094. Poor contrast (insufficient difference)
2105. Too many colors (overwhelming palette)
2116. Inconsistent font sizes (random values, no scale)
2127. No visual hierarchy (everything same size)
2138. Cramped layouts (insufficient whitespace)
214
215**✅ Do:**
2161. Choose clear aesthetic and commit
2172. Use distinctive fonts with personality
2183. Follow spacing scale consistently
2194. Test contrast ratios (4.5:1 minimum)
2205. Limit to 3-4 brand colors
2216. Use type scale for predictable hierarchy
2227. Create clear levels (primary > secondary > tertiary)
2238. Give content generous whitespace
224
225---
226
227## Validation Checklist
228
229**Creative:**
230- [ ] Clear aesthetic direction chosen
231- [ ] Distinctive, characterful fonts (not generic)
232- [ ] Cohesive color palette (bold OR refined)
233- [ ] Unexpected layouts or intentional grid breaks
234- [ ] Visual details add atmosphere
235
236**Technical:**
237- [ ] Spacing follows consistent scale
238- [ ] Font sizes use type scale
239- [ ] Color contrast meets WCAG AA (verify with checker)
240- [ ] Line length readable
241- [ ] Visual hierarchy clear
242- [ ] Alignment consistent and intentional
243- [ ] Limited brand color palette
244
245---
246
247## Key Takeaway
248
249**Distinctive + Correct = Beautiful UI**
250
251Technical correctness (spacing, contrast, hierarchy) ensures usability and professionalism.
252Creative direction (aesthetic, fonts, colors, layouts) ensures memorability and distinctiveness.
253
254Great design requires both: intentional aesthetic choices executed with technical precision.
255
256Focus on intentionality - commit fully to chosen direction, then execute with consistency.
257Avoid generic AI aesthetics through bold or refined choices, never timid middle ground.