Icon Standard

One delivery layer, one set per job - never pick outside this table without asking.

The table

Delivery - always Iconify

https://api.iconify.design/{prefix}:{name}.svg?color=%23{hex}

• Browse/search all sets at once: icones.js.org (slug shown is the prefix:name to use). Programmatic search: https://api.iconify.design/search?query=X&prefixes=tabler,noto,selfhst
• In web projects, use the npm package (@tabler/icons-svelte), not hotlinks.
• Hotlinked icons (Notion etc.): if api.iconify.design ever flakes, mirror the used SVGs to an R2 bucket at stable paths - same slugs, new host.

A project's own icon (favicon, app icon)

Every site and app ships its own icon. A missing, blank, stock or template-default icon is a bug. One rule for every platform:

• Depict THIS project: its subject and its function together. A ticket tracker for a festival gets the festival's logo merged with a ticket glyph, not a bare ticket. The sets in the table are raw material to compose, recolor and overlay into one SVG, never the finished icon on their own.
• One SVG master, explicit fill/stroke attributes (rasterizers ignore <style> rules), one palette that reads on light and dark backgrounds (Quick Look renders the dark branch of a prefers-color-scheme style).
• Rasterize with Quick Look, no dependencies: qlmanage -t -s 1024 -o <dir> icon.svg. Quick Look flattens transparency onto white, so art that must keep transparent corners (the macOS rounded square) goes through rsvg-convert instead (nix shell nixpkgs#librsvg).
• Judge it small. Look at the 16-32 px rendering; detail that disappears there comes out.
• Verify where it is shown: the browser tab, the home screen, the Dock, Finder. A letter monogram, a grey plate or a white halo is a failure.

The Apple templates gate it: once the app is named, just check fails while the icon is missing or still the placeholder.

Notion page icons

Whether a new page gets an icon follows the workspace's own rule (a private workspace skill may define it). When it does, choose by subject via the table above; for DB entries follow the DB's existing icon pattern (query siblings if unsure).

Workspace custom emoji are for irreplaceable personal icons - brand/app logos default to Iconify (selfhst:/simple-icons:) like everything else.

Set via API as external URLs:

{"icon": {"type": "external", "external": {"url": "https://api.iconify.design/noto:broccoli.svg"}}}

• Notion's own built-in icons are also URL-addressable - https://www.notion.so/icons/{name}_{color}.svg - fine for system/DB pages that should feel Notion-native.
• Existing emoji icons on pages are fine; don't churn them.

Gotchas

• No mono/tinted silhouettes as Notion page icons (game-icons etc.) - the flat one-color look clashes with Noto. If a set with CC BY licensing ever IS used on a published site, it needs attribution.
• Manual-only icon workflows stage files for a human upload. 1Password item icons have no API/CLI - export PNGs (the selfhst CDN serves them directly) to a staging folder for manual upload.
• Never SF Symbols outside Apple-platform app UI (license forbids), never Font Awesome / Flaticon / Icons8 / freemium tiers (Hugeicons, Streamline).