v0.1.0
First release.
Resolves a domain, URL, email address, or brand name to a logo URL.
theSVG supplies real vectors for 6,492 brands; Google's favicon endpoint
covers everything else as PNG.
import { logo } from "@clawnify/logokit";
logo("stripe.com"); // svg · thesvg
logo("acme-inc.io"); // png · gstaticResolution is offline. A generated index maps 3,547 domains and 5,399 name
forms onto slugs, so a miss costs nothing and never burns a request.
Notes
formatis part of the contract. The fallback tier only ever returns raster,
so callers are told what they got rather than handed a favicon that looks like
a vector until it scales.format: "vector"opts out of the fallback.- Shared homepages are never guessed. ~500 OSS projects list
github.comand
~630 Azure marks listazure.microsoft.com; mapping a shared domain to an
arbitrary member returns the wrong brand. The 71 domains that stay ambiguous
are dropped to the favicon tier and listed inambiguous-domains.json. - Providers are plain objects and the chain is an ordered array, so adding a
source is a local change.
Logos are trademarks of their respective owners, referenced for identification
under nominative fair use. Per-mark licenses vary — see NOTICE.md.