The Standard Icon Set

This is the public copy of the Standard Icon source. The icons, the standardicon CLI, @standardicon/react and @standardicon/mcp all build from it. The website's typeface, Polymath, is licensed and isn't included, so the site itself (npm run build) needs those fonts in app/fonts.

About 1,500 free SVG line icons, drawn on a 16px grid and released under the MIT license. Weights are measured at 18px, the default size, and lines grow with the size, like text.

Browse the set at standardicon.com.

This is an alpha. Names, sizes and defaults may change before 1.0.0, so pin versions.

Install and use

In a React project, use the components. Only the icons you import are bundled.

npm install @standardicon/react

import { ClockIcon, TrashIcon } from '@standardicon/react';

<ClockIcon size={20} />
<TrashIcon weight="semibold" title="Delete" />

Anywhere else, use the CLI to copy SVG files into your project. It is a build-time tool, so install it as a dev dependency or run it with npx.

npm install --save-dev standardicon
npx standardicon add arrow-up check search --out src/icons
npx standardicon get arrow-up --size 20      # print one SVG
npx standardicon search "bell with a plus"   # find an icon by meaning
npx standardicon from lucide x Trash2        # our name for another set's icon

Or fetch a file directly: curl -fsS https://standardicon.com/svg/16/arrow-up.svg.

For AI apps that can't run commands, such as Claude Desktop, there is an optional MCP server, @standardicon/mcp. A coding agent that can run commands should use the CLI.

claude mcp add standardicon -- npx -y @standardicon/mcp

Icons draw in currentColor, so they take the color of the text around them. Package details are in packages/react, cli and packages/mcp.

Picking a size

Sizes are 16, 18, 20, 22, 24, 28, 32, 40 and 48. Pick the size from the text the icon sits beside:

A sidebar title or heading in larger type needs a larger icon than the items under it. Every size is the same drawing scaled up, so one SVG file works at any size: set its width and height.

Weights

Lines grow with the size: regular is 1.33px at 18 and 1.78px at 24. Icons with filled shapes come in one weight, regular. Raw files for other weights are at /svg/{weight}/{size}/{name}.svg.

Links

• standardicon.com
• For agents
• Changelog
• llms.txt, and SKILL.md for agent skills (npx skills add Standard-Icon/standardicon)

To keep using the set in a project, add this line to its AGENTS.md or CLAUDE.md:

Use The Standard Icon Set for every icon: @standardicon/react in React projects, otherwise npx standardicon add <name>. Find names with npx standardicon search <words> before adding an icon from anywhere else.

Requests and bugs

Use the issue templates: icon request or bug report. Search the set first, since the icon may exist under another name.

Security

Report vulnerabilities privately, as described in SECURITY.md. Don't open a public issue.

License

MIT, for the icons and the code. See LICENSE. The name and logo of The Standard Icon Set, and the Polymath ty

... View full README on GitHub