Skip to content
Back to search

thesvg

7,400+ brand SVG icons for developers. Tree-shakeable, typed, open source. npm i thesvg

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/glincker/thesvg with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/glincker/thesvg'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/glincker--thesvg/badge.svg)](/listings/glincker--thesvg)

HTML

<a href="/listings/glincker--thesvg"><img src="/api/listings/glincker--thesvg/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**npm**

npm install thesvg

**Homebrew**

brew tap glincker/thesvg
brew install thesvg
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:

npm install @thesvg/icons

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 677 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <a href="https://thesvg.org">
  3. <picture>
  4. <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/glincker/thesvg/main/public/logo-wordmark-dark.svg" />
  5. <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/glincker/thesvg/main/public/logo-wordmark.svg" />
  6. <img src="https://raw.githubusercontent.com/glincker/thesvg/main/public/logo-wordmark.svg" alt="theSVG" height="48" />
  7. </picture>
  8. </a>
  9. </p>
  10. <h3 align="center">The open SVG brand library</h3>
  11. <p align="center"><b>A HOME FOR EVERY BRAND.</b></p>
  12. <p align="center">
  13. <a href="https://thesvg.org/collection/flags">Flags</a> · <a href="https://thesvg.org/blog/country-flags">New: country flags</a> · <a href="https://thesvg.org/blog">Blog</a> · <a href="https://thesvg.org/docs">Docs</a>
  14. </p>
  15. <p align="center">
  16. 7,900+ brand logos, cloud icons and country flags. Search, copy and ship them as SVG, React, Vue, Svelte, CDN, CLI or MCP.<br />
  17. Free, open source, no gatekeeping.
  18. </p>
  19. <p align="center">
  20. <a href="https://trendshift.io/repositories/24396?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-24396" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/24396/daily?language=TypeScript" alt="glincker/thesvg | Trendshift" width="250" height="55"/></a>
  21. </p>
  22. <p align="center">
  23. <a href="https://www.npmjs.com/package/thesvg"><img src="https://img.shields.io/npm/v/thesvg?style=flat-square&color=C2410C&label=npm" alt="npm" /></a>
  24. <a href="https://www.npmjs.com/package/thesvg"><img src="https://img.shields.io/npm/dm/thesvg?style=flat-square&color=C2410C&label=downloads" alt="downloads" /></a>
  25. <a href="https://www.npmjs.com/package/@thesvg/flags"><img src="https://img.shields.io/npm/v/@thesvg/flags?style=flat-square&color=C2410C&label=flags" alt="@thesvg/flags" /></a>
  26. <a href="https://www.npmjs.com/package/@thesvg/mcp-server"><img src="https://img.shields.io/npm/v/@thesvg/mcp-server?style=flat-square&color=C2410C&label=MCP" alt="MCP server" /></a>
  27. <a href="https://www.jsdelivr.com/package/gh/glincker/thesvg"><img src="https://data.jsdelivr.com/v1/package/gh/glincker/thesvg/badge" alt="jsDelivr" /></a>
  28. <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>
  29. <a href="https://discord.gg/Ar5pcaZB99"><img src="https://img.shields.io/discord/829168897080557579?style=flat-square&logo=discord&logoColor=white&label=discord&color=5865F2" alt="Discord" /></a>
  30. <a href="https://github.com/glincker/thesvg"><img src="https://img.shields.io/badge/icons-7%2C900%2B-C2410C?style=flat-square" alt="7,900+ icons" /></a>
  31. <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>
  32. <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>
  33. <a href="https://marketplace.visualstudio.com/items?itemName=glincker.thesvg"><img src="https://img.shields.io/badge/VS%20Code-Extension-007ACC?style=flat-square&logo=visualstudiocode&logoColor=white" alt="VS Code" /></a>
  34. <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>
  35. <a href="https://icon-sets.iconify.design/thesvg-color/"><img src="https://img.shields.io/badge/Iconify-2%20sets-026C9C?style=flat-square" alt="Iconify" /></a>
  36. <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>
  37. <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>
  38. <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>
  39. <a href="https://skills.sh/glincker/thesvg"><img src="https://skills.sh/b/glincker/thesvg" alt="skills.sh" /></a>
  40. <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>
  41. <a href="https://socket.dev/npm/package/@thesvg/icons"><img src="https://socket.dev/api/badge/npm/package/@thesvg/icons" alt="Socket score for @thesvg/icons" /></a>
  42. <a href="https://socket.dev/npm/package/thesvg"><img src="https://socket.dev/api/badge/npm/package/thesvg" alt="Socket score for thesvg" /></a>
  43. <a href="https://www.npmjs.com/package/@thesvg/icons"><img src="https://img.shields.io/badge/provenance-verified-2EA44F?style=flat-square" alt="npm provenance verified" /></a>
  44. </p>
  45. <p align="center">
  46. <a href="https://thesvg.org"><strong>Browse icons</strong></a> &nbsp;&bull;&nbsp;
  47. <a href="#quick-start">Quick start</a> &nbsp;&bull;&nbsp;
  48. <a href="#install">Install</a> &nbsp;&bull;&nbsp;
  49. <a href="#extensions">Extensions</a> &nbsp;&bull;&nbsp;
  50. <a href="#cdn">CDN</a> &nbsp;&bull;&nbsp;
  51. <a href="#api">API</a> &nbsp;&bull;&nbsp;
  52. <a href="#packages">Packages</a> &nbsp;&bull;&nbsp;
  53. <a href="https://thesvg.org/compare">Compare</a> &nbsp;&bull;&nbsp;
  54. <a href="#community">Community</a> &nbsp;&bull;&nbsp;
  55. <a href="#contributing">Contribute</a> &nbsp;&bull;&nbsp;
  56. <a href="#contributors">Contributors</a>
  57. </p>
  58. <p align="center">
  59. <a href="https://thesvg.org">
  60. <picture>
  61. <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/glincker/thesvg/main/public/og-image.png" />
  62. <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/glincker/thesvg/main/public/og-image-light.png" />
  63. <img src="https://raw.githubusercontent.com/glincker/thesvg/main/public/og-image-light.png" alt="theSVG, the open SVG brand library" width="720" />
  64. </picture>
  65. </a>
  66. </p>
  67. <p align="center">
  68. <sub>Every logo below is served straight from theSVG.</sub>
  69. </p>
  70. <p align="center">
  71. <a href="https://thesvg.org/icon/google"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/google/default.svg" height="34" alt="Google" /></a>&nbsp;&nbsp;&nbsp;
  72. <a href="https://thesvg.org/icon/docker"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/docker/default.svg" height="34" alt="Docker" /></a>&nbsp;&nbsp;&nbsp;
  73. <a href="https://thesvg.org/icon/kubernetes"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/kubernetes/default.svg" height="34" alt="Kubernetes" /></a>&nbsp;&nbsp;&nbsp;
  74. <a href="https://thesvg.org/icon/react"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/react/default.svg" height="34" alt="React" /></a>&nbsp;&nbsp;&nbsp;
  75. <a href="https://thesvg.org/icon/vue"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/vue/default.svg" height="34" alt="Vue" /></a>&nbsp;&nbsp;&nbsp;
  76. <a href="https://thesvg.org/icon/svelte"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/svelte/default.svg" height="34" alt="Svelte" /></a>&nbsp;&nbsp;&nbsp;
  77. <a href="https://thesvg.org/icon/typescript"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/typescript/default.svg" height="34" alt="TypeScript" /></a>&nbsp;&nbsp;&nbsp;
  78. <a href="https://thesvg.org/icon/tailwindcss"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/tailwindcss/default.svg" height="34" alt="Tailwind CSS" /></a>&nbsp;&nbsp;&nbsp;
  79. <a href="https://thesvg.org/icon/figma"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/figma/default.svg" height="34" alt="Figma" /></a>&nbsp;&nbsp;&nbsp;
  80. <a href="https://thesvg.org/icon/stripe"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/stripe/default.svg" height="34" alt="Stripe" /></a>
  81. </p>
  82. <p align="center">
  83. <a href="https://thesvg.org/icon/slack"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/slack/default.svg" height="34" alt="Slack" /></a>&nbsp;&nbsp;&nbsp;
  84. <a href="https://thesvg.org/icon/discord"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/discord/default.svg" height="34" alt="Discord" /></a>&nbsp;&nbsp;&nbsp;
  85. <a href="https://thesvg.org/icon/spotify"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/spotify/default.svg" height="34" alt="Spotify" /></a>&nbsp;&nbsp;&nbsp;
  86. <a href="https://thesvg.org/icon/supabase"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/supabase/default.svg" height="34" alt="Supabase" /></a>&nbsp;&nbsp;&nbsp;
  87. <a href="https://thesvg.org/icon/postgresql"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/postgresql/default.svg" height="34" alt="PostgreSQL" /></a>&nbsp;&nbsp;&nbsp;
  88. <a href="https://thesvg.org/icon/mongodb"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/mongodb/default.svg" height="34" alt="MongoDB" /></a>&nbsp;&nbsp;&nbsp;
  89. <a href="https://thesvg.org/icon/cloudflare"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/cloudflare/default.svg" height="34" alt="Cloudflare" /></a>&nbsp;&nbsp;&nbsp;
  90. <a href="https://thesvg.org/icon/terraform"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/terraform/default.svg" height="34" alt="Terraform" /></a>&nbsp;&nbsp;&nbsp;
  91. <a href="https://thesvg.org/icon/aws"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/amazon-badge/default.svg" height="34" alt="AWS" /></a>&nbsp;&nbsp;&nbsp;
  92. <a href="https://thesvg.org/icon/microsoft-azure"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/microsoft-azure/default.svg" height="34" alt="Azure" /></a>
  93. </p>
  94. <hr />
  95. ## Why theSVG
  96. 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 a set of interface icons of our own. Searchable, versioned, and available as npm packages, CDN, CLI, API, and MCP server.
  97. Every developer has hunted for a company logo: a press kit buried three clicks deep, a PNG that blurs on retina, a "mono" file that is secretly four colors, a logo that changed last month. Most icon sets cover UI glyphs. Nobody treated brand logos as real, versioned, trustworthy data.
  98. theSVG does. It is one open catalog where every logo is **official, clean, complete and current**, and it is delivered in whatever shape your project needs.
  99. ### Why we built it
  100. theSVG started with a pull request. We tried to add the logo of our own product, [AskVerdict](https://www.askverdict.ai), to an existing open source logo library, and it was declined as outside that project's scope, which is a fair call for a curated set. That made us want a catalog where any real brand, large or small, can be added through a simple review. theSVG now holds over 7,900 icons, sourced from official brand assets and checked before each one is merged.
  101. **A HOME FOR EVERY BRAND.**
  102. ### The theSVG standard
  103. What every icon in the catalog is held to, and what we want a brand SVG to mean everywhere:
  104. | Principle | What it means in practice |
  105. | --- | --- |
  106. | **Official, unmodified** | Taken from the brand's own kit or site, with a license and a guidelines link on every entry. No redraws. |
  107. | **Complete variants** | `default`, `mono`, `light`, `dark` and `wordmark` under one predictable naming scheme, so `{slug}/{variant}.svg` always works. |
  108. | **Truly clean** | A validator runs in CI on every changed file: no scripts, no embedded rasters, no `null` or `NaN` values, mono files really are single color, `viewBox` always present. |
  109. | **Rebrands keep history** | When a brand changes its logo, the new mark becomes current and the old one is kept as a `-legacy` entry, linked both ways. Nothing silently disappears. |
  110. | **Machine readable** | A static manifest, `llms.txt`, an MCP server and stable CDN URLs, so tools and AI assistants can use logos as reliably as people do. |
  111. | **Open to everyone** | MIT code, no accounts, no API keys, no gatekeeping. If a brand is real, it belongs here. |
  112. If that is the logo library you wished existed, the single most useful thing you can do is **[star the repo](https://github.com/glincker/thesvg)**. It is how other developers find it.
  113. <table>
  114. <tr>
  115. <td align="center" width="25%"><strong><!-- flags:total-icons -->7,900+<!-- /flags:total-icons --></strong><br />icons</td>
  116. <td align="center" width="25%"><strong><!-- flags:total-variants -->14,600+<!-- /flags:total-variants --></strong><br />variants: color, mono, light, dark, wordmark, flag shapes</td>
  117. <td align="center" width="25%"><strong>150+</strong><br />categories</td>
  118. <td align="center" width="25%"><strong>21</strong><br />brand families</td>
  119. </tr>
  120. </table>
  121. ### What is inside
  122. | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; | Collection | Icons | What you get |
  123. | --- | --- | --- | --- |
  124. | <picture><source media="(prefers-color-scheme: dark)" srcset="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/github/dark.svg" /><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/github/light.svg" width="28" height="28" alt="" /></picture> | [Brand icons](https://thesvg.org/collection/brands) | 4,800+ | Logos from 150+ categories in color, mono, light, dark and wordmark |
  125. | <picture><source media="(prefers-color-scheme: dark)" srcset="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/1password/dark.svg" /><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/1password/light.svg" width="28" height="28" alt="" /></picture> | [Auth badges](https://thesvg.org/collection/auth-badges) | 858 | Circular badges for 2FA and authenticator UIs |
  126. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/amazon-badge/default.svg" width="28" height="28" alt="" /> | [AWS Architecture](https://thesvg.org/collection/aws) | 739 | Official AWS service and resource icons |
  127. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/microsoft-azure/default.svg" width="28" height="28" alt="" /> | [Azure](https://thesvg.org/collection/azure) | 626 | Microsoft Azure service icons |
  128. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/docker/default.svg" width="28" height="28" alt="" /> | [Community](https://thesvg.org/collection/community) | 256 | Dev tools, databases and frameworks |
  129. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/google-cloud/default.svg" width="28" height="28" alt="" /> | [Google Cloud](https://thesvg.org/collection/gcp) | 214 | Google Cloud Platform icons |
  130. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/kubernetes/default.svg" width="28" height="28" alt="" /> | [Kubernetes](https://thesvg.org/collection/k8s) | 38 | Official CNCF architecture icons |
  131. <details>
  132. <summary>Collections, plain table</summary>
  133. theSVG organizes icons into collections:
  134. | Collection | Icons | Description |
  135. |------------|-------|-------------|
  136. | **Brand Icons** | 4,800+ | Brand logos from 150+ categories |
  137. | **Auth Badges** | 858 | Circular icon badges styled for 2FA/authenticator apps |
  138. | **AWS Architecture** | 739 | Official AWS service, resource, category, and group icons (2026-Q1) |
  139. | **Azure Services** | 626 | Microsoft Azure service icons (2026-Q1) |
  140. | **Community** | 256 | Dev tools, databases, and frameworks sourced from the open-source community |
  141. | **Google Cloud** | 214 | Google Cloud Platform icons (2026-Q1) |
  142. | **Kubernetes** | 38 | Official Kubernetes/CNCF architecture icons |
  143. | **Flags** | <!-- flags:count -->263<!-- /flags:count --> | Country and region flags in 4x3, square and circle (category `Flags`, slugs `flag-us`, `flag-gb-eng`) |
  144. </details>
  145. ### UI icons
  146. **New in theSVG 4.0.** Alongside the brand catalog, theSVG ships a set of **interface icons we draw ourselves**, at [thesvg.org/ui](https://thesvg.org/ui). 129 icons today, each in seven looks (outline, glass, duotone, offset, fill, glass outline and depth), all using `currentColor`, with more arriving in small drops. They are a separate section with their own data, packages and tests, and the two kinds of icons never mix their data or code. See [UI icons](#ui-icons-1) below.
  147. ### Brand families
  148. Products grouped by the company that owns them, so you get the whole Google, Microsoft, Amazon or Apple line in one place with every variant. Browse all 21 at [thesvg.org/families](https://thesvg.org/families).
  149. <table>
  150. <tr>
  151. <td align="center"><a href="https://thesvg.org/family/google"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/google/default.svg" height="32" alt="" /><br /><b>Google</b></a><br /><sub>100+ logos</sub></td>
  152. <td align="center"><a href="https://thesvg.org/family/microsoft"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/microsoft/default.svg" height="32" alt="" /><br /><b>Microsoft</b></a><br /><sub>70+ logos</sub></td>
  153. <td align="center"><a href="https://thesvg.org/family/adobe"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/adobe/default.svg" height="32" alt="" /><br /><b>Adobe</b></a><br /><sub>30+ logos</sub></td>
  154. <td align="center"><a href="https://thesvg.org/family/amazon"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/amazon-badge/default.svg" height="32" alt="" /><br /><b>Amazon</b></a><br /><sub>18 logos</sub></td>
  155. <td align="center"><a href="https://thesvg.org/family/apple"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/apple/dark.svg" /><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/apple/light.svg" height="32" alt="" /></picture><br /><b>Apple</b></a><br /><sub>16 logos</sub></td>
  156. <td align="center"><a href="https://thesvg.org/family/jetbrains"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/jetbrains/default.svg" height="32" alt="" /><br /><b>JetBrains</b></a><br /><sub>16 logos</sub></td>
  157. <td align="center"><a href="https://thesvg.org/family/ibm"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/ibm/default.svg" height="32" alt="" /><br /><b>IBM</b></a><br /><sub>14 logos</sub></td>
  158. </tr>
  159. </table>
  160. The full breakdown lives in [Collections, families and categories](./docs/collections.md).
  161. ### Highlights
  162. - **<!-- flags:total-icons -->7,900+<!-- /flags:total-icons --> icons** across multiple collections
  163. - **4,800+ brand icons** across 150+ categories
  164. - **21 brand families** - every product from Amazon, Google, Microsoft and more, grouped by owner
  165. - **858 Auth Badge icons** - circular icon badges for 2FA/authenticator apps
  166. - **739 AWS Architecture icons** (2026-Q1)
  167. - **626 Azure Service icons** (2026-Q1)
  168. - **256 community-curated icons** - dev tools, databases, frameworks
  169. - **214 Google Cloud icons** (2026-Q1)
  170. - **<!-- flags:count -->263<!-- /flags:count --> country and region flags** - ISO 3166-1 plus England, Scotland, Wales, Catalonia and more, in 4x3, square and circle
  171. - **<!-- flags:total-variants -->14,600+<!-- /flags:total-variants --> SVG variants** - color, mono, light, dark, wordmark, flag shapes
  172. - **Tree-shakeable** - import one icon, ship only that icon
  173. - **TypeScript-first** - fully typed, dual ESM/CJS
  174. - **Framework-agnostic** - React, Vue, Svelte, plain HTML, or CDN
  175. - **AI-ready** - MCP server for Claude, Cursor, and Windsurf
  176. ### Flags
  177. Browse at [thesvg.org/collection/flags](https://thesvg.org/collection/flags). Every ISO 3166-1 country plus England, Scotland, Wales, Catalonia, the Basque Country, Galicia, the Valencian Community, the Balearic Islands, the Canary Islands, Corsica, Occitania, the EU and the UN, in three shapes. Slugs are `flag-<code>` (`flag-us`, `flag-gb-eng`); variants are `default` (4x3), `square` and `circle`.
  178. ```bash
  179. npm i @thesvg/flags
  180. ```
  181. ```tsx
  182. import { FlagUs } from "@thesvg/flags/react/us";
  183. import { getFlagForLocale } from "@thesvg/flags/locale";
  184. <FlagUs variant="circle" size={32} />
  185. ```
  186. No install needed for a plain image: `https://cdn.jsdelivr.net/npm/@thesvg/flags/dist/svg/4x3/us.svg` (use `1x1` or `circle` for the other shapes).
  187. On the site, every flag has its own page (`/icon/flag-us`) with its color palette, copy and download buttons, a how-to-use card (npm, CLI and CDN) and crawlable facts. The collection page filters by region, color or locale, and the header search lists flags in their own section so brand icons stay first.
  188. A flag is a country, not a language: show the native language name beside it. Guide: [docs/flags.md](./docs/flags.md).
  189. ### AWS Architecture Icons
  190. 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.
  191. ### Auth Badges
  192. Browse the full set at [thesvg.org/collection/auth-badges](https://thesvg.org/collection/auth-badges). Circular, flat-color badge icons designed for authenticator-app entry lists and 2FA UI - a distinct visual style from the primary brand-mark collection above. Distributed under CC0-1.0 (public domain).
  193. <details>
  194. <summary>Brand families, full table</summary>
  195. Products grouped by the company that owns them, each with its own page: the whole Amazon, Google or Microsoft line in one place, with every variant.
  196. | Family | Logos | Includes |
  197. | --- | --- | --- |
  198. | [Google](https://thesvg.org/family/google) | 100+ | Workspace, Gemini, Cloud, Android, Chrome |
  199. | [Microsoft](https://thesvg.org/family/microsoft) | 70+ | GitHub, Azure, Dynamics 365, Fabric, Copilot |
  200. | [Adobe](https://thesvg.org/family/adobe) | 30+ | Photoshop, Illustrator, Creative Cloud |
  201. | [Amazon](https://thesvg.org/family/amazon) | 18 | Prime, Kindle, Music, AWS, Twitch, Ring |
  202. | [Apple](https://thesvg.org/family/apple) | 16 | iOS, macOS, Music, iCloud |
  203. | [JetBrains](https://thesvg.org/family/jetbrains) | 16 | IntelliJ IDEA, PyCharm, WebStorm, Rider |
  204. | [IBM](https://thesvg.org/family/ibm) | 14 | Red Hat, HashiCorp, Terraform, Ansible |
  205. Browse all 21 families at [thesvg.org/families](https://thesvg.org/families). The same data is available as JSON at [`/api/families.json`](https://thesvg.org/api/families.json) and in [`llms.txt`](https://thesvg.org/llms.txt).
  206. </details>
  207. ## Quick start
  208. ```bash
  209. # Add a single icon to your project
  210. npx @thesvg/cli add github
  211. # Or install the package and import only what you use
  212. npm install thesvg
  213. ```
  214. ```ts
  215. import github from "thesvg/github";
  216. github.svg; // raw SVG string
  217. github.title; // "GitHub"
  218. github.hex; // "181717"
  219. ```
  220. ```html
  221. <!-- Or use the CDN, no install -->
  222. <img src="https://thesvg.org/icons/github/default.svg" width="32" height="32" alt="GitHub" />
  223. ```
  224. Every icon has its own page with all variants, copy formats and a live preview, for example [thesvg.org/icon/github](https://thesvg.org/icon/github). Tree-shakeable, fully typed, ESM and CJS. More in [Install and packages](./docs/install.md), [Usage and variants](./docs/usage.md) and [CDN and API](./docs/cdn-api.md).
  225. ## Built for designers and developers
  226. <table>
  227. <tr>
  228. <td width="50%" valign="top">
  229. <h4><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/figma/default.svg" height="20" alt="" /> If you design</h4>
  230. <ul>
  231. <li>Drop official logos into Figma as <b>editable vectors</b> with the <a href="https://www.figma.com/community/plugin/1612997159050367763">Figma plugin</a>.</li>
  232. <li>Pick the right variant for the background: color, mono, light, dark or wordmark.</li>
  233. <li>No redrawing, no recoloring guesswork. Every mark is the brand's own, with a guidelines link.</li>
  234. <li>Diagramming? Use the <a href="https://icon-sets.iconify.design/thesvg-color/">Iconify sets</a> in Mermaid, plus draw.io and Excalidraw libraries, and the AWS, Azure and Google Cloud architecture icons.</li>
  235. </ul>
  236. </td>
  237. <td width="50%" valign="top">
  238. <h4><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/visual-studio-code/default.svg" height="20" alt="" /> If you build</h4>
  239. <ul>
  240. <li>Import one icon and ship one icon: <code>thesvg/github</code> is tree-shakeable and fully typed.</li>
  241. <li>Use <a href="https://www.npmjs.com/package/@thesvg/react">React</a>, <a href="https://www.npmjs.com/package/@thesvg/vue">Vue</a> or <a href="https://www.npmjs.com/package/@thesvg/svelte">Svelte</a> components, or a plain <code>&lt;img&gt;</code> from the CDN.</li>
  242. <li>Add icons from the terminal with the <a href="https://www.npmjs.com/package/@thesvg/cli">CLI</a>, or let your AI editor fetch them through the <a href="https://www.npmjs.com/package/@thesvg/mcp-server">MCP server</a>.</li>
  243. <li>Stable URLs and a static JSON manifest, so you can build on it without keys or sign-ups.</li>
  244. </ul>
  245. </td>
  246. </tr>
  247. </table>
  248. ## Install
  249. **npm**
  250. ```bash
  251. npm install thesvg
  252. ```
  253. **Homebrew**
  254. ```bash
  255. brew tap glincker/thesvg
  256. brew install thesvg
  257. ```
  258. ```ts
  259. import github from "thesvg/github";
  260. github.svg; // raw SVG string
  261. github.title; // "GitHub"
  262. github.hex; // "181717"
  263. github.variants; // { default: "<svg...>", mono: "<svg...>" }
  264. ```
  265. Or use the scoped package for tree-shaking:
  266. ```bash
  267. npm install @thesvg/icons
  268. ```
  269. ## Packages
  270. Every package is tree-shakeable, fully typed and ships ESM and CJS. Pick the one that fits your stack. Brand icons and UI icons are separate packages (`@thesvg/ui*`), so adding one never makes the other heavier.
  271. | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; | Package | Version | Downloads | What it is | Install |
  272. | --- | --- | --- | --- | --- | --- |
  273. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/npm/default.svg" width="28" height="28" alt="" /> | [`thesvg`](https://www.npmjs.com/package/thesvg) | [![npm](https://img.shields.io/npm/v/thesvg?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/thesvg) | [![downloads](https://img.shields.io/npm/dm/thesvg?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/thesvg) | All icons in one package | `npm install thesvg` |
  274. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/npm/default.svg" width="28" height="28" alt="" /> | [`@thesvg/icons`](https://www.npmjs.com/package/@thesvg/icons) | [![npm](https://img.shields.io/npm/v/@thesvg/icons?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/icons) | [![downloads](https://img.shields.io/npm/dm/@thesvg/icons?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/icons) | Core icon data, tree-shakeable | `npm install @thesvg/icons` |
  275. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/react/default.svg" width="28" height="28" alt="" /> | [`@thesvg/react`](https://www.npmjs.com/package/@thesvg/react) | [![npm](https://img.shields.io/npm/v/@thesvg/react?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/react) | [![downloads](https://img.shields.io/npm/dm/@thesvg/react?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/react) | Typed React components | `npm install @thesvg/react` |
  276. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/vue/default.svg" width="28" height="28" alt="" /> | [`@thesvg/vue`](https://www.npmjs.com/package/@thesvg/vue) | [![npm](https://img.shields.io/npm/v/@thesvg/vue?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/vue) | [![downloads](https://img.shields.io/npm/dm/@thesvg/vue?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/vue) | Typed Vue 3 components | `npm install @thesvg/vue` |
  277. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/svelte/default.svg" width="28" height="28" alt="" /> | [`@thesvg/svelte`](https://www.npmjs.com/package/@thesvg/svelte) | [![npm](https://img.shields.io/npm/v/@thesvg/svelte?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/svelte) | [![downloads](https://img.shields.io/npm/dm/@thesvg/svelte?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/svelte) | Typed Svelte components | `npm install @thesvg/svelte` |
  278. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/react/default.svg" width="28" height="28" alt="" /> | [`@thesvg/react-native`](https://www.npmjs.com/package/@thesvg/react-native) | [![npm](https://img.shields.io/npm/v/@thesvg/react-native?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/react-native) | [![downloads](https://img.shields.io/npm/dm/@thesvg/react-native?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/react-native) | React Native components | `npm install @thesvg/react-native` |
  279. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/npm/default.svg" width="28" height="28" alt="" /> | [`@thesvg/ui`](https://www.npmjs.com/package/@thesvg/ui) | [![npm](https://img.shields.io/npm/v/@thesvg/ui?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/ui) | [![downloads](https://img.shields.io/npm/dm/@thesvg/ui?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/ui) | UI icons: raw SVG files and JSON manifest | `npm install @thesvg/ui` |
  280. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/npm/default.svg" width="28" height="28" alt="" /> | [`@thesvg/ui-react`](https://www.npmjs.com/package/@thesvg/ui-react) | [![npm](https://img.shields.io/npm/v/@thesvg/ui-react?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/ui-react) | [![downloads](https://img.shields.io/npm/dm/@thesvg/ui-react?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/ui-react) | UI icons as typed React components | `npm install @thesvg/ui-react` |
  281. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/npm/default.svg" width="28" height="28" alt="" /> | [`@thesvg/ui-vue`](https://www.npmjs.com/package/@thesvg/ui-vue) | [![npm](https://img.shields.io/npm/v/@thesvg/ui-vue?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/ui-vue) | [![downloads](https://img.shields.io/npm/dm/@thesvg/ui-vue?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/ui-vue) | UI icons as Vue 3 components | `npm install @thesvg/ui-vue` |
  282. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/npm/default.svg" width="28" height="28" alt="" /> | [`@thesvg/ui-svelte`](https://www.npmjs.com/package/@thesvg/ui-svelte) | [![npm](https://img.shields.io/npm/v/@thesvg/ui-svelte?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/ui-svelte) | [![downloads](https://img.shields.io/npm/dm/@thesvg/ui-svelte?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/ui-svelte) | UI icons as Svelte components | `npm install @thesvg/ui-svelte` |
  283. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/npm/default.svg" width="28" height="28" alt="" /> | [`@thesvg/ui-react-native`](https://www.npmjs.com/package/@thesvg/ui-react-native) | [![npm](https://img.shields.io/npm/v/@thesvg/ui-react-native?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/ui-react-native) | [![downloads](https://img.shields.io/npm/dm/@thesvg/ui-react-native?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/ui-react-native) | UI icons for React Native | `npm install @thesvg/ui-react-native` |
  284. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/npm/default.svg" width="28" height="28" alt="" /> | [`@thesvg/cli`](https://www.npmjs.com/package/@thesvg/cli) | [![npm](https://img.shields.io/npm/v/@thesvg/cli?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/cli) | [![downloads](https://img.shields.io/npm/dm/@thesvg/cli?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/cli) | CLI tool, shadcn-style installer | `npx @thesvg/cli add github` |
  285. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/claude/default.svg" width="28" height="28" alt="" /> | [`@thesvg/mcp-server`](https://www.npmjs.com/package/@thesvg/mcp-server) | [![npm](https://img.shields.io/npm/v/@thesvg/mcp-server?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/mcp-server) | [![downloads](https://img.shields.io/npm/dm/@thesvg/mcp-server?style=flat-square&color=C2410C&label=)](https://www.npmjs.com/package/@thesvg/mcp-server) | MCP server for AI assistants | `npx @thesvg/mcp-server` |
  286. ## Extensions
  287. Use theSVG icons everywhere you build, design and ship. Browse the full ecosystem at [thesvg.org/extensions](https://thesvg.org/extensions).
  288. | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; | Extension | Status | What it does |
  289. | --- | --- | --- | --- |
  290. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/figma/default.svg" width="28" height="28" alt="" /> | [Figma Plugin](https://www.figma.com/community/plugin/1612997159050367763) | ![Published](https://img.shields.io/badge/-Published-2ea043?style=flat-square) | Browse 7,600+ brand SVGs, variant picker, recents row, keyboard shortcuts. Insert as editable vectors. |
  291. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/visual-studio-code/default.svg" width="28" height="28" alt="" /> | [VS Code](https://marketplace.visualstudio.com/items?itemName=glincker.thesvg) | ![Published](https://img.shields.io/badge/-Published-2ea043?style=flat-square) | Search 7,600+ icons from the command palette. Copy SVG, JSX, CDN link, or insert at cursor. |
  292. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/raycast/default.svg" width="28" height="28" alt="" /> | [Raycast](https://www.raycast.com/thegdsks/thesvg) | ![Published](https://img.shields.io/badge/-Published-2ea043?style=flat-square) | Search, preview, and copy any brand SVG in one keystroke. Filter by category, preview variants. |
  293. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/claude/default.svg" width="28" height="28" alt="" /> | [MCP Server](https://www.npmjs.com/package/@thesvg/mcp-server) | ![Published](https://img.shields.io/badge/-Published-2ea043?style=flat-square) | AI tool calls for Claude, Cursor, Windsurf. Fetch icons by name or category. |
  294. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/claude/default.svg" width="28" height="28" alt="" /> | [Agent Skill](https://skills.sh/glincker/thesvg) | ![Published](https://img.shields.io/badge/-Published-2ea043?style=flat-square) | Drop-in skill for AI agents. Install via `npx skills add glincker/thesvg`. Teaches the icon CDN and registry. |
  295. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/npm/default.svg" width="28" height="28" alt="" /> | [`@thesvg/cli`](https://www.npmjs.com/package/@thesvg/cli) | ![Published](https://img.shields.io/badge/-Published-2ea043?style=flat-square) | shadcn-style installer. `npx @thesvg/cli add github` drops the SVG into your project. |
  296. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/homebrew/default.svg" width="28" height="28" alt="" /> | [Homebrew](https://github.com/glincker/homebrew-thesvg) | ![Published](https://img.shields.io/badge/-Published-2ea043?style=flat-square) | `brew tap glincker/thesvg && brew install thesvg` |
  297. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/jsdelivr/default.svg" width="28" height="28" alt="" /> | [CDN via jsDelivr](https://www.jsdelivr.com/package/gh/glincker/thesvg) | ![Published](https://img.shields.io/badge/-Published-2ea043?style=flat-square) | Serve any icon via global CDN. Drop into HTML, CSS, Markdown, Notion, Webflow, Framer. |
  298. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/iconify/default.svg" width="28" height="28" alt="" /> | [Iconify](https://icon-sets.iconify.design/thesvg-color/) | ![Published](https://img.shields.io/badge/-Published-2ea043?style=flat-square) | Brand icons available as [`thesvg`](https://icon-sets.iconify.design/thesvg/) (mono) and [`thesvg-color`](https://icon-sets.iconify.design/thesvg-color/) sets. Works with any Iconify-consuming tool: Mermaid architecture diagrams, Iconify's VS Code and Figma plugins, `@iconify/react`, and more. |
  299. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/google-chrome/default.svg" width="28" height="28" alt="" /> | [Browser Extension](https://github.com/glincker/thesvg/tree/main/extensions/browser) | ![Beta](https://img.shields.io/badge/-Beta-d29922?style=flat-square) | Chrome, Firefox, Edge popup with 7,600+ brand SVGs. MV3, no telemetry. |
  300. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/jetbrains/default.svg" width="28" height="28" alt="" /> | [JetBrains](https://github.com/glincker/thesvg/issues?q=label%3Aextension) | ![Help wanted](https://img.shields.io/badge/-Help%20wanted-6e7681?style=flat-square) | IntelliJ, WebStorm, PyCharm, Rider tool window. Help wanted. |
  301. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/neovim/default.svg" width="28" height="28" alt="" /> | [Neovim](https://github.com/glincker/thesvg/tree/main/extensions/neovim) | ![Published](https://img.shields.io/badge/-Published-2ea043?style=flat-square) | Lua plugin with Telescope picker. Insert SVG URL or inline content at cursor. |
  302. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/alfred/default.svg" width="28" height="28" alt="" /> | [Alfred Workflow](https://github.com/glincker/thesvg/tree/main/extensions/alfred) | ![Published](https://img.shields.io/badge/-Published-2ea043?style=flat-square) | macOS quick access. Search anywhere, copy SVG, CDN URL, or markdown. |
  303. | <picture><source media="(prefers-color-scheme: dark)" srcset="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/sketch/dark.svg" /><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/sketch/light.svg" width="28" height="28" alt="" /></picture> | [Sketch / Blender / Webflow / Notion](https://github.com/glincker/thesvg/issues?q=label%3Aextension) | ![Help wanted](https://img.shields.io/badge/-Help%20wanted-6e7681?style=flat-square) | Tracking issues open. Build a plugin and we will list it here. |
  304. > **UI icons in extensions:** the CLI, MCP server, VS Code, the browser extension, Alfred and Neovim search UI icons as well as brand icons. Figma and Raycast follow after launch. Each extension reads the UI icons from their own file, so brand search is never affected.
  305. > **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.
  306. ## Usage
  307. <details>
  308. <summary>React, Vue, Svelte, CDN and CLI examples</summary>
  309. ### React
  310. ```tsx
  311. import { Github, Figma } from "@thesvg/react";
  312. export function Logos() {
  313. return <Github width={24} height={24} className="text-white" />;
  314. }
  315. ```
  316. ### Vue
  317. ```vue
  318. <script setup>
  319. import { Github, Figma } from "@thesvg/vue";
  320. </script>
  321. <template>
  322. <Github width="24" height="24" />
  323. </template>
  324. ```
  325. ### Svelte
  326. ```svelte
  327. <script>
  328. import { Github, Figma } from "@thesvg/svelte";
  329. </script>
  330. <Github width="24" height="24" />
  331. ```
  332. ### CDN
  333. ```html
  334. <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/github/default.svg" width="32" height="32" alt="GitHub" />
  335. ```
  336. ### CLI
  337. ```bash
  338. npx @thesvg/cli add github
  339. npx @thesvg/cli search "ai"
  340. ```
  341. </details>
  342. ## Variants
  343. Icons support up to 7 variants to match any design context:
  344. | Variant | Key | Description |
  345. |---------|-----|-------------|
  346. | Default | `default` | Primary brand color |
  347. | Mono | `mono` | Inherits text color |
  348. | Light | `light` | Dark fill, for light backgrounds |
  349. | Dark | `dark` | Light fill, for dark backgrounds |
  350. | Wordmark | `wordmark` | Full text logo |
  351. | Wordmark Light | `wordmarkLight` | White text logo |
  352. | Wordmark Dark | `wordmarkDark` | Dark text logo |
  353. Not every icon has all variants. `default` is always present.
  354. ## UI icons
  355. Interface icons we draw ourselves, in seven looks. Browse them at [thesvg.org/ui](https://thesvg.org/ui).
  356. ```bash
  357. npm install @thesvg/ui-react
  358. ```
  359. ```tsx
  360. import { BellIcon, BellGlassIcon } from "@thesvg/ui-react";
  361. // Outline is the plain name, every other look adds its name.
  362. <BellIcon size={24} aria-label="Notifications" />
  363. <BellGlassIcon size={32} />
  364. ```
  365. One export per look means a look you do not import never reaches your bundle. Vue, Svelte and React Native packages follow the same naming (`@thesvg/ui-vue`, `@thesvg/ui-svelte`, `@thesvg/ui-react-native`).
  366. | What | Where |
  367. |------|-------|
  368. | One icon file | `https://thesvg.org/ui/{slug}/{look}.svg` |
  369. | Every icon in one look | `https://cdn.jsdelivr.net/gh/glincker/thesvg@main/src/data/ui/looks/{look}.json` |
  370. | Manifest (slugs, tags, categories, quality) | `https://cdn.jsdelivr.net/gh/glincker/thesvg@main/src/data/ui-icons.json` |
  371. | CLI | `npx @thesvg/cli add ui:bell --look glass` |
  372. Looks: `outline`, `glass`, `duotone`, `offset`, `fill`, `glass-outline`, `depth`. The UI icons are original drawings released under the [MIT license](./LICENSE) like the rest of the code. To add or change icons, see [Contributing to UI icons](./CONTRIBUTING.md#ui-icons).
  373. ## CDN
  374. Use any icon directly without installing:
  375. ```html
  376. <!-- From thesvg.org -->
  377. <img src="https://thesvg.org/icons/github/default.svg" width="32" height="32" alt="GitHub" />
  378. <!-- From jsDelivr -->
  379. <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/github/default.svg" width="32" height="32" alt="GitHub" />
  380. ```
  381. **URL pattern:** `https://thesvg.org/icons/{slug}/{variant}.svg`
  382. ## API
  383. <details>
  384. <summary>Static manifest, mirrors and examples</summary>
  385. 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.
  386. Base URL: `https://thesvg.org`
  387. | Endpoint | Description |
  388. |----------|-------------|
  389. | `GET /api/registry.json` | Full icon manifest (slug, title, aliases, categories, hex, url, variant keys) |
  390. | `GET /api/categories.json` | Category list with counts |
  391. | `GET /icons/{slug}/{variant}.svg` | Raw SVG file (e.g. `/icons/openai/default.svg`) |
  392. ```bash
  393. # Fetch the manifest once, filter client-side
  394. curl "https://thesvg.org/api/registry.json" | jq '.icons[] | select(.slug | contains("openai"))'
  395. # Then pull the SVG you want
  396. curl "https://thesvg.org/icons/openai/default.svg"
  397. ```
  398. ### Mirrors
  399. For high-traffic apps, use jsDelivr (free, GitHub-backed) instead of hitting `thesvg.org` directly:
  400. ```
  401. https://cdn.jsdelivr.net/gh/glincker/thesvg@main/src/data/icons.json
  402. https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/{slug}/{variant}.svg
  403. ```
  404. `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`).
  405. 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)).
  406. > 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.
  407. </details>
  408. ## Categories
  409. Icons are organized into 150+ categories:
  410. `AI` `Analytics` `Identity` `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...
  411. ## Community
  412. Questions, icon requests, or showing off what you built? Join the official GLINR Discord, home of theSVG and every other GLINCKER open source project. theSVG has its own forum there, and new releases post to it automatically.
  413. <a href="https://discord.gg/Ar5pcaZB99"><img src="https://discord.com/api/guilds/829168897080557579/widget.png?style=banner2" alt="Join the GLINR Discord" /></a>
  414. ## Run it locally
  415. You need [Node.js](https://nodejs.org) 20 or newer and [pnpm](https://pnpm.io).
  416. ```bash
  417. git clone https://github.com/glincker/thesvg.git
  418. cd thesvg
  419. pnpm install
  420. pnpm dev # http://localhost:3333
  421. ```
  422. | Command | What it does |
  423. | --- | --- |
  424. | `pnpm dev` | Starts the site with hot reload on port 3333 |
  425. | `pnpm build` | Regenerates the API, `llms.txt`, feed and icon tones, then builds the static site |
  426. | `pnpm lint` | Runs ESLint |
  427. | `pnpm test` | Runs the Vitest suite plus the CLI and icons package tests |
  428. | `npx tsx scripts/validate-icons.ts` | Audits every SVG for scripts, bad values, non-mono mono files and missing `viewBox` |
  429. **Add an icon:** put the files in `public/icons/{slug}/` (`default.svg`, plus `mono`, `light`, `dark` or `wordmark` as they apply), register the slug in `src/data/icons.json`, run the validator, then open a pull request. Full rules are in [CONTRIBUTING.md](./CONTRIBUTING.md).
  430. ## Contributing
  431. Every brand deserves a place. No gatekeeping.
  432. **Submit an icon:** [thesvg.org/submit](https://thesvg.org/submit) or open a [pull request](https://github.com/glincker/thesvg/pulls).
  433. **Development setup:**
  434. ```bash
  435. git clone https://github.com/glincker/thesvg.git
  436. cd thesvg
  437. pnpm install
  438. pnpm dev # http://localhost:3333
  439. ```
  440. **UI icons** have their own flow: edit a set file in `src/data/ui/sets`, run `pnpm ui:build`, and test with `pnpm test:ui`. Brand work stays in `pnpm test:brand`. See [CONTRIBUTING.md](./CONTRIBUTING.md) for full guidelines.
  441. Questions and icon requests are welcome in the [Discord](https://discord.gg/Ar5pcaZB99).
  442. ## Contributors
  443. <a href="https://github.com/glincker/thesvg/graphs/contributors">
  444. <img src="https://contrib.rocks/image?repo=glincker/thesvg" alt="theSVG contributors" />
  445. </a>
  446. ## Follow along
  447. New icons, rebrands and releases land every week. To keep up:
  448. - **Star and watch** the repo. Use *Watch, Custom, Releases* to hear about each new version.
  449. - **Follow [GLINCKER](https://github.com/glincker)** on GitHub for the rest of what we build.
  450. - **Join the [Discord](https://discord.gg/Ar5pcaZB99)** to request icons and see releases the moment they ship.
  451. - **Browse [thesvg.org](https://thesvg.org)** to see what was added recently.
  452. ## Sponsor
  453. theSVG runs on hosting, bandwidth, and maintainer time. If the catalog saves you a couple of hours a year, [pick a tier](./SPONSORS.md) and lock that value in. Tiers start at $5/mo and stack from Sketch up to Canvas.
  454. [Sponsor on GitHub](https://github.com/sponsors/glincker)
  455. ## Support
  456. theSVG runs on hosting, bandwidth and maintainer time. [Sponsor on GitHub](https://github.com/sponsors/glincker) or star the repo so other developers can find it.
  457. <p align="center">
  458. <a href="https://github.com/glincker/thesvg"><img src="https://img.shields.io/badge/%E2%98%85%20Star%20thesvg%20on%20GitHub-C2410C?style=for-the-badge" alt="Star thesvg on GitHub" /></a>
  459. </p>
  460. <a href="https://star-history.com/#glincker/thesvg&Date">
  461. <picture>
  462. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=glincker/thesvg&type=Date&theme=dark" />
  463. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=glincker/thesvg&type=Date" />
  464. <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=glincker/thesvg&type=Date" width="600" />
  465. </picture>
  466. </a>
  467. ## Disclaimer
  468. 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.
  469. 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.
  470. 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 **support@glinr.com**. See our [Legal Notice](https://thesvg.org/legal), [TRADEMARK.md](./TRADEMARK.md), and [LEGAL.md](./LEGAL.md) for full details.
  471. ## License
  472. [MIT](./LICENSE) for the codebase, tooling and the UI icons. Individual brand icons remain the intellectual property of their respective trademark holders.
  473. ## Star History
  474. <a href="https://star-history.com/#glincker/thesvg&Date">
  475. <picture>
  476. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=glincker/thesvg&type=Date&theme=dark" />
  477. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=glincker/thesvg&type=Date" />
  478. <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=glincker/thesvg&type=Date" width="600" />
  479. </picture>
  480. </a>
  481. ---
  482. <p align="center">
  483. <a href="https://thesvg.org">thesvg.org</a> &nbsp;&bull;&nbsp;
  484. <a href="./docs/install.md">Install</a> &nbsp;&bull;&nbsp;
  485. <a href="./docs/extensions.md">Extensions</a> &nbsp;&bull;&nbsp;
  486. <a href="https://github.com/glincker/thesvg/issues">Issues</a>
  487. </p>
  488. <p align="center"><sub>Built by GLINCKER. More from the team:</sub></p>
  489. <table align="center">
  490. <tr>
  491. <td align="center" width="33%">
  492. <a href="https://github.com/glincker"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/glincker/light.svg" /><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/glincker/default.svg" height="40" alt="GLINCKER" /></picture><br /><b>GLINCKER</b></a><br />
  493. <sub>Open source from the team behind theSVG</sub>
  494. </td>
  495. <td align="center" width="33%">
  496. <a href="https://levelrail.com"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/levelrail/default.svg" height="40" alt="Levelrail" /><br /><b>Levelrail</b></a><br />
  497. <sub>Self-hosted alternative to Vercel and Coolify. Git push, HTTPS, logs, rollback.</sub>
  498. </td>
  499. <td align="center" width="33%">
  500. <a href="https://theauth.dev"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/theauth/default.svg" height="40" alt="theAuth" /><br /><b>theAuth</b></a><br />
  501. <sub>Auth for AI agents and humans. Agent identity, MCP OAuth 2.1, audit.</sub>
  502. </td>
  503. </tr>
  504. </table>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.