{
  "schema": "design-playbook@1",
  "discipline": "photography",
  "checked_at": "2026-10-29",
  "essence": "Real people doing real work, in daylight, cropped on the subject, in one treatment drawn from the brand's colors.",
  "pick": {
    "prov": "our reading",
    "why": "IBM's default is natural and ungraded; Spotify's duotone works because its color pairs are bold and high-contrast; GitLab picks photos that feature or complement the brand colors. A duotone's tonal range is the contrast between its two colors, so the pair has to be far apart.",
    "inputs": [
      "the brand's published photo treatment, if any",
      "accent hue",
      "accent luminance and saturation",
      "contrast between ink and accent"
    ],
    "rows": [
      {
        "when": "The brand publishes a photo treatment",
        "test": "published",
        "treatment": "published",
        "why": "The brand's own recipe beats our table."
      },
      {
        "when": "Warm, light accent: hue 0–70° or 330–360°, luminance 0.4 or more",
        "test": "warm-light-accent",
        "treatment": "warm",
        "why": "A light warm accent duotones into a pale, flat highlight. As a grade it reads as daylight."
      },
      {
        "when": "Bold pair: ink and accent contrast 7:1 or more",
        "test": "bold-pair",
        "treatment": "duotone",
        "why": "Seven to one leaves the photo a full range of tones in two brand colors."
      },
      {
        "when": "Vivid cool accent: hue 170–260°, saturation 90% or more",
        "test": "vivid-cool-accent",
        "treatment": "cool",
        "why": "A saturated cool accent fights a warm, ungraded photo. A light cool grade brings the photo toward it."
      },
      {
        "when": "Anything else",
        "test": "else",
        "treatment": "natural",
        "why": "Nothing in the palette to match, so IBM's default: natural light, no grade."
      }
    ]
  },
  "rules": [
    {
      "id": "real-work",
      "rule": "Show real people doing real things, never a visual pun.",
      "value": "Patagonia: an honest shot, real people doing real things. IBM: avoid clichés that loosely stand for a concept. GitLab: no people obviously acting.",
      "check": "The photo's subject is the piece's subject. Fail on tags: handshake, pointing-at-screen, globe, lightbulb, puzzle, chess, thumbs-up, headset-smile.",
      "sources": [
        "https://www.patagonia.com.hk/blogs/stories/an-honest-shot",
        "https://www.ibm.com/design/language/photography/tips-and-techniques",
        "https://design.gitlab.com/brand-design/photography"
      ],
      "prov": "published"
    },
    {
      "id": "cast",
      "rule": "Cast people with intent, and cast widely.",
      "value": "GitLab: people of varied backgrounds, ages, body types, races and genders. Starbucks: people sparingly, thoughtfully, with intention. IBM: equal skill and standards for every subject.",
      "check": "Across a piece, people photos vary in age and background; no photo of a person is decoration with no role in the copy.",
      "sources": [
        "https://design.gitlab.com/brand-design/photography",
        "https://creative.starbucks.com/photography/",
        "https://www.ibm.com/design/language/photography/overview"
      ],
      "prov": "published"
    },
    {
      "id": "level",
      "rule": "Shoot at eye level, with a level horizon.",
      "value": "Airbnb: shoot straight ahead, without tilting the lens up or down. IBM: eye level, or aerial; nothing in between, no forced perspective.",
      "check": "Horizon and verticals within 1° of level; no CSS rotate on a photo.",
      "sources": [
        "https://www.airbnb.com/resources/hosting-homes/a/how-to-take-great-photos-for-your-listing-687",
        "https://www.ibm.com/design/language/photography/tips-and-techniques"
      ],
      "prov": "published"
    },
    {
      "id": "daylight",
      "rule": "Natural light, no flash, no color wash.",
      "value": "Airbnb: soft natural light, flash off, blinds open. IBM: natural light; avoid overly warm golden-hour glow, color washes and grading.",
      "check": "No overlay of one color above 10% opacity across the whole photo; any grade comes from the treatment recipe only.",
      "sources": [
        "https://www.airbnb.com/resources/hosting-homes/a/how-to-take-great-photos-for-your-listing-687",
        "https://www.ibm.com/design/language/photography/tips-and-techniques"
      ],
      "prov": "published"
    },
    {
      "id": "sharp",
      "rule": "Keep the subject sharp. Go shallow only for portraits and still life.",
      "value": "IBM: everything in sharp focus; avoid soft focus. GitLab portraits: a shallow depth of field draws attention to the person.",
      "check": "No CSS blur on a photo. Reportage: no background blur. Portrait or still life: the subject is the sharpest region.",
      "sources": [
        "https://www.ibm.com/design/language/photography/tips-and-techniques",
        "https://design.gitlab.com/brand-design/photography"
      ],
      "prov": "published"
    },
    {
      "id": "focal-crop",
      "rule": "Crop on the subject, not the center.",
      "value": "Set object-position to the photo's focal point. The browser's default is 50% 50%, which crops the subject out of a square or tall frame. IBM: clear focal points, never an empty center.",
      "check": "Every object-fit: cover photo has object-position equal to its focal point; the focal point lies inside the visible box.",
      "sources": [
        "https://developer.mozilla.org/en-US/docs/Web/CSS/object-position",
        "https://www.ibm.com/design/language/photography/tips-and-techniques"
      ],
      "prov": "published"
    },
    {
      "id": "ratios",
      "rule": "Crop to a short list of ratios.",
      "value": "IBM: 16:9, 4:3, 3:2, 2:1 or 1:1. Airbnb: horizontal, because search crops to squares. Mozilla: 1:1 and 9:5 for thumbnails.",
      "check": "Every photo's rendered width ÷ height is within 1% of 16/9, 2, 3/2, 4/3 or 1; photos in one row share one ratio.",
      "sources": [
        "https://www.ibm.com/design/language/photography/tips-and-techniques",
        "https://www.airbnb.com/resources/hosting-homes/a/how-to-take-great-photos-for-your-listing-687",
        "https://web.archive.org/web/20250208010059/https://foundation.mozilla.org/en/docs/design/graphics/photography/"
      ],
      "prov": "published"
    },
    {
      "id": "text-zone",
      "rule": "Put text where the photo is quiet, never across a face.",
      "value": "GitLab: place text over the part with the least detail, ideally one color. Mozilla: avoid text over photos where you can.",
      "check": "Luminance standard deviation under the text box ≤ 0.06 (our measure); the text box overlaps no face or product.",
      "sources": [
        "https://design.gitlab.com/brand-design/photography",
        "https://web.archive.org/web/20250208010059/https://foundation.mozilla.org/en/docs/design/graphics/photography/"
      ],
      "prov": "published"
    },
    {
      "id": "text-contrast",
      "rule": "Text on a photo clears 4.5:1 against its brightest pixels.",
      "value": "WCAG 1.4.3: 4.5:1, or 3:1 for large text, and F83 fails background images without it. Our recipe: test against the brightest 2% of pixels under the text, and if it fails, add a scrim at the opacity that passes.",
      "check": "contrast(text, the 98th-percentile luminance under the text box, after scrim) ≥ 4.5 (≥ 3 at 24px or 18.66px bold).",
      "sources": [
        "https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html",
        "https://www.w3.org/WAI/WCAG22/Techniques/failures/F83"
      ],
      "prov": "published"
    },
    {
      "id": "one-treatment",
      "rule": "One treatment per piece.",
      "value": "Every photo in a piece gets the same treatment, from the pick table. GitLab: don't pair graphic overlays with text on one image. IBM: no added glare, overlays or effects.",
      "check": "Every img in the piece carries the same data-treatment; no photo carries both a graphic overlay and text.",
      "sources": [
        "https://design.gitlab.com/brand-design/photography",
        "https://www.ibm.com/design/language/photography/tips-and-techniques"
      ],
      "prov": "published"
    },
    {
      "id": "product-field",
      "rule": "Show the whole product on a plain field, with nothing on it.",
      "value": "Apple: product photos only on white, off-white, light gray or black, shown in their entirety, with no type, violators or graphics on them.",
      "check": "Product photo background is one flat color (luminance std dev ≤ 0.02 at the edges); no element overlaps the product's box.",
      "sources": [
        "https://apple.com/shop/Catalog/US/Images/affiliates/affiliate-banners-guide.pdf"
      ],
      "prov": "published"
    },
    {
      "id": "alt",
      "rule": "Alt text says what the photo shows, for this page.",
      "value": "W3C: informative images get alt text that conveys what they show; decorative ones get alt=\"\". Our reading: one sentence, no \"image of\" or \"photo of\", no file names.",
      "check": "Every img has an alt attribute; non-empty alt doesn't start with image/photo/picture of and doesn't match a file name or extension.",
      "sources": [
        "https://www.w3.org/WAI/tutorials/images/decision-tree/",
        "https://www.w3.org/WAI/tutorials/images/informative/"
      ],
      "prov": "published"
    },
    {
      "id": "weight",
      "rule": "Serve AVIF or WebP at the size it renders; never lazy-load the hero.",
      "value": "web.dev: WebP and AVIF compress better than JPEG and should be used where possible; don't lazy-load images likely in the viewport, and give the LCP image fetchpriority=\"high\". MDN: srcset and sizes let the browser pick the file. GitLab caps any web image at 2MB.",
      "check": "Every photo is a picture with AVIF and WebP sources, srcset widths and sizes, width and height set; the first in-viewport photo has no loading=\"lazy\" and has fetchpriority=\"high\"; no file over the rendered width × 2.",
      "sources": [
        "https://web.dev/articles/choose-the-right-image-format",
        "https://web.dev/articles/browser-level-image-lazy-loading",
        "https://web.dev/articles/optimize-lcp",
        "https://developer.mozilla.org/en-US/docs/Web/HTML/Guides/Responsive_images",
        "https://handbook.gitlab.com/handbook/marketing/digital-experience/engineering/image-guidelines/"
      ],
      "prov": "published"
    },
    {
      "id": "provenance",
      "rule": "Credit every photo, and label any that AI made.",
      "value": "EU AI Act Article 50: AI-generated images that resemble real people, places or events must be disclosed as artificially generated. GitLab: AI-generated images follow the same photo guidelines and go through brand review. Unsplash and Pexels ask for the photographer's credit.",
      "check": "Every photo carries data-source and data-license; a photo with data-ai=\"true\" shows a visible label; no AI image stands in for a named customer or employee.",
      "sources": [
        "https://artificialintelligenceact.eu/article/50/",
        "https://handbook.gitlab.com/handbook/marketing/brand-and-product-marketing/design/",
        "https://help.unsplash.com/en/articles/2511245-unsplash-api-guidelines"
      ],
      "prov": "published"
    }
  ],
  "mistakes": [
    {
      "name": "The globe for \"global\"",
      "what": "Earth from space for an international product, a lightbulb for ideas, a handshake for partners: the photo repeats the headline and shows nothing real.",
      "rule": "real-work"
    },
    {
      "name": "Center crop",
      "what": "A wide hero crops a portrait at 50% 50% and cuts off the heads.",
      "rule": "focal-crop"
    },
    {
      "name": "White text on a busy photo",
      "what": "A headline in white over foliage or a bright window, with no scrim, under 2:1 in places.",
      "rule": "text-contrast"
    },
    {
      "name": "Every photo graded differently",
      "what": "One duotone, one warm, one black and white, one raw: the page looks assembled from four sites.",
      "rule": "one-treatment"
    },
    {
      "name": "A 2,000px JPEG in a 400px card",
      "what": "The original file, lazy-loaded hero included, with no srcset, sizes or modern format.",
      "rule": "weight"
    },
    {
      "name": "AI faces as customers",
      "what": "A generated portrait over a made-up name and title in a testimonial, with no label.",
      "rule": "provenance"
    }
  ],
  "treatments": [
    {
      "id": "natural",
      "name": "Natural",
      "recipe": "No filter. Exposure and white balance corrected at source only.",
      "params": {},
      "css": "filter: none",
      "prov": "published",
      "sources": [
        "https://www.ibm.com/design/language/photography/tips-and-techniques"
      ]
    },
    {
      "id": "duotone",
      "name": "Duotone",
      "recipe": "Grayscale by luminance, contrast, then map shadows to {palette.ink} and highlights to {palette.accent}. If the accent is darker than the ink, swap them.",
      "params": {
        "shadows": "{palette.ink}",
        "highlights": "{palette.accent}",
        "contrast": 1.15
      },
      "css": "filter: url(#ph-duotone-{brand})",
      "prov": "our recipe",
      "why": "COLLINS describes Spotify's Lens as duotone screen-printing applied to third-party photos; it publishes no numbers. The contrast of 1.15 is ours.",
      "sources": [
        "https://www.wearecollins.com/work/spotify/",
        "https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feColorMatrix"
      ]
    },
    {
      "id": "warm",
      "name": "Warm grade",
      "recipe": "Shift every pixel toward the brand's warmest color by strength × (tint − its luminance), keeping luminance. Tint = the most saturated brand color with hue 0–70° or 330–360°.",
      "params": {
        "tint": "warmest brand color",
        "strength": 0.16
      },
      "css": "filter: url(#ph-warm-{brand})",
      "prov": "our recipe",
      "why": "No system we read publishes grade strengths. Starbucks asks for warm light in the studio. 0.16 was set by eye on the specimen set.",
      "sources": [
        "https://creative.starbucks.com/photography/"
      ]
    },
    {
      "id": "cool",
      "name": "Cool grade",
      "recipe": "The warm grade with the brand's coolest color: the most saturated with hue 170–260°.",
      "params": {
        "tint": "coolest brand color",
        "strength": 0.16
      },
      "css": "filter: url(#ph-cool-{brand})",
      "prov": "our recipe",
      "why": "Same reasoning as the warm grade, toward the cool end of the palette.",
      "sources": [
        "https://design.gitlab.com/brand-design/photography"
      ]
    },
    {
      "id": "grain",
      "name": "Grain",
      "recipe": "An overlay of fractal noise (baseFrequency 0.9, 2 octaves) in overlay blend at the set amount. Adds to one of the four above, never stands alone.",
      "params": {
        "amount": 0.18
      },
      "css": "mix-blend-mode: overlay; opacity: {amount}",
      "prov": "our recipe",
      "why": "Grain hides banding in duotone gradients. IBM forbids added effects for reportage, so the default is off; set amount only for duotone.",
      "sources": [
        "https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feTurbulence"
      ]
    },
    {
      "id": "scrim",
      "name": "Scrim",
      "recipe": "A gradient of {palette.night} under {palette.on_night} text (or {palette.paper} under {palette.ink}), at the lowest opacity that brings the text to 4.5:1 against the brightest and darkest 2% of pixels under it. A paper scrim must save 10 points of opacity to beat a night one.",
      "params": {
        "color": "{palette.night}",
        "opacity": "solved per photo",
        "target": 4.5
      },
      "css": "background: linear-gradient(to top, rgb({night} / {opacity}), transparent)",
      "prov": "our recipe",
      "why": "WCAG fails text over background images that don't give enough contrast; the 4.5:1 floor is WCAG's. Solving the opacity per photo is ours.",
      "sources": [
        "https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html",
        "https://www.w3.org/WAI/WCAG22/Techniques/failures/F83"
      ]
    }
  ],
  "sets": [
    {
      "id": "specimens",
      "name": "Steal specimen set",
      "source": "https://commons.wikimedia.org",
      "version": "2026-10-29",
      "license": "CC0 1.0 and public domain, per photo",
      "license_url": "https://creativecommons.org/publicdomain/zero/1.0/",
      "site": "https://commons.wikimedia.org",
      "kind": "hosted",
      "suits": "Drawing rules and treatments; placeholders in drafts.",
      "not_for": "A customer's real work: use their own photos first.",
      "knobs": [
        "photo id",
        "width 640 or 1280",
        "format avif, webp or jpg",
        "focal point",
        "treatment"
      ],
      "how": "Seven photos hosted beside this page, each with its source, author and license in credits.json. Use the focal point for object-position.",
      "credits": "https://unfairly.ai/steal/design/assets/photography/credits.json",
      "license_files": [
        "https://unfairly.ai/steal/design/assets/photography/LICENSE-CC0-1.0.txt",
        "https://unfairly.ai/steal/design/assets/photography/NOTICE-NASA.txt"
      ],
      "files": [
        {
          "id": "workshop",
          "alt": "A bagpipe maker holds up a chanter for a visitor in his workshop, pipes hanging behind them.",
          "focal": [
            56,
            24
          ],
          "kind": "reportage",
          "tags": [
            "craft",
            "people",
            "work",
            "indoor"
          ],
          "author": "Jaime Pereira",
          "license": "CC0 1.0",
          "source": "https://commons.wikimedia.org/wiki/File:Vitor_Felix_e_Jo%C3%A3o_Pimentel_na_Oficina_de_M%C3%BAsica.jpg",
          "zones": {
            "faces": {
              "box": [
                30,
                8,
                65,
                35
              ],
              "l_p2": 0.005,
              "l_p98": 0.527,
              "l_mean": 0.19,
              "detail": 0.169
            },
            "lower": {
              "box": [
                0,
                60,
                100,
                40
              ],
              "l_p2": 0.003,
              "l_p98": 0.593,
              "l_mean": 0.208,
              "detail": 0.189
            }
          },
          "urls": [
            "https://unfairly.ai/steal/design/assets/photography/workshop-640.avif",
            "https://unfairly.ai/steal/design/assets/photography/workshop-640.webp",
            "https://unfairly.ai/steal/design/assets/photography/workshop-640.jpg",
            "https://unfairly.ai/steal/design/assets/photography/workshop-1280.avif",
            "https://unfairly.ai/steal/design/assets/photography/workshop-1280.webp",
            "https://unfairly.ai/steal/design/assets/photography/workshop-1280.jpg"
          ]
        },
        {
          "id": "creek",
          "alt": "A hiker with two poles walks a log bridge over a lily pond while a friend photographs him.",
          "focal": [
            28,
            40
          ],
          "kind": "reportage",
          "tags": [
            "outdoor",
            "people",
            "candid"
          ],
          "author": "Vsatinet",
          "license": "CC0 1.0",
          "source": "https://commons.wikimedia.org/wiki/File:Crossing_a_creek.jpg",
          "zones": {
            "busy": {
              "box": [
                0,
                55,
                100,
                45
              ],
              "l_p2": 0.001,
              "l_p98": 0.734,
              "l_mean": 0.233,
              "detail": 0.215
            }
          },
          "urls": [
            "https://unfairly.ai/steal/design/assets/photography/creek-640.avif",
            "https://unfairly.ai/steal/design/assets/photography/creek-640.webp",
            "https://unfairly.ai/steal/design/assets/photography/creek-640.jpg",
            "https://unfairly.ai/steal/design/assets/photography/creek-1280.avif",
            "https://unfairly.ai/steal/design/assets/photography/creek-1280.webp",
            "https://unfairly.ai/steal/design/assets/photography/creek-1280.jpg"
          ]
        },
        {
          "id": "snow",
          "alt": "Hikers walk down a snowy ridge below dark mountains.",
          "focal": [
            86,
            74
          ],
          "kind": "landscape",
          "tags": [
            "outdoor",
            "people",
            "negative-space"
          ],
          "author": "DimiTalen",
          "license": "CC0 1.0",
          "source": "https://commons.wikimedia.org/wiki/File:Hiking_down_the_C%C3%B4tes_Souveraines,_Huez_and_Villard-Reculas,_2026.jpg",
          "zones": {
            "quiet": {
              "box": [
                30,
                78,
                40,
                22
              ],
              "l_p2": 0.709,
              "l_p98": 0.777,
              "l_mean": 0.749,
              "detail": 0.017
            },
            "sky": {
              "box": [
                0,
                0,
                100,
                22
              ],
              "l_p2": 0.02,
              "l_p98": 0.737,
              "l_mean": 0.105,
              "detail": 0.168
            }
          },
          "urls": [
            "https://unfairly.ai/steal/design/assets/photography/snow-640.avif",
            "https://unfairly.ai/steal/design/assets/photography/snow-640.webp",
            "https://unfairly.ai/steal/design/assets/photography/snow-640.jpg",
            "https://unfairly.ai/steal/design/assets/photography/snow-1280.avif",
            "https://unfairly.ai/steal/design/assets/photography/snow-1280.webp",
            "https://unfairly.ai/steal/design/assets/photography/snow-1280.jpg"
          ]
        },
        {
          "id": "room",
          "alt": "A period living room in daylight: a round table, a tall wardrobe and a patterned tile floor.",
          "focal": [
            47,
            52
          ],
          "kind": "interior",
          "tags": [
            "interior",
            "daylight"
          ],
          "author": "יעקב (Yaakov)",
          "license": "CC0 1.0",
          "source": "https://commons.wikimedia.org/wiki/File:Living_room_in_Beit_HaRishonim_(Herzliya)_7887.jpg",
          "zones": {
            "top": {
              "box": [
                0,
                0,
                100,
                30
              ],
              "l_p2": 0.007,
              "l_p98": 1,
              "l_mean": 0.513,
              "detail": 0.349
            }
          },
          "urls": [
            "https://unfairly.ai/steal/design/assets/photography/room-640.avif",
            "https://unfairly.ai/steal/design/assets/photography/room-640.webp",
            "https://unfairly.ai/steal/design/assets/photography/room-640.jpg",
            "https://unfairly.ai/steal/design/assets/photography/room-1280.avif",
            "https://unfairly.ai/steal/design/assets/photography/room-1280.webp",
            "https://unfairly.ai/steal/design/assets/photography/room-1280.jpg"
          ]
        },
        {
          "id": "loafer",
          "alt": "A brown leather penny loafer, side on, on a white background.",
          "focal": [
            58,
            56
          ],
          "kind": "still-life",
          "tags": [
            "product",
            "seamless"
          ],
          "author": "Wikipedia-ce",
          "license": "CC0 1.0",
          "source": "https://commons.wikimedia.org/wiki/File:A_Penny_Loafer.jpg",
          "zones": {
            "quiet": {
              "box": [
                0,
                0,
                45,
                30
              ],
              "l_p2": 0.905,
              "l_p98": 0.991,
              "l_mean": 0.95,
              "detail": 0.084
            }
          },
          "urls": [
            "https://unfairly.ai/steal/design/assets/photography/loafer-640.avif",
            "https://unfairly.ai/steal/design/assets/photography/loafer-640.webp",
            "https://unfairly.ai/steal/design/assets/photography/loafer-640.jpg",
            "https://unfairly.ai/steal/design/assets/photography/loafer-1280.avif",
            "https://unfairly.ai/steal/design/assets/photography/loafer-1280.webp",
            "https://unfairly.ai/steal/design/assets/photography/loafer-1280.jpg"
          ]
        },
        {
          "id": "coffee",
          "alt": "Coffee with milk in a white mug on a wooden table.",
          "focal": [
            44,
            40
          ],
          "kind": "still-life",
          "tags": [
            "product",
            "shallow",
            "close-up"
          ],
          "author": "Kurt Kaiser",
          "license": "CC0 1.0",
          "source": "https://commons.wikimedia.org/wiki/File:Coffee_in_a_mug.jpg",
          "zones": {
            "bottom": {
              "box": [
                0,
                80,
                100,
                20
              ],
              "l_p2": 0.015,
              "l_p98": 0.264,
              "l_mean": 0.141,
              "detail": 0.057
            }
          },
          "urls": [
            "https://unfairly.ai/steal/design/assets/photography/coffee-640.avif",
            "https://unfairly.ai/steal/design/assets/photography/coffee-640.webp",
            "https://unfairly.ai/steal/design/assets/photography/coffee-640.jpg",
            "https://unfairly.ai/steal/design/assets/photography/coffee-1280.avif",
            "https://unfairly.ai/steal/design/assets/photography/coffee-1280.webp",
            "https://unfairly.ai/steal/design/assets/photography/coffee-1280.jpg"
          ]
        },
        {
          "id": "aurora",
          "alt": "The US Midwest at night from the International Space Station, city lights under a green aurora.",
          "focal": [
            55,
            62
          ],
          "kind": "aerial",
          "tags": [
            "globe",
            "space",
            "night"
          ],
          "author": "Mike Fossum, NASA",
          "license": "Public domain (NASA)",
          "source": "https://images.nasa.gov/details/iss029e012564",
          "zones": {
            "quiet": {
              "box": [
                0,
                14,
                100,
                22
              ],
              "l_p2": 0.001,
              "l_p98": 0.013,
              "l_mean": 0.003,
              "detail": 0.004
            }
          },
          "urls": [
            "https://unfairly.ai/steal/design/assets/photography/aurora-640.avif",
            "https://unfairly.ai/steal/design/assets/photography/aurora-640.webp",
            "https://unfairly.ai/steal/design/assets/photography/aurora-640.jpg",
            "https://unfairly.ai/steal/design/assets/photography/aurora-1280.avif",
            "https://unfairly.ai/steal/design/assets/photography/aurora-1280.webp",
            "https://unfairly.ai/steal/design/assets/photography/aurora-1280.jpg"
          ]
        }
      ]
    },
    {
      "id": "unsplash",
      "name": "Unsplash API",
      "source": "https://unsplash.com/developers",
      "version": "API v1, read 2026-10-29",
      "license": "Unsplash License",
      "license_url": "https://unsplash.com/license",
      "site": "https://unsplash.com/developers",
      "kind": "api",
      "suits": "Real-world scenes, people at work, places; large, current catalog.",
      "not_for": "Re-hosting, building a gallery of its photos, or selling unaltered prints.",
      "knobs": [
        "query",
        "orientation: landscape, portrait, squarish",
        "color: black_and_white, black, white, yellow, orange, red, purple, magenta, green, teal, blue",
        "content_filter: low or high",
        "imgix on urls.raw: w, h, fit, crop, fm, q, auto=format, dpr"
      ],
      "how": "At runtime, through a server proxy holding the key: search, hotlink the returned photo.urls (keep ixid), credit the photographer and Unsplash with links carrying ?utm_source=<app>&utm_medium=referral, and call links.download_location when a photo is chosen. Demo keys allow 50 requests an hour, production 1,000.",
      "terms": [
        "https://help.unsplash.com/en/articles/2511245-unsplash-api-guidelines",
        "https://unsplash.com/documentation"
      ]
    },
    {
      "id": "pexels",
      "name": "Pexels API",
      "source": "https://www.pexels.com/api/",
      "version": "API v1, read 2026-10-29",
      "license": "Pexels License",
      "license_url": "https://www.pexels.com/license/",
      "site": "https://www.pexels.com/api/",
      "kind": "api",
      "suits": "Lifestyle, food, work scenes; ready-cropped portrait and landscape files.",
      "not_for": "Redistributing on another stock or wallpaper platform, implying the people endorse the product, use in a trademark.",
      "knobs": [
        "query",
        "orientation: landscape, portrait, square",
        "size: large, medium, small",
        "color: name or hex",
        "locale",
        "per_page up to 80"
      ],
      "how": "At runtime: show a prominent link to Pexels, credit as \"Photo by <name> on Pexels\" linked to the photo page, and pick from src (original, large2x, large, medium, small, portrait 800×1200, landscape 1200×627, tiny). 200 requests an hour, 20,000 a month.",
      "terms": [
        "https://www.pexels.com/api/documentation/"
      ]
    },
    {
      "id": "openverse",
      "name": "Openverse",
      "source": "https://openverse.org",
      "version": "API v1, read 2026-10-29",
      "license": "CC0 and Public Domain Mark (filter)",
      "license_url": "https://creativecommons.org/publicdomain/zero/1.0/",
      "site": "https://openverse.org",
      "kind": "api",
      "suits": "Searching many open collections at once, filtered to no-attribution licenses.",
      "not_for": "Trusting the index: each result's license is the source's claim.",
      "knobs": [
        "q",
        "license=cc0,pdm",
        "source",
        "aspect_ratio",
        "size"
      ],
      "how": "GET api.openverse.org/v1/images/?q=<query>&license=cc0,pdm, then open each result's foreign_landing_url and confirm the license there before use. Anonymous: 20 requests a minute, 200 a day (from the API's response headers).",
      "terms": [
        "https://api.openverse.org/v1/"
      ]
    },
    {
      "id": "commons",
      "name": "Wikimedia Commons",
      "source": "https://commons.wikimedia.org",
      "version": "MediaWiki API, read 2026-10-29",
      "license": "Per file; filter to CC0 and public domain",
      "license_url": "https://commons.wikimedia.org/wiki/Commons:Reusing_content_outside_Wikimedia",
      "site": "https://commons.wikimedia.org",
      "kind": "api",
      "suits": "Documentary photos of real places, crafts, events and objects.",
      "not_for": "Files tagged with personality rights for ads; museum objects whose own copyright isn't settled.",
      "knobs": [
        "search with incategory:CC-zero",
        "prop=imageinfo with extmetadata (LicenseShortName, Artist, Restrictions)",
        "thumb widths 640, 1280, 1920"
      ],
      "how": "Read the license on each file's description page. Attribution isn't required for public domain but Commons recommends it, and personality rights and trademarks still apply. Skip any file with a Restrictions value.",
      "terms": [
        "https://commons.wikimedia.org/wiki/Commons:Reusing_content_outside_Wikimedia"
      ]
    },
    {
      "id": "nasa",
      "name": "NASA Image and Video Library",
      "source": "https://images.nasa.gov",
      "version": "images-api.nasa.gov, read 2026-10-29",
      "license": "Generally not copyrighted in the US",
      "license_url": "https://www.nasa.gov/nasa-brand-center/images-and-media/",
      "site": "https://images.nasa.gov",
      "kind": "api",
      "suits": "Earth, space, aerial and science imagery.",
      "not_for": "Anything that implies NASA endorses a product; the NASA insignia; current astronauts' likeness in ads.",
      "knobs": [
        "q",
        "media_type=image",
        "center",
        "year_start, year_end"
      ],
      "how": "GET images-api.nasa.gov/search, then /asset/<nasa_id> for sizes. Credit NASA as the source.",
      "terms": [
        "https://www.nasa.gov/nasa-brand-center/images-and-media/"
      ]
    }
  ],
  "runtime": {
    "keys_configured": [],
    "rule": "Unsplash and Pexels are runtime-only: search through a server proxy that holds the key, hotlink the returned URLs, show the credit, and (Unsplash) call download_location when a photo is chosen. Never download and re-host their files."
  },
  "gaps": [
    "No system we read publishes grade strengths, grain amounts or scrim opacities; ours are labelled our recipe.",
    "No system publishes a threshold for a quiet text zone; 0.06 luminance standard deviation is our measure.",
    "Mozilla's Foundation photography page is offline; we read the February 2025 archive.",
    "The Mozilla, Mailchimp and Dropbox brand books publish no photo treatment, so the pick table decides for all three.",
    "No Unsplash or Pexels key is configured, so this page draws only hosted CC0 and public-domain photos."
  ]
}