# Illustration: design playbook

> One style, one job, three colors from the brand, and never a word inside the drawing.

Checked 2026-10-29. Each value says where it came from: published, our reading, or our recipe.

## Pick a set

Our reading. A brand's own published illustration style beats any table, so it comes first. Without one, corners decide: Atlassian's low-fi UI and IBM's line style use square, grid-built shapes for engineered brands; pill buttons ask for a looser hand. Line weight always follows the brand's icon stroke.

Take the first row that matches the brand.

1. **The brand publishes a pixel style** → steal-shapes pixel, people from pixel-art. Mozilla builds every illustration from pixels: Pixelgrams on a 24×24 grid, spot up to 3 colors.
2. **The brand publishes hand-drawn line with color only as ground** → open-doodles line-on-ground, people from open-peeps. Mailchimp: black line, color only as a flat ground. Open Doodles is loose black line; its fill goes to paper and the accent becomes the ground.
3. **The brand publishes hand-drawn line with flat fills** → open-doodles line-and-fill, people from open-peeps. Dropbox: loose black line, flat fills from the accent palette, no gradients. Open Doodles is drawn exactly that way.
4. **Sharp corners: button radius 0–2px** → steal-shapes geometric, people from open-peeps. IBM's line style and Atlassian's low-fi UI: basic shapes, square corners, built on a grid.
5. **Round brand: pill buttons** → open-doodles line-and-fill, people from open-peeps. A loose hand reads as friendly next to pill buttons; geometric shapes read as stiff.
6. **Anything else** → steal-shapes geometric, people from open-peeps. Shapes the engine draws itself always match the brand's corners, colors and icon stroke exactly.

## Rules

### 1. Only illustrate what the words can't show.

- Value (published): An illustration explains a concept, softens an error or marks a win. If an icon, a line of copy or nothing will do, use that.
- Check: Every illustration sits in an empty state, error, win, onboarding step, hero or feature lead; at most one per section.
- Sources: https://atlassian.design/foundations/illustrations, https://www.ibm.com/design/language/illustration/overview/

### 2. Pick the type by the job.

- Value (published): Hero leads a page. Spot carries one concept: empty state, error, win, feature card. Mini sits beside a line of text. Low-fi UI explains a workflow. Ambient pattern adds texture with no concept.
- Check: Each illustration carries data-type ∈ {hero, spot, mini, lowfi, pattern}, and the slot allows that type (empty and error states: spot only).
- Sources: https://brand.dropbox.com/imagery, https://atlassian.design/foundations/illustrations, https://www.ibm.com/design/language/illustration/tips-and-techniques/

### 3. Draw on four square frames, each half the last.

- Value (published): GitLab: 288px for feature promotion, 144px for empty and error states, 72px for banners and tight space, 36px only as part of a larger composition. Leave space inside the frame; never resize the frame to the drawing.
- Check: Every spot's box is square and its width ∈ {288, 144, 72, 36}px.
- Sources: https://design.gitlab.com/product-foundations/illustration

### 4. One hero per page, at most half its width.

- Value (our recipe): The hero illustration takes at most half the hero's width beside the copy on desktop and stacks under the copy on a phone. Sections get one spot each, at most.
- Why: Mozilla: never obscure a headline. Material: one hero image introduces the content. No one publishes the share; half is the widest split that keeps the headline the first thing read.
- Check: Count of data-type=hero ≤ 1; hero illustration width ÷ hero width ≤ 0.5 at 1280px; headline is never covered.
- Sources: https://brand.mozilla.com/document/231#/-/illustration, https://m2.material.io/design/communication/imagery.html

### 5. One illustration style per piece.

- Value (published): Every illustration on a page, deck or email comes from the same set and style.
- Check: Every illustration carries the same data-set and data-style.
- Sources: https://brand.mozilla.com/document/231#/-/illustration, https://m2.material.io/design/communication/imagery.html

### 6. Color by role: line, fill, ground. Three colors for a spot, five for a hero.

- Value (published): Line in ink, fill in the accent, ground in the surface, all from the brand. Mozilla: spot Pixelgrams up to 3 colors, hero up to 5. IBM: two to three hues; more adds complexity. Skin and hair don't count (rule 10).
- Check: Distinct fill and stroke colors, minus the people palette: spot ≤ 3, hero ≤ 5, and every one is a brand token.
- Sources: https://brand.mozilla.com/document/231#/-/illustration, https://www.ibm.com/design/language/illustration/tips-and-techniques/

### 7. Color for wins, neutral for routine, never louder than the button.

- Value (published): Atlassian: colorful spots add emphasis; neutral spots suit common tasks. IBM: blue in an illustration competes with blue buttons. Routine empty states and errors draw in ink and muted only; the accent is the button's.
- Check: On an empty or error state the illustration has no accent fill; on a win it may. No illustration shape matches the primary button's fill across more area than the button.
- Sources: https://atlassian.design/foundations/illustrations, https://www.ibm.com/design/language/illustration/tips-and-techniques/

### 8. Draw the line at the icon's stroke.

- Value (our recipe): IBM's line style is a continuation of pictogram logic: a few line weights (0.72, 1, 1.5, 2, 4, 6px), never more than four in one piece, never two that look alike. Our recipe: spots draw at the brand's icon stroke; heroes may add one heavier weight at 2×.
- Why: IBM ties illustration line to pictograms and caps weights at four. Matching the icon stroke is the simplest rule that keeps a spot and the icons beside it one family.
- Check: Rendered line = stroke-width × rendered width ÷ viewBox width (or non-scaling-stroke). Spot: within 0.5px of the icon stroke. Distinct weights ≤ 2.
- Sources: https://www.ibm.com/design/language/illustration/line-style/design, https://www.ibm.com/design/language/illustration/overview/

### 9. Lines that carry meaning pass 3:1.

- Value (published): IBM: if an illustration carries information the text doesn't, its main concepts meet 3:1 against their ground. An accent that fails 3:1 on paper (Mailchimp's yellow) is a ground or fill, never a line.
- Check: Contrast of every line color against the ground it sits on ≥ 3:1.
- Sources: https://www.ibm.com/design/language/illustration/tips-and-techniques/

### 10. Skin comes from a people palette, never the brand's.

- Value (published): IBM keeps a people palette (Rose and Almond, 10 steps each) reserved for skin, hair and nails, never an extension of the brand palette. ONS: people tones are for people only. Show a range of skin tones, ages, bodies and cultures; brand color goes on clothes and props.
- Check: No skin fill is a brand token. A group of 3 or more people shows at least 3 skin tones.
- Sources: https://www.ibm.com/design/language/illustration/people/, https://service-manual.ons.gov.uk/brand-guidelines/illustration/creating-characters

### 11. No words inside the drawing.

- Value (published): Mozilla: never put text inside a Pixelgram. Mailchimp: images may not load or be seen, so they are never the only way the message is told. Headings and labels stay live text beside the art.
- Check: No <text> or <foreignObject> in any illustration SVG; no raster illustration carries lettering.
- Sources: https://brand.mozilla.com/document/231#/-/illustration, https://styleguide.mailchimp.com/writing-for-accessibility/

### 12. Illustrate the abstract; photograph the real.

- Value (published): Dropbox: illustration explains abstract, complex or dry ideas; photography carries real customer stories. Material: illustration describes abstract concepts, photographs specific ones. Mozilla: never layer illustration over photography.
- Check: No illustrated person stands in for a named customer; no illustration overlaps a photo.
- Sources: https://brand.dropbox.com/imagery, https://m2.material.io/design/communication/imagery.html, https://brand.mozilla.com/document/231#/-/illustration

### 13. Explain the product with low-fi UI, not a screenshot.

- Value (published): Atlassian: low-fi UI uses basic shapes, sharp corners and mostly gray, for onboarding and tours; a real screenshot inside the product reads as a screen within a screen.
- Check: Tour and onboarding art uses rectangles only, gray plus one accent element, no real UI text.
- Sources: https://atlassian.design/foundations/illustrations

### 14. Decorative art is silent; informative art says its concept.

- Value (published): W3C: an image beside text that already says it gets alt="". Mailchimp: every other image gets alt text that describes its purpose.
- Check: An illustration next to a heading that states its message has alt="" or aria-hidden; any other has alt text that names the concept, never a filename.
- Sources: https://www.w3.org/WAI/tutorials/images/decorative/, https://styleguide.mailchimp.com/writing-for-accessibility/

## What AI gets wrong

- **Illustration soup.** A spot on every card and bullet, so none of them means anything. (rule: job-first)
- **A hero in an empty state.** A full scene where a 144px spot and one line of copy would do. (rule: type-by-job)
- **Mixed styles.** A 3D blob in the hero, flat people in the features, a doodle in the footer. (rule: one-style)
- **The set's default color.** The library's own purple or pink left in, on a brand that has neither. (rule: palette)
- **Brand color on skin.** Everyone recolored blue or green with the rest of the art, or everyone the same tone. (rule: people)
- **Words baked in.** A headline lettered into the SVG: it can't be read aloud, translated or restyled. (rule: no-text)

## Color roles

- `--il-line`: ink: every line
- `--il-fill`: accent: the main object (paper on line-on-ground brands; a muted ink tint on routine screens)
- `--il-fill-2`: accent secondary: heroes only
- `--il-paper`: paper: faces of objects and people, eyes
- `--il-ground`: surface behind a spot, or the accent on line-on-ground brands
- `--il-skin`: people palette only, never a brand color

Hosted files wrap their art in <g id="art"> and read their colors from the --il-* custom properties above, with the original color as fallback. Draw one with <svg viewBox="…"><use href="FILE#art"/></svg> and set the --il-* variables on the <svg> from the brand.

## Sets

### Steal shapes

- Drawn by the engine. CC0-1.0 (https://creativecommons.org/publicdomain/zero/1.0/), 1. Steal Unfairly. https://unfairly.ai/steal/design/illustration
- Suits: Product spots, low-fi UI, ambient patterns; brands with exact corners or a pixel system. Not for: Narrative scenes with people.
- Knobs: line = ink at the icon stroke (non-scaling), fill = accent, ground = surface, corner = button radius ÷ 4 (0 when sharp), pixel grid 24×24. Line: the brand's icon stroke, non-scaling.

### Open Doodles

- Hosted. CC0-1.0 (https://creativecommons.org/publicdomain/zero/1.0/), 33 doodles, fetched 2026-10-29. Pablo Stanley. https://www.opendoodles.com/
- Suits: Hand-drawn brands: heroes, wins, empty states with a person in them. Not for: Engineered, grid-built brands; tiny sizes (below 72px the line breaks up).
- Knobs: --il-line (ink), --il-fill and --il-fill-2 (accent, or paper on a ground), ground behind the frame. Line: outlined shapes, about 12 units on the 1024-wide canvas (our measurement): 1.6px at 144px, 3.4px at 288px.
- License file: https://unfairly.ai/steal/design/assets/illustration/open-doodles/LICENSE
- Files (33): https://unfairly.ai/steal/design/assets/illustration/open-doodles/ballet.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/bikini.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/chilling.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/clumsy.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/coffee.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/dancing.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/doggie.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/dog-jump.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/float.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/groovy.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/ice-cream.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/jumping.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/laying.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/levitate.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/loving.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/meditating.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/moshing.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/petting.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/plant.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/reading.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/reading-side.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/roller-skating.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/rolling.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/running.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/selfie.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/sitting.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/sitting-reading.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/sleek.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/sprinting.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/strolling.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/swinging.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/unboxing.svg, https://unfairly.ai/steal/design/assets/illustration/open-doodles/zombieing.svg

### Open Peeps

- Hosted. CC0-1.0 (https://creativecommons.org/publicdomain/zero/1.0/), 9.4.2 (12 files generated 2026-10-29). Pablo Stanley; DiceBear remix (code MIT). https://www.openpeeps.com/
- Package: `@dicebear/open-peeps`
- Suits: People in any style: avatars, testimonials without photos, team rows. Not for: Standing in for a real, named customer (use their photo).
- Knobs: --il-line (ink), --il-fill (clothes, brand accent), --il-paper; skin and hair fixed from the Open Peeps people palette (ffdbb4, edb98a, d08b5b, ae5d29, 694d3d). Line: outlined shapes, fixed in the art.
- License file: https://unfairly.ai/steal/design/assets/illustration/open-peeps/LICENSE
- Files (12): https://unfairly.ai/steal/design/assets/illustration/open-peeps/peep-1-afro.svg, https://unfairly.ai/steal/design/assets/illustration/open-peeps/peep-2-hijab.svg, https://unfairly.ai/steal/design/assets/illustration/open-peeps/peep-3-bun.svg, https://unfairly.ai/steal/design/assets/illustration/open-peeps/peep-4-cornrows.svg, https://unfairly.ai/steal/design/assets/illustration/open-peeps/peep-5-grayshort.svg, https://unfairly.ai/steal/design/assets/illustration/open-peeps/peep-6-longcurly.svg, https://unfairly.ai/steal/design/assets/illustration/open-peeps/peep-7-turban.svg, https://unfairly.ai/steal/design/assets/illustration/open-peeps/peep-8-bantuknots.svg, https://unfairly.ai/steal/design/assets/illustration/open-peeps/peep-9-short2.svg, https://unfairly.ai/steal/design/assets/illustration/open-peeps/peep-10-twists.svg, https://unfairly.ai/steal/design/assets/illustration/open-peeps/peep-11-mediumstraight.svg, https://unfairly.ai/steal/design/assets/illustration/open-peeps/peep-12-dreads1.svg

### Pixel Art

- Hosted. CC0-1.0 (https://creativecommons.org/publicdomain/zero/1.0/), 9.4.2 (6 files generated 2026-10-29). DiceBear. https://www.dicebear.com/styles/pixel-art/
- Package: `@dicebear/pixel-art`
- Suits: People for pixel brands. Not for: Any brand without a pixel system.
- Knobs: --il-fill (clothes); skin from the set's own 8 tones. Line: none: filled pixels on a 16×16 grid.
- License file: https://unfairly.ai/steal/design/assets/illustration/pixel-art/LICENSE
- Files (6): https://unfairly.ai/steal/design/assets/illustration/pixel-art/pixel-6.svg, https://unfairly.ai/steal/design/assets/illustration/pixel-art/pixel-2.svg, https://unfairly.ai/steal/design/assets/illustration/pixel-art/pixel-4.svg, https://unfairly.ai/steal/design/assets/illustration/pixel-art/pixel-1.svg, https://unfairly.ai/steal/design/assets/illustration/pixel-art/pixel-5.svg, https://unfairly.ai/steal/design/assets/illustration/pixel-art/pixel-3.svg

### Humaaans

- Link only, not hosted. CC0-1.0 (https://creativecommons.org/publicdomain/zero/1.0/), checked 2026-10-29. Pablo Stanley. https://www.humaaans.com/
- Suits: Mix-and-match flat people for flat-fill brands. Not for: Line-only brands.
- CC0, but files only come through a Gumroad download; not fetched yet.

### IRA Design

- Link only, not hosted. MIT (https://iradesign.io/), checked 2026-10-29. Creative Tim. https://iradesign.io/
- Suits: Gradient-filled scenes. Not for: Flat brands: its look is built on gradients.
- MIT per its site, but built from five gradients per character, which fights rule 6; not fetched.

### unDraw

- Do not use. unDraw license (https://undraw.co/license), license © 2026. Katerina Limpitsouni. https://undraw.co/
- Free to use, but bars distributing it in packs, compiling it into a similar service, automated downloading, and any use in AI systems without written permission. An engine must not draw with it.

### Blush

- Do not use. Blush license (https://blush.design/license), checked 2026-10-29. Various illustrators. https://blush.design/
- Free to use in end products, but no redistribution and no compiling into a competing service.

### Absurd Design

- Do not use. Absurd free license (https://absurd.design/freelicense), checked 2026-10-29. Diana Valeanu. https://absurd.design/
- Free tier needs a linked credit in every piece, bars redistribution, and bars any use where the file can be pulled out on its own.

## Not published anywhere we read

- No system we read publishes how much of a page illustration may take; rule 4's half is our recipe.
- Material 3's illustration pages render client-side and couldn't be read; Material values are from Material 2's imagery page.
- Atlassian, Dropbox and GitLab publish no line, color or character rules; IBM and Mozilla do.
- Mailchimp publishes no illustration guideline; its style here is observed from COLLINS's case study and mailchimp.com.
- Open Peeps' line weight isn't measured yet; Open Doodles' is our measurement, not the author's.
- DiceBear's HTTP API is free for non-commercial use only: the hosted Peeps and Pixel files were generated once; an engine should draw new ones with @dicebear/core and the style packages (MIT), not the API.
