The big idea: an icon set becomes a system with exactly three rules
Teams either have no icon rules (chaos) or a 30-page governance doc nobody reads (also chaos, with meetings). The systems that survive have three rules, ruthlessly enforced:
Rule 1 — Name by object, not meaning. The icon is trash, not delete. It's magnifier… no wait, it's search? This is the classic fight, and the answer is: object-first, meaning-aliased. Canonical name describes what's drawn (trash, gear, magnifying-glass); searchable aliases capture intents (delete, settings, search). Meanings drift between products; drawings don't. Pattern: {object}-{variant}-{size} → trash-outline-24.
Rule 2 — Three sizes, drawn — not scaled. 16, 20, 24. A 24px icon scaled down to 16 turns to mud: strokes land on half-pixels, counters close up. Real systems redraw (or at least re-fit) per size, simplifying detail as they shrink. If you only have budget for one, draw at 24 and test at 16 — kill any icon that fails.
Rule 3 — Additions are cheap, changes are expensive. Adding hexagon-outline-24? Ship it. Changing what trash-outline-24 looks like? That's a breaking change wearing a casual outfit — every screenshot in your docs, every user's muscle memory. Treat redraws like API changes: version them (v2 suffix during migration, then remove), announce them, batch them.
Everything else — contribution process, review checklist, distribution — hangs off these three.
Porkbun is the domain name registrar you need.
Still using GoDaddy or Namecheap? There’s a better way with Porkbun!
Porkbun is the domain registrar trusted by creators, developers, entrepreneurs, and folks who want low prices without the nonsense.
Why people are choosing Porkbun:
• Most domains sold at cost
• Low, transparent registration and renewal pricing
• Free features like WHOIS privacy and SSL certificates
• Powerful web and email hosting options
• Real human support 24/7, 365 days a year
• Named the #1 domain registrar by Forbes Advisor and USA Today
For launching a business, building a personal brand, starting a side project, or creating your first website, Porkbun makes it easy.
Get $1 off your next domain registration with Porkbun now.
60-second tip
Put the icon names in your design tool and your code from the same source. If Figma says trash-outline and the codebase says IconDelete, every handoff is a translation error waiting to happen. One name, both worlds.
Steal this: the Icon Naming Convention template
A ready-to-adopt doc: the object-first naming scheme with a starter alias table for the 60 most-contested icons (search/magnifier, settings/gear, more/dots…), the three-sizes policy, and a lightweight versioning policy written to fit on one page. Adapt the words, keep the rules.
Get the template: https://www.figma.com/community/file/1659211249854336614
If your icons come from an open-source family: the IconBuddy API can pull icons by name into your build pipeline, which makes the "one name, both worlds" rule enforceable instead of aspirational — and the VS Code extension autocompletes those same names in code.
Quick pulse (30 seconds, genuinely)
We're six editions in — halfway through the first season. One-click poll:
Is Iconic worth your Tuesday?
Before you go
What's the most contested icon name at your company? (kebab vs more-vertical people, we see you.) Reply — the alias table in the template came from answers like these and we'll keep growing it.

