thesvg
<p align="center"> <a href="https://thesvg.org"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/glincker/thesvg/main/public/logo-wordmark.svg" /> <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/glincker/thesvg/main/public/logo-wordmark-dark.svg" /> <img src="https://raw.githubusercontent.com/glincker/thesvg/main/public/logo-wordmark-dark.svg" alt="theSVG" height="48" /> </picture> </a> </p> <p align="center"> <strong>6,100+ SVG icons. Brands, AWS, Azure, GCP, and more. Search, copy, ship.</strong> </p> <p align="center"> <a href="https://www.npmjs.com/package/thesvg"><img src="https://img.shields.io/npm/v/thesvg?style=flat-square&color=F97316&label=npm" alt="npm" /></a> <a href="https://www.npmjs.com/package/thesvg"><img src="https://img.shields.io/npm/dm/thesvg?style=flat-square&color=F97316&label=downloads" alt="downloads" /></a> <a href="https://github.com/glincker/thesvg/stargazers"><img src="https://img.shields.io/github/stars/glincker/thesvg?style=flat-square&label=stars" alt="stars" /></a> <a href="https://github.com/glincker/thesvg"><img src="https://img.shields.io/badge/icons-6%2C100%2B-F97316?style=flat-square" alt="6,100+ icons" /></a> <a href="https://github.com/glincker/thesvg/blob/main/LICENSE"><img src="https://img.shields.io/github/license/glincker/thesvg?style=flat-square" alt="license" /></a> <a href="https://www.figma.com/community/plugin/1612997159050367763"><img src="https://img.shields.io/badge/Figma-Plugin-F24E1E?style=flat-square&logo=figma&logoColor=white" alt="Figma" /></a> <a href="https://marketplace.visualstudio.com/items?itemName=glincker.thesvg"><img src="https://img.shields.io/visual-studio-marketplace/v/glincker.thesvg?style=flat-square&color=007ACC&label=VS%20Code&logo=visualstudiocode" alt="VS Code" /></a> <a href="https://www.raycast.com/thegdsks/thesvg"><img src="https://img.shields.io/badge/Raycast-Store-FF6363?style=flat-square&logo=raycast" alt="Raycast" /></a> <a href="https://github.com/glincker/thesvg/tree/main/extensions/neovim"><img src="https://img.shields.io/badge/Neovim-Plugin-019733?style=flat-square&logo=neovim&logoColor=white" alt="Neovim" /></a> <a href="https://github.com/glincker/thesvg/tree/main/extensions/alfred"><img src="https://img.shields.io/badge/Alfred-Workflow-5C1F87?style=flat-square&logo=alfred&logoColor=white" alt="Alfred" /></a> <a href="https://github.com/glincker/thesvg/tree/main/extensions/browser"><img src="https://img.shields.io/badge/Chrome-Coming%20Soon-4285F4?style=flat-square&logo=googlechrome&logoColor=white" alt="Chrome" /></a> <a href="https://skills.sh/glincker/thesvg"><img src="https://skills.sh/b/glincker/thesvg" alt="skills.sh" /></a> <a href="https://github.com/glincker/homebrew-thesvg"><img src="https://img.shields.io/badge/Homebrew-thesvg-FBB040?style=flat-square&logo=homebrew&logoColor=white" alt="Homebrew" /></a> </p> <p align="center"> <a href="https://thesvg.org"><strong>Browse Icons</strong></a> • <a href="#install">Install</a> • <a href="#extensions">Extensions</a> • <a href="#cdn">CDN</a> • <a href="#api">API</a> • <a href="#packages">Packages</a> • <a href="https://thesvg.org/compare">Compare</a> • <a href="#contributing">Contribute</a> </p> <br /> <p align="center"> <a href="https://thesvg.org"> <img src="https://raw.githubusercontent.com/glincker/thesvg/main/public/og-image.png" alt="theSVG - 6,100+ SVG icons for developers" width="720" /> </a> </p> <br /> ## Why theSVG? Most icon libraries focus on UI icons. Brand logos are scattered across press kits, Figma files, and random GitHub repos. **theSVG** is the single source for SVG icons - brand logos, cloud architecture diagrams, and more. Searchable, versioned, and available as npm packages, CDN, CLI, API, and MCP server. - **6,100+ icons** across multiple collections - **4,400+ brand icons** across 55+ categories - **739 AWS Architecture icons** (2026-Q1) - **626 Azure Service icons** (2026-Q1) - **214 Google Cloud icons** (2026-Q1) - **8,400+ SVG variants** - color, mono, light, dark, wordmark - **Tree-shakeable** - import one icon, ship only that icon - **TypeScript-first** - fully typed, dual ESM/CJS - **Framework-agnostic** - React, Vue, Svelte, plain HTML, or CDN - **AI-ready** - MCP server for Claude, Cursor, and Windsurf ## Collections theSVG organizes icons into collections: | Collection | Icons | Description | |------------|-------|-------------| | **Brand Icons** | 4,487 | Brand logos from 55+ categories | | **AWS Architecture** | 739 | Official AWS service, resource, category, and group icons (2026-Q1) | | **Azure Services** | 626 | Microsoft Azure service icons (2026-Q1) | | **Google Cloud** | 214 | Google Cloud Platform icons (2026-Q1) | ### AWS Architecture Icons Browse all AWS service and resource icons at [thesvg.org/collection/aws](https://thesvg.org/collection/aws). Icons are sourced from the official [AWS Architecture Icons](https://aws.amazon.com/architecture/icons/) package and distributed unmodified under [CC BY-ND 2.0](https://creativecommons.org/licenses/by-nd/2.0/). Updated quarterly. ## Install **npm** ```bash npm install thesvg ``` **Homebrew** ```bash brew tap glincker/thesvg brew install thesvg ``` ```ts import github from "thesvg/github"; github.svg; // raw SVG string github.title; // "GitHub" github.hex; // "181717" github.variants; // { default: "<svg...>", mono: "<svg...>" } ``` Or use the scoped package for tree-shaking: ```bash npm install @thesvg/icons ``` ## Packages | Package | Description | | |---------|-------------|---| | [`thesvg`](https://www.npmjs.com/package/thesvg) | All icons in one package | [](https://www.npmjs.com/package/thesvg) | | [`@thesvg/icons`](https://www.npmjs.com/package/@thesvg/icons) | Core icon data, tree-shakeable | [](https://www.npmjs.com/package/@thesvg/icons) | | [`@thesvg/react`](https://www.npmjs.com/package/@thesvg/react) | Typed React components | [](https://www.npmjs.com/package/@thesvg/react) | | [`@thesvg/vue`](https://www.npmjs.com/package/@thesvg/vue) | Typed Vue 3 components | [](https://www.npmjs.com/package/@thesvg/vue) | | [`@thesvg/svelte`](https://www.npmjs.com/package/@thesvg/svelte) | Typed Svelte components | [](https://www.npmjs.com/package/@thesvg/svelte) | | [`@thesvg/cli`](https://www.npmjs.com/package/@thesvg/cli) | CLI tool (`npx @thesvg/cli add github`) | [](https://www.npmjs.com/package/@thesvg/cli) | | [`@thesvg/mcp-server`](https://www.npmjs.com/package/@thesvg/mcp-server) | MCP server for AI assistants | [](https://www.npmjs.com/package/@thesvg/mcp-server) | ## Extensions Use theSVG icons everywhere you build, design, and ship. Browse the full ecosystem at [thesvg.org/extensions](https://thesvg.org/extensions). | Extension | Status | Description | |-----------|--------|-------------| | [Figma Plugin](https://www.figma.com/community/plugin/1612997159050367763) | Published | Browse 6,100+ brand SVGs, variant picker, recents row, keyboard shortcuts. Insert as editable vectors. | | [VS Code](https://marketplace.visualstudio.com/items?itemName=glincker.thesvg) | Published | Search 6,100+ icons from the command palette. Copy SVG, JSX, CDN link, or insert at cursor. | | [Raycast](https://www.raycast.com/thegdsks/thesvg) | Published | Search, preview, and copy any brand SVG in one keystroke. Filter by category, preview variants. | | [MCP Server](https://www.npmjs.com/package/@thesvg/mcp-server) | Published | AI tool calls for Claude, Cursor, Windsurf. Fetch icons by name or category. | | [Agent Skill](https://skills.sh/glincker/thesvg) | Published | Drop-in skill for AI agents. Install via `npx skills add glincker/thesvg`. Teaches the icon CDN and registry. | | [`@thesvg/cli`](https://www.npmjs.com/package/@thesvg/cli) | Published | shadcn-style installer. `npx @thesvg/cli add github` drops the SVG into your project. | | [Homebrew](https://github.com/glincker/homebrew-thesvg) | Published | `brew tap glincker/thesvg && brew install thesvg` | | [CDN via jsDelivr](https://www.jsdelivr.com/package/gh/glincker/thesvg) | Published | Serve any icon via global CDN. Drop into HTML, CSS, Markdown, Notion, Webflow, Framer. | | [Browser Extension](https://github.com/glincker/thesvg/tree/main/extensions/browser) | Beta | Chrome, Firefox, Edge popup with 6,100+ brand SVGs. MV3, no telemetry. | | [JetBrains](https://github.com/glincker/thesvg/issues?q=label%3Aextension) | Open | IntelliJ, WebStorm, PyCharm, Rider tool window. Help wanted. | | [Neovim](https://github.com/glincker/thesvg/tree/main/extensions/neovim) | Published | Lua plugin with Telescope picker. Insert SVG URL or inline content at cursor. | | [Alfred Workflow](https://github.com/glincker/thesvg/tree/main/extensions/alfred) | Published | macOS quick access. Search anywhere, copy SVG, CDN URL, or markdown. | | [Sketch / Blender / Webflow / Notion](https://github.com/glincker/thesvg/issues?q=label%3Aextension) | Open | Tracking issues open. Build a plugin and we will list it here. | > **Build your own:** the API and CDN are fully open with no auth required. Ship a plugin or workflow, then open a PR and we will add it to the table. ## CDN Use any icon directly without installing: ```html <!-- From thesvg.org --> <img src="https://thesvg.org/icons/github/default.svg" width="32" height="32" alt="GitHub" /> <!-- From jsDelivr --> <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/github/default.svg" width="32" height="32" alt="GitHub" /> ``` **URL pattern:** `https://thesvg.org/icons/{slug}/{variant}.svg` ## Usage ### React ```tsx import { Github, Figma } from "@thesvg/react"; export function Logos() { return <Github width={24} height={24} className="text-white" />; } ``` ### Vue ```vue <script setup> import { Github, Figma } from "@thesvg/vue"; </script> <template> <Github width="24" height="24" /> </template> ``` ### Svelte ```svelte <script> import { Github, Figma } from "@thesvg/svelte"; </script> <Github width="24" height="24" /> ``` ### CDN ```html <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/github/default.svg" width="32" height="32" alt="GitHub" /> ``` ### CLI ```bash npx @thesvg/cli add github npx @thesvg/cli search "ai" ``` ## Variants Icons support up to 7 variants to match any design context: | Variant | Key | Description | |---------|-----|-------------| | Default | `default` | Primary brand color | | Mono | `mono` | Inherits text color | | Light | `light` | White, for dark backgrounds | | Dark | `dark` | Black, for light backgrounds | | Wordmark | `wordmark` | Full text logo | | Wordmark Light | `wordmarkLight` | White text logo | | Wordmark Dark | `wordmarkDark` | Dark text logo | Not every icon has all variants. `default` is always present. ## API thesvg ships as a fully static site, served from a CDN. There is no dynamic API; instead, two pre-built JSON manifests cover every use case. Search, filter, and pagination happen on the client. Base URL: `https://thesvg.org` | Endpoint | Description | |----------|-------------| | `GET /api/registry.json` | Full icon manifest (slug, title, aliases, categories, hex, url, variant keys) | | `GET /api/categories.json` | Category list with counts | | `GET /icons/{slug}/{variant}.svg` | Raw SVG file (e.g. `/icons/openai/default.svg`) | ```bash # Fetch the manifest once, filter client-side curl "https://thesvg.org/api/registry.json" | jq '.icons[] | select(.slug | contains("openai"))' # Then pull the SVG you want curl "https://thesvg.org/icons/openai/default.svg" ``` ### Mirrors For high-traffic apps, use jsDelivr (free, GitHub-backed) instead of hitting `thesvg.org` directly: ``` https://cdn.jsdelivr.net/gh/glincker/thesvg@main/src/data/icons.json https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/{slug}/{variant}.svg ``` `src/data/icons.json` is the source-of-truth manifest (the same data that builds `/api/registry.json`, with full per-icon fields including `license` and `dateAdded`). You can also clone the repo (~30 MB) and self-host. The codebase is MIT-licensed; individual brand icons remain trademarks of their respective owners (see [LEGAL.md](./LEGAL.md)). > A gated, token-based API is on the roadmap at `api.thesvg.org` for advanced features (search relevance, usage analytics, webhooks). Until then, the static manifest above is the supported integration path. ## Categories Icons are organized into 55+ categories: `AI` `Analytics` `Authentication` `Automotive` `Aviation` `Browser` `Cloud` `CMS` `Community` `Crypto` `Database` `Design` `Devtool` `Education` `Entertainment` `Finance` `Food` `Framework` `Gaming` `Hardware` `Hosting` `IoT` `Language` `Library` `Linux` `Media` `Music` `Payment` `Platform` `Privacy` `Security` `Self-Hosted` `Shopping` `Social` `Software` and more... ## Contributing Every brand deserves a place. No gatekeeping. **Submit an icon:** [thesvg.org/submit](https://thesvg.org/submit) or open a [pull request](https://github.com/glincker/thesvg/pulls). **Development setup:** ```bash git clone https://github.com/glincker/thesvg.git cd thesvg pnpm install pnpm dev # http://localhost:3333 ``` See [CONTRIBUTING.md](./CONTRIBUTING.md) for full guidelines. ## Disclaimer All brand names, logos, and trademarks are the property of their respective owners. theSVG provides these icons for development and design purposes only under nominative fair use. Use of brand assets must comply with each brand's usage guidelines. AWS Architecture Icons are provided under [CC BY-ND 2.0](https://creativecommons.org/licenses/by-nd/2.0/) (No Derivatives). Amazon Web Services and all related marks are trademarks of Amazon.com, Inc. If you are a brand owner and would like an icon updated or removed, please [open an issue](https://github.com/glincker/thesvg/issues) or email **[email protected]**. See our [Legal Notice](https://thesvg.org/legal), [TRADEMARK.md](./TRADEMARK.md), and [LEGAL.md](./LEGAL.md) for full details. ## License [MIT](./LICENSE) for the codebase and tooling. Individual brand icons remain the intellectual property of their respective trademark holders. ## Star History <a href="https://star-history.com/#glincker/thesvg&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=glincker/thesvg&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=glincker/thesvg&type=Date" /> <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=glincker/thesvg&type=Date" width="600" /> </picture> </a> --- <p align="center"> <a href="https://thesvg.org">thesvg.org</a> • <a href="https://github.com/glincker/thesvg/issues">Issues</a> </p>