README.md

5,880+ SVG icons. Brands, AWS, Azure, GCP, and more. Search, copy, ship.

Browse Icons  •  Install  •  Extensions  •  CDN  •  API  •  Packages  •  Compare  •  Contribute

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.

• 5,880+ icons across multiple collections
• 4,019 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,019	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. Icons are sourced from the official AWS Architecture Icons package and distributed unmodified under CC BY-ND 2.0. Updated quarterly.

Install

npm 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

Packages

Package	Description
thesvg	All icons in one package
@thesvg/icons	Core icon data, tree-shakeable
@thesvg/react	Typed React components
@thesvg/vue	Typed Vue 3 components
@thesvg/svelte	Typed Svelte components
@thesvg/cli	CLI tool (npx @thesvg/cli add github)
@thesvg/mcp-server	MCP server for AI assistants

Extensions

Use theSVG icons everywhere you build, design, and ship. Browse the full ecosystem at thesvg.org/extensions.

Extension	Status	Description
VS Code	Published	Search 5,880+ icons from the command palette. Copy SVG, JSX, CDN link, or insert at cursor.
Raycast	Published	Search, preview, and copy any brand SVG in one keystroke. Filter by category, preview variants.
MCP Server	Published	AI tool calls for Claude, Cursor, Windsurf. Fetch icons by name or category.
@thesvg/cli	Published	shadcn-style installer. npx @thesvg/cli add github drops the SVG into your project.
CDN via jsDelivr	Published	Serve any icon via global CDN. Drop into HTML, CSS, Markdown, Notion, Webflow, Framer.
Figma Plugin	Planned	Browse, search by name or color, drag straight onto your canvas.
JetBrains	Open	IntelliJ, WebStorm, PyCharm, Rider tool window. Help wanted.
Neovim	Open	Telescope picker with floating preview. Help wanted.
Alfred Workflow	Open	macOS quick access. Search anywhere, copy to clipboard. Help wanted.
Sketch / Blender / Webflow / Notion	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:

<!-- 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

import { Github, Figma } from "@thesvg/react";

export function Logos() {
  return <Github width={24} height={24} className="text-white" />;
}

Vue

<script setup>
import { Github, Figma } from "@thesvg/vue";
</script>

<template>
  <Github width="24" height="24" />
</template>

Svelte

<script>
  import { Github, Figma } from "@thesvg/svelte";
</script>

<Github width="24" height="24" />

CDN

<img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/github/default.svg" width="32" height="32" alt="GitHub" />

CLI

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)

# 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).

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 or open a pull request.

Development setup:

git clone https://github.com/glincker/thesvg.git
cd thesvg
pnpm install
pnpm dev     # http://localhost:3333

See 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 (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 or email support@glincker.com. See our Legal Notice, TRADEMARK.md, and LEGAL.md for full details.

License

MIT for the codebase and tooling. Individual brand icons remain the intellectual property of their respective trademark holders.

Star History

---

thesvg.org  •  Issues