Graphic Design Skill
Patterns for visual design, SVG creation, layout composition, typography, and brand identity.
Design Principles
Visual Hierarchy
| Level |
Purpose |
Techniques |
| Primary |
First thing seen |
Largest, boldest, highest contrast |
| Secondary |
Supporting info |
Medium size, moderate weight |
| Tertiary |
Details |
Smaller, lighter, subtle |
Hierarchy Tools
- Size — Larger = more important
- Weight — Bolder = more attention
- Color — High contrast = focal point
- Position — Top/center = primary
- Whitespace — Isolation = emphasis
Balance Types
| Type |
Characteristics |
Best For |
| Symmetrical |
Mirror image, formal |
Corporate, traditional |
| Asymmetrical |
Visual weight balanced, dynamic |
Modern, creative |
| Radial |
Elements radiate from center |
Logos, icons |
Layout & Composition
Grid Systems
┌─────┬─────┬─────┬─────┐
│ 1 │ 2 │ 3 │ 4 │ 12-column grid
├─────┼─────┼─────┼─────┤ (most flexible)
│ 5 │ 6 │ 7 │ 8 │
├─────┼─────┼─────┼─────┤
│ 9 │ 10 │ 11 │ 12 │
└─────┴─────┴─────┴─────┘
Golden Ratio (1:1.618)
- Use for proportions that feel "right"
- Width to height relationships
- Spacing progressions
- Element sizing
Rule of Thirds
┌─────────┬─────────┬─────────┐
│ │ ● │ │ Place key elements
├─────────┼─────────┼─────────┤ at intersection
│ ● │ │ ● │ points for dynamic
├─────────┼─────────┼─────────┤ composition
│ │ ● │ │
└─────────┴─────────┴─────────┘
Alignment Principles
| Principle |
Rule |
| Edge alignment |
Elements share common edges |
| Center alignment |
Elements share center axis |
| Baseline alignment |
Text shares baseline |
| Optical alignment |
Visually aligned (may differ from mathematical) |
Typography
Type Scale (1.25 ratio)
| Level |
Size |
Use |
| Display |
72px |
Hero headlines |
| H1 |
48px |
Page titles |
| H2 |
36px |
Section headers |
| H3 |
28px |
Subsections |
| Body |
16px |
Main content |
| Caption |
12px |
Supporting text |
Font Pairing Rules
| Combination |
Example |
Vibe |
| Serif + Sans |
Georgia + Helvetica |
Classic, professional |
| Sans + Sans |
Montserrat + Open Sans |
Modern, clean |
| Display + Body |
Playfair + Source Sans |
Elegant, editorial |
Typography Best Practices
- Line height: 1.4–1.6× font size for body
- Line length: 45–75 characters optimal
- Letter spacing: Increase for ALL CAPS
- Contrast: Dark on light or light on dark
- Hierarchy: Max 3 font sizes per design
Color Theory
Color Relationships
Primary
●
/|\
/ | \
/ | \
●───●───●
Secondary Tertiary
Color Schemes
| Scheme |
Description |
Mood |
| Monochromatic |
One hue, varied lightness |
Cohesive, elegant |
| Complementary |
Opposite on wheel |
High contrast, vibrant |
| Analogous |
Adjacent on wheel |
Harmonious, natural |
| Triadic |
Three equidistant |
Balanced, dynamic |
| Split-complementary |
Base + two adjacent to complement |
Softer contrast |
Color Psychology
| Color |
Associations |
Use Cases |
| Blue |
Trust, stability, tech |
Corporate, software |
| Green |
Growth, nature, success |
Health, finance |
| Red |
Energy, urgency, passion |
CTAs, alerts |
| Purple |
Creativity, luxury |
Premium, creative |
| Orange |
Friendly, energetic |
Social, youth |
| Yellow |
Optimism, attention |
Highlights, warnings |
Contrast & Accessibility
| WCAG Level |
Contrast Ratio |
Use |
| AA (normal) |
4.5:1 |
Body text |
| AA (large) |
3:1 |
18px+ or 14px bold |
| AAA |
7:1 |
Maximum accessibility |
Applying Color Theory to Mermaid Diagrams
Color theory principles translate directly to Mermaid diagram styling. The GitHub Pastel Palette v2 (defined in the markdown-mermaid skill) implements these principles:
Semantic Color Mapping (from color psychology):
| Semantic Purpose |
Palette Color |
Fill |
Text |
Stroke |
| Primary actions |
Blue |
#ddf4ff |
#0550ae |
#80ccff |
| Success/output |
Green |
#d3f5db |
#1a7f37 |
#6fdd8b |
| Business logic |
Gold |
#fff8c5 |
#9a6700 |
#d4a72c |
| Special/DevOps |
Purple |
#d8b9ff |
#6639ba |
#bf8aff |
| Errors/critical |
Red |
#ffebe9 |
#cf222e |
#f5a3a3 |
| Raw/ingestion |
Bronze |
#fff1e5 |
#953800 |
#ffb77c |
| Background |
Neutral |
#eaeef2 |
#24292f |
#d0d7de |
Design Principles Applied:
- Triadic harmony: Blue + Gold + Red form a balanced triad
- Analogous groups: Green + Blue are adjacent, creating calm flow sections
- Light fills + dark text: Ensures WCAG AA contrast (4.5:1+)
- Neutral arrows (
#57606a): Don't compete with colored nodes — visual hierarchy preserved
- Consistent stroke family: Each color has a matching mid-tone stroke (not jarring black borders)
When to Override the Palette:
- Diagrams comparing two systems → Use just 2 contrasting colors (complementary scheme)
- Status dashboards → Green/Yellow/Red RAG mapping
- Sequential processes → Monochromatic gradient (light to dark within one hue)
SVG Design
SVG Structure
<svg viewBox="0 0 width height" xmlns="...">
<defs>
<!-- Reusable definitions -->
<linearGradient id="grad1">...</linearGradient>
<filter id="shadow">...</filter>
</defs>
<!-- Background layer -->
<rect .../>
<!-- Main content -->
<g transform="translate(x, y)">
<!-- Grouped elements -->
</g>
<!-- Foreground/overlay -->
</svg>
Common SVG Elements
| Element |
Use |
Key Attributes |
<rect> |
Rectangles, backgrounds |
x, y, width, height, rx (rounded) |
<circle> |
Circles, dots |
cx, cy, r |
<ellipse> |
Ovals |
cx, cy, rx, ry |
<line> |
Straight lines |
x1, y1, x2, y2 |
<path> |
Complex shapes |
d (path data) |
<text> |
Typography |
x, y, text-anchor, dominant-baseline |
<g> |
Grouping |
transform |
SVG Path Commands
| Command |
Meaning |
Example |
| M |
Move to |
M 10 20 |
| L |
Line to |
L 30 40 |
| H |
Horizontal line |
H 50 |
| V |
Vertical line |
V 60 |
| Q |
Quadratic curve |
Q cx cy, x y |
| C |
Cubic curve |
C cx1 cy1, cx2 cy2, x y |
| Z |
Close path |
Z |
SVG Text Alignment
<!-- Horizontal alignment -->
text-anchor="start|middle|end"
<!-- Vertical alignment -->
dominant-baseline="auto|middle|central|hanging"
<!-- Centered text -->
<text x="50%" y="50%" text-anchor="middle" dominant-baseline="central">
Perfectly Centered
</text>
SVG Gradients
<!-- Linear gradient -->
<linearGradient id="grad" x1="0%" y1="0%" x2="100%" y2="0%">
<stop offset="0%" stop-color="#007ACC"/>
<stop offset="100%" stop-color="#00a8e8"/>
</linearGradient>
<!-- Radial gradient -->
<radialGradient id="glow" cx="50%" cy="50%" r="50%">
<stop offset="0%" stop-color="#007ACC" stop-opacity="0.4"/>
<stop offset="100%" stop-color="#007ACC" stop-opacity="0"/>
</radialGradient>
SVG Transforms
| Transform |
Syntax |
Use |
| Translate |
translate(x, y) |
Move element |
| Rotate |
rotate(deg, cx, cy) |
Spin around point |
| Scale |
scale(x, y) |
Resize |
| Skew |
skewX(deg) / skewY(deg) |
Shear |
Banner & Marketing Design
Banner Dimensions
| Platform |
Size |
Aspect |
| VS Code Marketplace |
1280×640 |
2:1 |
| GitHub Social |
1280×640 |
2:1 |
| Twitter Header |
1500×500 |
3:1 |
| LinkedIn Banner |
1584×396 |
4:1 |
| Open Graph |
1200×630 |
~1.9:1 |
Banner Composition
┌─────────────────────────────────────────┐
│ ┌─────────────────────────────────┐ │
│ │ VISUAL ELEMENT │ │ Top third: Logo/Icon
│ └─────────────────────────────────┘ │
│ │
│ MAIN HEADLINE │ Middle: Primary message
│ Subtitle Text │
│ │
│ [Badge 1] [Badge 2] [Badge 3] │ Bottom third: CTAs/Details
└─────────────────────────────────────────┘
Badge/Pill Design
<!-- Rounded pill badge -->
<g>
<rect x="-50" y="-16" width="100" height="32" rx="16"
fill="#007ACC" opacity="0.15"/>
<text x="0" y="0" text-anchor="middle" dominant-baseline="central"
font-size="12" fill="#94a3b8">Label</text>
</g>
Icon Design
Icon Grid
┌────────────────────┐
│ ┌──────────────┐ │ Outer: Padding zone
│ │ │ │ Inner: Safe area
│ │ CONTENT │ │ Content: Icon artwork
│ │ │ │
│ └──────────────┘ │ Standard: 24×24, 16×16
└────────────────────┘
Icon Principles
- Simplicity — Recognize at small sizes
- Consistency — Same stroke weight, style
- Optical balance — Visually centered, not mathematically
- Metaphor — Universally understood symbols
Icon Styles
| Style |
Characteristics |
Use |
| Outlined |
Stroke only, no fill |
Light, modern UI |
| Filled |
Solid shapes |
Bold, clear visibility |
| Duotone |
Two tones/colors |
Distinctive, branded |
| Glyph |
Single color, simplified |
System icons |
Design Systems
Spacing Scale (8px base)
| Token |
Value |
Use |
| xs |
4px |
Tight spacing |
| sm |
8px |
Default gap |
| md |
16px |
Section spacing |
| lg |
24px |
Component gaps |
| xl |
32px |
Major sections |
| 2xl |
48px |
Hero spacing |
Elevation/Shadow
| Level |
Shadow |
Use |
| 0 |
None |
Flat elements |
| 1 |
0 1px 2px |
Subtle lift |
| 2 |
0 2px 4px |
Cards |
| 3 |
0 4px 8px |
Dropdowns |
| 4 |
0 8px 16px |
Modals |
Border Radius Scale
| Token |
Value |
Use |
| none |
0 |
Sharp corners |
| sm |
4px |
Subtle rounding |
| md |
8px |
Standard buttons |
| lg |
16px |
Cards, pills |
| full |
9999px |
Circles, pills |
Illustration Principles
Universal principles for placing illustrations in any document — READMEs, docs, presentations, books.
Principle 1: Contextual Placement
An image should answer: "Why HERE?"
Place images at the exact moment they illustrate. An image that appears next to the content it depicts reinforces understanding; a decorative image placed arbitrarily adds noise.
Principle 2: Visual Variety
Readers should be surprised by each image, not numb to them.
Avoid repeating the same visual formula. Vary: composition, subject matter, perspective, color palette, and image type (diagram, screenshot, illustration, photo).
Principle 3: Narrative Function
Every illustration should serve one of these purposes:
| Function |
Description |
Example |
| Anchor |
Mark a pivotal moment or concept |
Architecture diagram at design section |
| Reveal |
Show something text describes |
Screenshot of the UI being discussed |
| Transition |
Signal a tonal or topic shift |
Banner between major sections |
| Character |
Deepen connection to a person/persona |
Avatar at persona introduction |
| Setting |
Establish context or environment |
Deployment diagram for infrastructure |
| Evidence |
Visual proof or data |
Chart, graph, or test results |
Principle 4: Format Consistency
HTML for precise control:
<p align="center">
<img src="assets/IMAGE.png" alt="Descriptive alt text" width="60%">
</p>
Width guidelines:
| Asset Type |
Width |
Use |
| Full-width banners |
100% |
Section headers, hero images |
| Feature illustrations |
60% |
In-content diagrams, screenshots |
| Spot illustrations |
40-50% |
Inline accents, small diagrams |
| Icons/badges |
20-30% |
Status indicators, inline elements |
Design Review Checklist
Visual Quality
Typography
Color
Technical
1---
2name: graphic-design
3description: "Patterns for visual design, SVG creation, layout composition, typography, and brand identity."
4lastReviewed: 2026-04-30
5metadata:
6 source: https://skillmd.com/skills/fabioc-aloha/graphic-design
7---
8
9# Graphic Design Skill
10
11
12> Patterns for visual design, SVG creation, layout composition, typography, and brand identity.
13
14## Design Principles
15
16### Visual Hierarchy
17
18| Level | Purpose | Techniques |
19| ----- | ------- | ---------- |
20| **Primary** | First thing seen | Largest, boldest, highest contrast |
21| **Secondary** | Supporting info | Medium size, moderate weight |
22| **Tertiary** | Details | Smaller, lighter, subtle |
23
24### Hierarchy Tools
25
26- **Size** — Larger = more important
27- **Weight** — Bolder = more attention
28- **Color** — High contrast = focal point
29- **Position** — Top/center = primary
30- **Whitespace** — Isolation = emphasis
31
32### Balance Types
33
34| Type | Characteristics | Best For |
35| ---- | --------------- | -------- |
36| **Symmetrical** | Mirror image, formal | Corporate, traditional |
37| **Asymmetrical** | Visual weight balanced, dynamic | Modern, creative |
38| **Radial** | Elements radiate from center | Logos, icons |
39
40## Layout & Composition
41
42### Grid Systems
43
44```text
45┌─────┬─────┬─────┬─────┐
46│ 1 │ 2 │ 3 │ 4 │ 12-column grid
47├─────┼─────┼─────┼─────┤ (most flexible)
48│ 5 │ 6 │ 7 │ 8 │
49├─────┼─────┼─────┼─────┤
50│ 9 │ 10 │ 11 │ 12 │
51└─────┴─────┴─────┴─────┘
52```
53
54### Golden Ratio (1:1.618)
55
56- Use for proportions that feel "right"
57- Width to height relationships
58- Spacing progressions
59- Element sizing
60
61### Rule of Thirds
62
63```text
64┌─────────┬─────────┬─────────┐
65│ │ ● │ │ Place key elements
66├─────────┼─────────┼─────────┤ at intersection
67│ ● │ │ ● │ points for dynamic
68├─────────┼─────────┼─────────┤ composition
69│ │ ● │ │
70└─────────┴─────────┴─────────┘
71```
72
73### Alignment Principles
74
75| Principle | Rule |
76| --------- | ---- |
77| **Edge alignment** | Elements share common edges |
78| **Center alignment** | Elements share center axis |
79| **Baseline alignment** | Text shares baseline |
80| **Optical alignment** | Visually aligned (may differ from mathematical) |
81
82## Typography
83
84### Type Scale (1.25 ratio)
85
86| Level | Size | Use |
87| ----- | ---- | --- |
88| Display | 72px | Hero headlines |
89| H1 | 48px | Page titles |
90| H2 | 36px | Section headers |
91| H3 | 28px | Subsections |
92| Body | 16px | Main content |
93| Caption | 12px | Supporting text |
94
95### Font Pairing Rules
96
97| Combination | Example | Vibe |
98| ----------- | ------- | ---- |
99| Serif + Sans | Georgia + Helvetica | Classic, professional |
100| Sans + Sans | Montserrat + Open Sans | Modern, clean |
101| Display + Body | Playfair + Source Sans | Elegant, editorial |
102
103### Typography Best Practices
104
105- **Line height**: 1.4–1.6× font size for body
106- **Line length**: 45–75 characters optimal
107- **Letter spacing**: Increase for ALL CAPS
108- **Contrast**: Dark on light or light on dark
109- **Hierarchy**: Max 3 font sizes per design
110
111## Color Theory
112
113### Color Relationships
114
115```text
116 Primary
117 ●
118 /|\
119 / | \
120 / | \
121 ●───●───●
122 Secondary Tertiary
123```
124
125### Color Schemes
126
127| Scheme | Description | Mood |
128| ------ | ----------- | ---- |
129| **Monochromatic** | One hue, varied lightness | Cohesive, elegant |
130| **Complementary** | Opposite on wheel | High contrast, vibrant |
131| **Analogous** | Adjacent on wheel | Harmonious, natural |
132| **Triadic** | Three equidistant | Balanced, dynamic |
133| **Split-complementary** | Base + two adjacent to complement | Softer contrast |
134
135### Color Psychology
136
137| Color | Associations | Use Cases |
138| ----- | ------------ | --------- |
139| **Blue** | Trust, stability, tech | Corporate, software |
140| **Green** | Growth, nature, success | Health, finance |
141| **Red** | Energy, urgency, passion | CTAs, alerts |
142| **Purple** | Creativity, luxury | Premium, creative |
143| **Orange** | Friendly, energetic | Social, youth |
144| **Yellow** | Optimism, attention | Highlights, warnings |
145
146### Contrast & Accessibility
147
148| WCAG Level | Contrast Ratio | Use |
149| ---------- | -------------- | --- |
150| AA (normal) | 4.5:1 | Body text |
151| AA (large) | 3:1 | 18px+ or 14px bold |
152| AAA | 7:1 | Maximum accessibility |
153
154### Applying Color Theory to Mermaid Diagrams
155
156Color theory principles translate directly to Mermaid diagram styling. The **GitHub Pastel Palette v2** (defined in the **markdown-mermaid** skill) implements these principles:
157
158**Semantic Color Mapping** (from color psychology):
159
160| Semantic Purpose | Palette Color | Fill | Text | Stroke |
161| ---------------- | ------------- | ---- | ---- | ------ |
162| Primary actions | Blue | `#ddf4ff` | `#0550ae` | `#80ccff` |
163| Success/output | Green | `#d3f5db` | `#1a7f37` | `#6fdd8b` |
164| Business logic | Gold | `#fff8c5` | `#9a6700` | `#d4a72c` |
165| Special/DevOps | Purple | `#d8b9ff` | `#6639ba` | `#bf8aff` |
166| Errors/critical | Red | `#ffebe9` | `#cf222e` | `#f5a3a3` |
167| Raw/ingestion | Bronze | `#fff1e5` | `#953800` | `#ffb77c` |
168| Background | Neutral | `#eaeef2` | `#24292f` | `#d0d7de` |
169
170**Design Principles Applied**:
171
1721. **Triadic harmony**: Blue + Gold + Red form a balanced triad
1732. **Analogous groups**: Green + Blue are adjacent, creating calm flow sections
1743. **Light fills + dark text**: Ensures WCAG AA contrast (4.5:1+)
1754. **Neutral arrows** (`#57606a`): Don't compete with colored nodes — visual hierarchy preserved
1765. **Consistent stroke family**: Each color has a matching mid-tone stroke (not jarring black borders)
177
178**When to Override the Palette**:
179
180- Diagrams comparing two systems → Use just 2 contrasting colors (complementary scheme)
181- Status dashboards → Green/Yellow/Red RAG mapping
182- Sequential processes → Monochromatic gradient (light to dark within one hue)
183
184## SVG Design
185
186### SVG Structure
187
188```xml
189<svg viewBox="0 0 width height" xmlns="...">
190 <defs>
191 <!-- Reusable definitions -->
192 <linearGradient id="grad1">...</linearGradient>
193 <filter id="shadow">...</filter>
194 </defs>
195
196 <!-- Background layer -->
197 <rect .../>
198
199 <!-- Main content -->
200 <g transform="translate(x, y)">
201 <!-- Grouped elements -->
202 </g>
203
204 <!-- Foreground/overlay -->
205</svg>
206```
207
208### Common SVG Elements
209
210| Element | Use | Key Attributes |
211| ------- | --- | -------------- |
212| `<rect>` | Rectangles, backgrounds | x, y, width, height, rx (rounded) |
213| `<circle>` | Circles, dots | cx, cy, r |
214| `<ellipse>` | Ovals | cx, cy, rx, ry |
215| `<line>` | Straight lines | x1, y1, x2, y2 |
216| `<path>` | Complex shapes | d (path data) |
217| `<text>` | Typography | x, y, text-anchor, dominant-baseline |
218| `<g>` | Grouping | transform |
219
220### SVG Path Commands
221
222| Command | Meaning | Example |
223| ------- | ------- | ------- |
224| M | Move to | M 10 20 |
225| L | Line to | L 30 40 |
226| H | Horizontal line | H 50 |
227| V | Vertical line | V 60 |
228| Q | Quadratic curve | Q cx cy, x y |
229| C | Cubic curve | C cx1 cy1, cx2 cy2, x y |
230| Z | Close path | Z |
231
232### SVG Text Alignment
233
234```xml
235<!-- Horizontal alignment -->
236text-anchor="start|middle|end"
237
238<!-- Vertical alignment -->
239dominant-baseline="auto|middle|central|hanging"
240
241<!-- Centered text -->
242<text x="50%" y="50%" text-anchor="middle" dominant-baseline="central">
243 Perfectly Centered
244</text>
245```
246
247### SVG Gradients
248
249```xml
250<!-- Linear gradient -->
251<linearGradient id="grad" x1="0%" y1="0%" x2="100%" y2="0%">
252 <stop offset="0%" stop-color="#007ACC"/>
253 <stop offset="100%" stop-color="#00a8e8"/>
254</linearGradient>
255
256<!-- Radial gradient -->
257<radialGradient id="glow" cx="50%" cy="50%" r="50%">
258 <stop offset="0%" stop-color="#007ACC" stop-opacity="0.4"/>
259 <stop offset="100%" stop-color="#007ACC" stop-opacity="0"/>
260</radialGradient>
261```
262
263### SVG Transforms
264
265| Transform | Syntax | Use |
266| --------- | ------ | --- |
267| Translate | translate(x, y) | Move element |
268| Rotate | rotate(deg, cx, cy) | Spin around point |
269| Scale | scale(x, y) | Resize |
270| Skew | skewX(deg) / skewY(deg) | Shear |
271
272## Banner & Marketing Design
273
274### Banner Dimensions
275
276| Platform | Size | Aspect |
277| -------- | ---- | ------ |
278| VS Code Marketplace | 1280×640 | 2:1 |
279| GitHub Social | 1280×640 | 2:1 |
280| Twitter Header | 1500×500 | 3:1 |
281| LinkedIn Banner | 1584×396 | 4:1 |
282| Open Graph | 1200×630 | ~1.9:1 |
283
284### Banner Composition
285
286```text
287┌─────────────────────────────────────────┐
288│ ┌─────────────────────────────────┐ │
289│ │ VISUAL ELEMENT │ │ Top third: Logo/Icon
290│ └─────────────────────────────────┘ │
291│ │
292│ MAIN HEADLINE │ Middle: Primary message
293│ Subtitle Text │
294│ │
295│ [Badge 1] [Badge 2] [Badge 3] │ Bottom third: CTAs/Details
296└─────────────────────────────────────────┘
297```
298
299### Badge/Pill Design
300
301```xml
302<!-- Rounded pill badge -->
303<g>
304 <rect x="-50" y="-16" width="100" height="32" rx="16"
305 fill="#007ACC" opacity="0.15"/>
306 <text x="0" y="0" text-anchor="middle" dominant-baseline="central"
307 font-size="12" fill="#94a3b8">Label</text>
308</g>
309```
310
311## Icon Design
312
313### Icon Grid
314
315```text
316┌────────────────────┐
317│ ┌──────────────┐ │ Outer: Padding zone
318│ │ │ │ Inner: Safe area
319│ │ CONTENT │ │ Content: Icon artwork
320│ │ │ │
321│ └──────────────┘ │ Standard: 24×24, 16×16
322└────────────────────┘
323```
324
325### Icon Principles
326
327- **Simplicity** — Recognize at small sizes
328- **Consistency** — Same stroke weight, style
329- **Optical balance** — Visually centered, not mathematically
330- **Metaphor** — Universally understood symbols
331
332### Icon Styles
333
334| Style | Characteristics | Use |
335| ----- | --------------- | --- |
336| **Outlined** | Stroke only, no fill | Light, modern UI |
337| **Filled** | Solid shapes | Bold, clear visibility |
338| **Duotone** | Two tones/colors | Distinctive, branded |
339| **Glyph** | Single color, simplified | System icons |
340
341## Design Systems
342
343### Spacing Scale (8px base)
344
345| Token | Value | Use |
346| ----- | ----- | --- |
347| xs | 4px | Tight spacing |
348| sm | 8px | Default gap |
349| md | 16px | Section spacing |
350| lg | 24px | Component gaps |
351| xl | 32px | Major sections |
352| 2xl | 48px | Hero spacing |
353
354### Elevation/Shadow
355
356| Level | Shadow | Use |
357| ----- | ------ | --- |
358| 0 | None | Flat elements |
359| 1 | 0 1px 2px | Subtle lift |
360| 2 | 0 2px 4px | Cards |
361| 3 | 0 4px 8px | Dropdowns |
362| 4 | 0 8px 16px | Modals |
363
364### Border Radius Scale
365
366| Token | Value | Use |
367| ----- | ----- | --- |
368| none | 0 | Sharp corners |
369| sm | 4px | Subtle rounding |
370| md | 8px | Standard buttons |
371| lg | 16px | Cards, pills |
372| full | 9999px | Circles, pills |
373
374## Illustration Principles
375
376Universal principles for placing illustrations in any document — READMEs, docs, presentations, books.
377
378### Principle 1: Contextual Placement
379
380> **An image should answer: "Why HERE?"**
381
382Place images at the exact moment they illustrate. An image that appears next to the content it depicts reinforces understanding; a decorative image placed arbitrarily adds noise.
383
384### Principle 2: Visual Variety
385
386> **Readers should be surprised by each image, not numb to them.**
387
388Avoid repeating the same visual formula. Vary: composition, subject matter, perspective, color palette, and image type (diagram, screenshot, illustration, photo).
389
390### Principle 3: Narrative Function
391
392Every illustration should serve one of these purposes:
393
394| Function | Description | Example |
395|----------|-------------|--------|
396| **Anchor** | Mark a pivotal moment or concept | Architecture diagram at design section |
397| **Reveal** | Show something text describes | Screenshot of the UI being discussed |
398| **Transition** | Signal a tonal or topic shift | Banner between major sections |
399| **Character** | Deepen connection to a person/persona | Avatar at persona introduction |
400| **Setting** | Establish context or environment | Deployment diagram for infrastructure |
401| **Evidence** | Visual proof or data | Chart, graph, or test results |
402
403### Principle 4: Format Consistency
404
405**HTML for precise control:**
406
407```html
408<p align="center">
409<img src="assets/IMAGE.png" alt="Descriptive alt text" width="60%">
410</p>
411```
412
413**Width guidelines:**
414
415| Asset Type | Width | Use |
416|------------|-------|-----|
417| Full-width banners | 100% | Section headers, hero images |
418| Feature illustrations | 60% | In-content diagrams, screenshots |
419| Spot illustrations | 40-50% | Inline accents, small diagrams |
420| Icons/badges | 20-30% | Status indicators, inline elements |
421
422---
423
424## Design Review Checklist
425
426### Visual Quality
427
428- [ ] Consistent spacing throughout
429- [ ] Aligned elements (check edges)
430- [ ] Balanced composition
431- [ ] Clear visual hierarchy
432- [ ] Appropriate whitespace
433
434### Typography
435
436- [ ] Readable font sizes
437- [ ] Proper line height
438- [ ] Consistent font usage
439- [ ] Good contrast ratios
440- [ ] Appropriate letter spacing
441
442### Color
443
444- [ ] Consistent color palette
445- [ ] Sufficient contrast
446- [ ] Meaningful color use
447- [ ] Works in different contexts
448- [ ] Accessible (WCAG compliant)
449
450### Technical
451
452- [ ] Optimized file size
453- [ ] Correct dimensions
454- [ ] Responsive/scalable
455- [ ] Cross-platform compatible
456- [ ] Proper naming conventions