Skip to content

v0.1.0

Choose a tag to compare

@pallaoro pallaoro released this 29 Jul 12:32

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 · gstatic

Resolution 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

  • format is 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.com and
    ~630 Azure marks list azure.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 in ambiguous-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.