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-43description: Patterns for visual design, SVG creation, layout composition, typography, and brand identity.4tier: extended5applyTo: '**/*design*,**/*svg*,**/*visual*,**/*typography*'6currency: 2026-04-227metadata:8 source: https://skillmd.com/skills/fabioc-aloha/graphic-design-49---1011# Graphic Design Skill1213> Patterns for visual design, SVG creation, layout composition, typography, and brand identity.1415## Design Principles1617### Visual Hierarchy1819| Level | Purpose | Techniques |20| ----- | ------- | ---------- |21| **Primary** | First thing seen | Largest, boldest, highest contrast |22| **Secondary** | Supporting info | Medium size, moderate weight |23| **Tertiary** | Details | Smaller, lighter, subtle |2425### Hierarchy Tools2627- **Size** — Larger = more important28- **Weight** — Bolder = more attention29- **Color** — High contrast = focal point30- **Position** — Top/center = primary31- **Whitespace** — Isolation = emphasis3233### Balance Types3435| Type | Characteristics | Best For |36| ---- | --------------- | -------- |37| **Symmetrical** | Mirror image, formal | Corporate, traditional |38| **Asymmetrical** | Visual weight balanced, dynamic | Modern, creative |39| **Radial** | Elements radiate from center | Logos, icons |4041## Layout & Composition4243### Grid Systems4445```text46┌─────┬─────┬─────┬─────┐47│ 1 │ 2 │ 3 │ 4 │ 12-column grid48├─────┼─────┼─────┼─────┤ (most flexible)49│ 5 │ 6 │ 7 │ 8 │50├─────┼─────┼─────┼─────┤51│ 9 │ 10 │ 11 │ 12 │52└─────┴─────┴─────┴─────┘53```5455### Golden Ratio (1:1.618)5657- Use for proportions that feel "right"58- Width to height relationships59- Spacing progressions60- Element sizing6162### Rule of Thirds6364```text65┌─────────┬─────────┬─────────┐66│ │ ● │ │ Place key elements67├─────────┼─────────┼─────────┤ at intersection68│ ● │ │ ● │ points for dynamic69├─────────┼─────────┼─────────┤ composition70│ │ ● │ │71└─────────┴─────────┴─────────┘72```7374### Alignment Principles7576| Principle | Rule |77| --------- | ---- |78| **Edge alignment** | Elements share common edges |79| **Center alignment** | Elements share center axis |80| **Baseline alignment** | Text shares baseline |81| **Optical alignment** | Visually aligned (may differ from mathematical) |8283## Typography8485### Type Scale (1.25 ratio)8687| Level | Size | Use |88| ----- | ---- | --- |89| Display | 72px | Hero headlines |90| H1 | 48px | Page titles |91| H2 | 36px | Section headers |92| H3 | 28px | Subsections |93| Body | 16px | Main content |94| Caption | 12px | Supporting text |9596### Font Pairing Rules9798| Combination | Example | Vibe |99| ----------- | ------- | ---- |100| Serif + Sans | Georgia + Helvetica | Classic, professional |101| Sans + Sans | Montserrat + Open Sans | Modern, clean |102| Display + Body | Playfair + Source Sans | Elegant, editorial |103104### Typography Best Practices105106- **Line height**: 1.4–1.6× font size for body107- **Line length**: 45–75 characters optimal108- **Letter spacing**: Increase for ALL CAPS109- **Contrast**: Dark on light or light on dark110- **Hierarchy**: Max 3 font sizes per design111112## Color Theory113114### Color Relationships115116```text117 Primary118 ●119 /|\120 / | \121 / | \122 ●───●───●123 Secondary Tertiary124```125126### Color Schemes127128| Scheme | Description | Mood |129| ------ | ----------- | ---- |130| **Monochromatic** | One hue, varied lightness | Cohesive, elegant |131| **Complementary** | Opposite on wheel | High contrast, vibrant |132| **Analogous** | Adjacent on wheel | Harmonious, natural |133| **Triadic** | Three equidistant | Balanced, dynamic |134| **Split-complementary** | Base + two adjacent to complement | Softer contrast |135136### Color Psychology137138| Color | Associations | Use Cases |139| ----- | ------------ | --------- |140| **Blue** | Trust, stability, tech | Corporate, software |141| **Green** | Growth, nature, success | Health, finance |142| **Red** | Energy, urgency, passion | CTAs, alerts |143| **Purple** | Creativity, luxury | Premium, creative |144| **Orange** | Friendly, energetic | Social, youth |145| **Yellow** | Optimism, attention | Highlights, warnings |146147### Contrast & Accessibility148149| WCAG Level | Contrast Ratio | Use |150| ---------- | -------------- | --- |151| AA (normal) | 4.5:1 | Body text |152| AA (large) | 3:1 | 18px+ or 14px bold |153| AAA | 7:1 | Maximum accessibility |154155### Applying Color Theory to Mermaid Diagrams156157Color theory principles translate directly to Mermaid diagram styling. The **GitHub Pastel Palette v2** (defined in the **markdown-mermaid** skill) implements these principles:158159**Semantic Color Mapping** (from color psychology):160161| Semantic Purpose | Palette Color | Fill | Text | Stroke |162| ---------------- | ------------- | ---- | ---- | ------ |163| Primary actions | Blue | `#ddf4ff` | `#0550ae` | `#80ccff` |164| Success/output | Green | `#d3f5db` | `#1a7f37` | `#6fdd8b` |165| Business logic | Gold | `#fff8c5` | `#9a6700` | `#d4a72c` |166| Special/DevOps | Purple | `#d8b9ff` | `#6639ba` | `#bf8aff` |167| Errors/critical | Red | `#ffebe9` | `#cf222e` | `#f5a3a3` |168| Raw/ingestion | Bronze | `#fff1e5` | `#953800` | `#ffb77c` |169| Background | Neutral | `#eaeef2` | `#24292f` | `#d0d7de` |170171**Design Principles Applied**:1721731. **Triadic harmony**: Blue + Gold + Red form a balanced triad1742. **Analogous groups**: Green + Blue are adjacent, creating calm flow sections1753. **Light fills + dark text**: Ensures WCAG AA contrast (4.5:1+)1764. **Neutral arrows** (`#57606a`): Don't compete with colored nodes — visual hierarchy preserved1775. **Consistent stroke family**: Each color has a matching mid-tone stroke (not jarring black borders)178179**When to Override the Palette**:180- Diagrams comparing two systems → Use just 2 contrasting colors (complementary scheme)181- Status dashboards → Green/Yellow/Red RAG mapping182- Sequential processes → Monochromatic gradient (light to dark within one hue)183184## SVG Design185186### SVG Structure187188```xml189<svg viewBox="0 0 width height" xmlns="...">190 <defs>191 <!-- Reusable definitions -->192 <linearGradient id="grad1">...</linearGradient>193 <filter id="shadow">...</filter>194 </defs>195196 <!-- Background layer -->197 <rect .../>198199 <!-- Main content -->200 <g transform="translate(x, y)">201 <!-- Grouped elements -->202 </g>203204 <!-- Foreground/overlay -->205</svg>206```207208### Common SVG Elements209210| 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 |219220### SVG Path Commands221222| 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 |231232### SVG Text Alignment233234```xml235<!-- Horizontal alignment -->236text-anchor="start|middle|end"237238<!-- Vertical alignment -->239dominant-baseline="auto|middle|central|hanging"240241<!-- Centered text -->242<text x="50%" y="50%" text-anchor="middle" dominant-baseline="central">243 Perfectly Centered244</text>245```246247### SVG Gradients248249```xml250<!-- 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>255256<!-- 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```262263### SVG Transforms264265| 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 |271272## Banner & Marketing Design273274### Banner Dimensions275276| 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 |283284### Banner Composition285286```text287┌─────────────────────────────────────────┐288│ ┌─────────────────────────────────┐ │289│ │ VISUAL ELEMENT │ │ Top third: Logo/Icon290│ └─────────────────────────────────┘ │291│ │292│ MAIN HEADLINE │ Middle: Primary message293│ Subtitle Text │294│ │295│ [Badge 1] [Badge 2] [Badge 3] │ Bottom third: CTAs/Details296└─────────────────────────────────────────┘297```298299### Badge/Pill Design300301```xml302<!-- 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```310311## Icon Design312313### Icon Grid314315```text316┌────────────────────┐317│ ┌──────────────┐ │ Outer: Padding zone318│ │ │ │ Inner: Safe area319│ │ CONTENT │ │ Content: Icon artwork320│ │ │ │321│ └──────────────┘ │ Standard: 24×24, 16×16322└────────────────────┘323```324325### Icon Principles326327- **Simplicity** — Recognize at small sizes328- **Consistency** — Same stroke weight, style329- **Optical balance** — Visually centered, not mathematically330- **Metaphor** — Universally understood symbols331332### Icon Styles333334| 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 |340341## Design Systems342343### Spacing Scale (8px base)344345| 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 |353354### Elevation/Shadow355356| 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 |363364### Border Radius Scale365366| 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 |373374## Illustration Principles375376Universal principles for placing illustrations in any document — READMEs, docs, presentations, books.377378### Principle 1: Contextual Placement379380> **An image should answer: "Why HERE?"**381382Place 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.383384### Principle 2: Visual Variety385386> **Readers should be surprised by each image, not numb to them.**387388Avoid repeating the same visual formula. Vary: composition, subject matter, perspective, color palette, and image type (diagram, screenshot, illustration, photo).389390### Principle 3: Narrative Function391392Every illustration should serve one of these purposes:393394| 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 |402403### Principle 4: Format Consistency404405**HTML for precise control:**406```html407<p align="center">408<img src="assets/IMAGE.png" alt="Descriptive alt text" width="60%">409</p>410```411412**Width guidelines:**413414| Asset Type | Width | Use |415|------------|-------|-----|416| Full-width banners | 100% | Section headers, hero images |417| Feature illustrations | 60% | In-content diagrams, screenshots |418| Spot illustrations | 40-50% | Inline accents, small diagrams |419| Icons/badges | 20-30% | Status indicators, inline elements |420421---422423## Design Review Checklist424425### Visual Quality426427- [ ] Consistent spacing throughout428- [ ] Aligned elements (check edges)429- [ ] Balanced composition430- [ ] Clear visual hierarchy431- [ ] Appropriate whitespace432433### Typography434435- [ ] Readable font sizes436- [ ] Proper line height437- [ ] Consistent font usage438- [ ] Good contrast ratios439- [ ] Appropriate letter spacing440441### Color442443- [ ] Consistent color palette444- [ ] Sufficient contrast445- [ ] Meaningful color use446- [ ] Works in different contexts447- [ ] Accessible (WCAG compliant)448449### Technical450451- [ ] Optimized file size452- [ ] Correct dimensions453- [ ] Responsive/scalable454- [ ] Cross-platform compatible455- [ ] Proper naming conventions