{
  "schema": "design-playbook@1",
  "discipline": "illustration",
  "checked_at": "2026-10-29",
  "essence": "One style, one job, three colors from the brand, and never a word inside the drawing.",
  "pick": {
    "prov": "our reading",
    "why": "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.",
    "inputs": [
      "the brand book's published illustration style, if any",
      "accent contrast against paper",
      "button corner radius",
      "the brand's icon stroke (from the icons pick)"
    ],
    "rows": [
      {
        "when": "The brand publishes a pixel style",
        "test": "style=pixel",
        "set": "steal-shapes",
        "style": "pixel",
        "people": "pixel-art",
        "why": "Mozilla builds every illustration from pixels: Pixelgrams on a 24×24 grid, spot up to 3 colors."
      },
      {
        "when": "The brand publishes hand-drawn line with color only as ground",
        "test": "style=hand-ground",
        "set": "open-doodles",
        "style": "line-on-ground",
        "people": "open-peeps",
        "why": "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."
      },
      {
        "when": "The brand publishes hand-drawn line with flat fills",
        "test": "style=hand-fill",
        "set": "open-doodles",
        "style": "line-and-fill",
        "people": "open-peeps",
        "why": "Dropbox: loose black line, flat fills from the accent palette, no gradients. Open Doodles is drawn exactly that way."
      },
      {
        "when": "Sharp corners: button radius 0–2px",
        "test": "radius<=2",
        "set": "steal-shapes",
        "style": "geometric",
        "people": "open-peeps",
        "why": "IBM's line style and Atlassian's low-fi UI: basic shapes, square corners, built on a grid."
      },
      {
        "when": "Round brand: pill buttons",
        "test": "radius=pill",
        "set": "open-doodles",
        "style": "line-and-fill",
        "people": "open-peeps",
        "why": "A loose hand reads as friendly next to pill buttons; geometric shapes read as stiff."
      },
      {
        "when": "Anything else",
        "test": "else",
        "set": "steal-shapes",
        "style": "geometric",
        "people": "open-peeps",
        "why": "Shapes the engine draws itself always match the brand's corners, colors and icon stroke exactly."
      }
    ]
  },
  "rules": [
    {
      "id": "job-first",
      "rule": "Only illustrate what the words can't show.",
      "value": "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/"
      ],
      "prov": "published"
    },
    {
      "id": "type-by-job",
      "rule": "Pick the type by the job.",
      "value": "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/"
      ],
      "prov": "published"
    },
    {
      "id": "sizes",
      "rule": "Draw on four square frames, each half the last.",
      "value": "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"
      ],
      "prov": "published"
    },
    {
      "id": "share",
      "rule": "One hero per page, at most half its width.",
      "value": "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.",
      "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"
      ],
      "prov": "our recipe",
      "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."
    },
    {
      "id": "one-style",
      "rule": "One illustration style per piece.",
      "value": "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"
      ],
      "prov": "published"
    },
    {
      "id": "palette",
      "rule": "Color by role: line, fill, ground. Three colors for a spot, five for a hero.",
      "value": "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/"
      ],
      "prov": "published"
    },
    {
      "id": "emphasis",
      "rule": "Color for wins, neutral for routine, never louder than the button.",
      "value": "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/"
      ],
      "prov": "published"
    },
    {
      "id": "line",
      "rule": "Draw the line at the icon's stroke.",
      "value": "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×.",
      "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/"
      ],
      "prov": "our recipe",
      "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."
    },
    {
      "id": "contrast",
      "rule": "Lines that carry meaning pass 3:1.",
      "value": "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/"
      ],
      "prov": "published"
    },
    {
      "id": "people",
      "rule": "Skin comes from a people palette, never the brand's.",
      "value": "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"
      ],
      "prov": "published"
    },
    {
      "id": "no-text",
      "rule": "No words inside the drawing.",
      "value": "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/"
      ],
      "prov": "published"
    },
    {
      "id": "vs-photo",
      "rule": "Illustrate the abstract; photograph the real.",
      "value": "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"
      ],
      "prov": "published"
    },
    {
      "id": "lowfi",
      "rule": "Explain the product with low-fi UI, not a screenshot.",
      "value": "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"
      ],
      "prov": "published"
    },
    {
      "id": "alt",
      "rule": "Decorative art is silent; informative art says its concept.",
      "value": "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/"
      ],
      "prov": "published"
    }
  ],
  "mistakes": [
    {
      "name": "Illustration soup",
      "what": "A spot on every card and bullet, so none of them means anything.",
      "rule": "job-first"
    },
    {
      "name": "A hero in an empty state",
      "what": "A full scene where a 144px spot and one line of copy would do.",
      "rule": "type-by-job"
    },
    {
      "name": "Mixed styles",
      "what": "A 3D blob in the hero, flat people in the features, a doodle in the footer.",
      "rule": "one-style"
    },
    {
      "name": "The set's default color",
      "what": "The library's own purple or pink left in, on a brand that has neither.",
      "rule": "palette"
    },
    {
      "name": "Brand color on skin",
      "what": "Everyone recolored blue or green with the rest of the art, or everyone the same tone.",
      "rule": "people"
    },
    {
      "name": "Words baked in",
      "what": "A headline lettered into the SVG: it can't be read aloud, translated or restyled.",
      "rule": "no-text"
    }
  ],
  "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"
  },
  "how": "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.",
  "concepts": {
    "inbox": "chilling",
    "win": "jumping",
    "search": "reading",
    "error": "zombieing",
    "sync": "levitate",
    "hero": "unboxing"
  },
  "sets": [
    {
      "id": "steal-shapes",
      "name": "Steal shapes",
      "use": "draw",
      "source": "drawn in code by the engine (illustration-draw.ts)",
      "version": "1",
      "license": "CC0-1.0",
      "license_url": "https://creativecommons.org/publicdomain/zero/1.0/",
      "site": "https://unfairly.ai/steal/design/illustration",
      "author": "Steal Unfairly",
      "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"
    },
    {
      "id": "open-doodles",
      "name": "Open Doodles",
      "use": "host",
      "source": "https://opendoodles.s3-us-west-1.amazonaws.com/",
      "version": "33 doodles, fetched 2026-10-29",
      "license": "CC0-1.0",
      "license_url": "https://creativecommons.org/publicdomain/zero/1.0/",
      "site": "https://www.opendoodles.com/",
      "author": "Pablo Stanley",
      "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": [
        "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"
      ]
    },
    {
      "id": "open-peeps",
      "name": "Open Peeps",
      "use": "host",
      "package": "@dicebear/open-peeps",
      "source": "DiceBear open-peeps style (https://www.dicebear.com/styles/open-peeps/)",
      "version": "9.4.2 (12 files generated 2026-10-29)",
      "license": "CC0-1.0",
      "license_url": "https://creativecommons.org/publicdomain/zero/1.0/",
      "site": "https://www.openpeeps.com/",
      "author": "Pablo Stanley; DiceBear remix (code MIT)",
      "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": [
        "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"
      ]
    },
    {
      "id": "pixel-art",
      "name": "Pixel Art",
      "use": "host",
      "package": "@dicebear/pixel-art",
      "source": "DiceBear pixel-art style (https://www.dicebear.com/styles/pixel-art/)",
      "version": "9.4.2 (6 files generated 2026-10-29)",
      "license": "CC0-1.0",
      "license_url": "https://creativecommons.org/publicdomain/zero/1.0/",
      "site": "https://www.dicebear.com/styles/pixel-art/",
      "author": "DiceBear",
      "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": [
        "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"
      ]
    },
    {
      "id": "humaaans",
      "name": "Humaaans",
      "use": "link",
      "source": "https://www.humaaans.com/",
      "version": "checked 2026-10-29",
      "license": "CC0-1.0",
      "license_url": "https://creativecommons.org/publicdomain/zero/1.0/",
      "site": "https://www.humaaans.com/",
      "author": "Pablo Stanley",
      "suits": "Mix-and-match flat people for flat-fill brands",
      "not_for": "Line-only brands",
      "reason": "CC0, but files only come through a Gumroad download; not fetched yet."
    },
    {
      "id": "ira-design",
      "name": "IRA Design",
      "use": "link",
      "source": "https://iradesign.io/",
      "version": "checked 2026-10-29",
      "license": "MIT",
      "license_url": "https://iradesign.io/",
      "site": "https://iradesign.io/",
      "author": "Creative Tim",
      "suits": "Gradient-filled scenes",
      "not_for": "Flat brands: its look is built on gradients",
      "reason": "MIT per its site, but built from five gradients per character, which fights rule 6; not fetched."
    },
    {
      "id": "undraw",
      "name": "unDraw",
      "use": "exclude",
      "source": "https://undraw.co/",
      "version": "license © 2026",
      "license": "unDraw license",
      "license_url": "https://undraw.co/license",
      "site": "https://undraw.co/",
      "author": "Katerina Limpitsouni",
      "reason": "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."
    },
    {
      "id": "blush",
      "name": "Blush",
      "use": "exclude",
      "source": "https://blush.design/",
      "version": "checked 2026-10-29",
      "license": "Blush license",
      "license_url": "https://blush.design/license",
      "site": "https://blush.design/",
      "author": "Various illustrators",
      "reason": "Free to use in end products, but no redistribution and no compiling into a competing service."
    },
    {
      "id": "absurd",
      "name": "Absurd Design",
      "use": "exclude",
      "source": "https://absurd.design/",
      "version": "checked 2026-10-29",
      "license": "Absurd free license",
      "license_url": "https://absurd.design/freelicense",
      "site": "https://absurd.design/",
      "author": "Diana Valeanu",
      "reason": "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."
    }
  ],
  "gaps": [
    "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."
  ]
}