# theSVG

> The largest open-source brand SVG icon library for developers, designers, and AI agents.

## About

theSVG provides 7,412+ SVG icons across 7 collections: Brand Icons, AWS Architecture, Azure Services, Google Cloud, Kubernetes, Community, and Auth Badges. Each icon supports multi-variant rendering (color, mono, light, dark, wordmark). Available as npm packages, React components, CLI, REST API, CDN, and MCP server.

## Links

- Website: https://thesvg.org
- Compare Libraries: https://thesvg.org/compare
- GitHub: https://github.com/glincker/thesvg
- npm: https://www.npmjs.com/package/thesvg
- Submit Icon: https://thesvg.org/submit
- Extensions: https://thesvg.org/extensions
- Contact: https://thesvg.org/contact
- Full LLM context: https://thesvg.org/llms-full.txt

## Packages

- `thesvg` - 7,412+ icons - tree-shakeable, typed, dual ESM/CJS. The one-stop brand icon library.
- `@thesvg/icons` - Tree-shakeable SVG icon components and raw SVG strings from thesvg.org - 7,412+ icons
- `@thesvg/react` - Typed React SVG components for all 7,412+ icons from thesvg.org
- `@thesvg/cli` - CLI tool to add SVG icons from thesvg.org to your project
- `@thesvg/mcp-server` - MCP server for searching and fetching 7,412+ icons from thesvg.org
- `@thesvg/react-native` - Typed React Native SVG components for all 7,412+ icons from thesvg.org
- `@thesvg/vue` - Typed Vue 3 SVG components for all 7,412+ icons from thesvg.org
- `@thesvg/svelte` - Typed Svelte SVG components for all 7,412+ icons from thesvg.org

## API

thesvg ships as a static site. There are no dynamic search endpoints; fetch the manifest once and filter client-side.

Base URL: https://thesvg.org

- `GET /icons/{slug}/{variant}.svg` - Direct SVG file (CDN)
- `GET /api/registry.json` - Full icon manifest (slug, title, aliases, categories, hex, url, license, variant keys)
- `GET /api/categories.json` - All categories with counts

No authentication required. CORS enabled. A gated, token-based API at api.thesvg.org is on the roadmap for advanced search and analytics.

## Icon Variants

Each icon can have up to 7 variants:
- `default` - Primary brand color (always present)
- `mono` - Single color, inherits text color
- `light` - White, for dark backgrounds
- `dark` - Black, for light backgrounds
- `wordmark` - Full text logo
- `wordmarkLight` - White text logo
- `wordmarkDark` - Dark text logo

## CDN Usage

```
https://thesvg.org/icons/{slug}/{variant}.svg
https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/{slug}/{variant}.svg
```

## Categories

136 categories including: Accessibility, Advertising, Agency, AI, Analytics, AntV, App Services, Architecture, Automation, Automotive, Autoscaling, Aviation, Azure Ecosystem, Azure Stack, Blockchain, Booking, Browser, Business, Canonical, Caravaning, Cloud, CMS, Communication, Community, Compiler, Compute, Config, Construction, Containers, Control Plane, Cost Management, Crypto, Customer Enablement, Customer Experience, Data, and more.

## Legal

All brand icons are property of their respective owners. Provided for identification and development purposes under nominative fair use. See https://thesvg.org/legal and TRADEMARK.md.