Skip to content

glincker/thesvg

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

105 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

theSVG

4,700+ SVG icons. Brands, AWS Architecture, and more. Search, copy, ship.

npm downloads stars 4,752 icons license

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


theSVG - 4,000+ brand SVG icons


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.

  • 4,700+ icons across multiple collections
  • 4,000+ brand icons across 55+ categories
  • 739 AWS Architecture icons - services, resources, categories, and groups (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,013 Brand logos from 55+ categories
AWS Architecture 739 Official AWS service, resource, category, and group icons (2026-Q1)
GCP (coming soon) -- Google Cloud Platform icons
Azure (coming soon) -- Microsoft Azure icons

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 npm
@thesvg/icons Core icon data, tree-shakeable npm
@thesvg/react Typed React components npm
@thesvg/vue Typed Vue 3 components npm
@thesvg/svelte Typed Svelte components npm
@thesvg/cli CLI tool (npx @thesvg/cli add github) npm
@thesvg/mcp-server MCP server for AI assistants npm

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

Base URL: https://thesvg.org

Endpoint Description
GET /api/icons?q=github&category=AI&limit=20 Search icons
GET /api/icons/{slug} Get single icon with all metadata
GET /api/categories List categories with counts
GET /api/registry/{slug} shadcn-style registry endpoint
GET /icons/{slug}/{variant}.svg Raw SVG file
# Example: search for AI icons
curl "https://thesvg.org/api/icons?q=openai&limit=5"

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 [email protected]. 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

Star History Chart

thesvg.org  •  Issues