football-logos
287
installs
287
this week
version
stars
Hotlink football club and league crests in React, Vue, Svelte, or Astro. Pass a country and club — get a 512×512 PNG URL.
Library / TypeScript / npm
Overview
football-logos is an npm package for dropping football crests into an app. You pass a country and a club (or league); it returns a public 512×512 PNG URL on assets.football-logos.cc. Artwork stays on football-logos.cc — the package ships the identifiers and content hashes that build those URLs.
Built as a companion to BallGuessr.
Key Features
<FootballLogo />for React, Vue, Svelte, and AstrogetFootballLogoUrl()for any other framework- Catalog of 228 countries plus international competitions
- Clubs, leagues, national teams, and tournaments
- Content-hashed filenames so a stored
srcstays valid when the catalog updates
Technologies Used
- TypeScript
- React / Vue / Svelte / Astro wrappers
- VitePress (docs)
Links
Note
football-logos is not affiliated with football-logos.cc. Club and league marks belong to their owners; image use follows football-logos.cc/license.