Unicon

Unicon

Just the icons you need. Zero bloat.

Browse 20,000+ icons and copy exactly what you need. Like shadcn/ui, but for icons.

Try it now at unicon.sh

[](https://github.com/WebRenew/unicon/actions/workflows/ci.yml) [](https://www.npmjs.com/package/@webrenew/unicon) [](https://opensource.org/licenses/MIT)

Why Unicon?

Most icon libraries force you to install thousands of icons just to use a handful. Unicon lets you browse everything in one place and copy only what you need.

• Browse once, use anywhere — Search 9 icon libraries
• Copy exactly what you need — React, SVG, or JSON
• Bundle multiple icons — Export a set at once
• Zero dependencies — Paste directly into your project

Icon Libraries

| Library | Icons | Style | |---------|-------|-------| | Lucide | 1,500+ | Minimal, consistent stroke | | Phosphor | 1,300+ | 6 weights per icon | | Huge Icons | 4,000+ | Modern, versatile | | Heroicons | 300+ | By Tailwind CSS team | | Tabler | 5,000+ | Clean, customizable | | Feather | 280+ | Simple, elegant | | Remix Icon | 2,800+ | Outlined & filled | | Simple Icons | 3,300+ | Brand logos | | Iconoir | 1,600+ | Regular & solid |

Coming Soon

| Library | Icons | License | Focus | |---------|-------|---------|-------| | Carbon | 2,000+ | Apache-2.0 | IBM's enterprise design system | | Blueprint | 300+ | Apache-2.0 | Palantir's data-focused icons | | Devicons | 200+ | MIT | Programming languages & dev tools | | Octicons | 600+ | MIT | GitHub's icon set | | Cryptocurrency Icons | 400+ | CC0 | Coins and tokens |

How to Use

1. Search for icons

Use natural language — search "happy face" to find smile icons, or "business" for briefcases and charts.

2. Copy what you need

Click any icon and choose your format:

React Component — Drop directly into your project:

export const ArrowRight = (props) => (
  
    
  
)

Raw SVG — For HTML, design tools, or anywhere else:

3. Bundle multiple icons

Select multiple icons and export as:

• Single file with all React components
• Individual SVG files
• JSON metadata

4. Open in v0

Send icons to v0.dev to prototype UI components.

CLI

Install icons directly from your terminal.

Installation

npm install -g @webrenew/unicon

# Or use npx (no install)
npx @webrenew/unicon search arrow

Quick Start

# Search for icons
unicon search "dashboard"

# Get icon as React component
unicon get home

# Copy to clipboard (macOS)
unicon get home | pbcopy

# Save to file
unicon get settings -o ./Settings.tsx

# Bundle icons by category
unicon bundle --category Dashboards

# Preview in terminal
unicon preview star

Output Formats

| Format | Description | |--------|-------------| | react | React/TS components (default) | | vue | Vue 3 SFCs | | svelte | Svelte components | | svg | Raw SVG | | json | Icon metadata |

Config-Driven Workflow

For larger projects, use a config file:

unicon init
unicon add dashboard --category Dashboards
unicon add nav --query "arrow chevron"
unicon sync

See [CLI.md](./CLI.md) for full documentation.

AI Integration

Unicon works with AI coding assistants.

Skills for AI Assistants

Install rules that teach AI assistants to use Unicon:

unicon skill --ide claude
unicon skill --ide cursor
unicon skill --all

Supported: Claude Code, Cursor, Windsurf, Agent, Antigravity, OpenCode, Codex, Aider

Then ask your AI:

• "Add a home icon to my project"
• "Search for dashboard icons"

MCP Server

For deeper integration, use the MCP server.

Claude Desktop / Cursor:

{
  "mcpServers": {
    "unicon": {
      "command": "npx",
      "args": ["-y", "@webrenew/unicon-mcp-server"]
    }
  }
}

Cloud IDEs (v0, Bolt, Lovable):

https://unicon.sh/api/mcp

Tools: search_icons, get_icon, get_multiple_icons, get_starter_pack

See [MCP docs](./packages/mcp-server/README.md) for details.

Self-Hosting

Want to run your own instance? See [DEVELOPMENT.md](./DEVELOPMENT.md) for setup instructions.

Build Notes

• The app build uses webpack (next build --webpack) for deterministic CI/local builds in restricted environments.
• The home route (/) is intentionally dynamic to avoid build-time database fetches during prerender.

[](https://vercel.com/new/clone?repository-url=https://github.com/WebRenew/unicon)

License

MIT License — see [LICENSE](LICENSE) for details.

Icons retain their original licenses. See [THIRDPARTYLICENSES.md](THIRDPARTYLICENSES.md) for full attribution.

• MIT: Lucide, Phosphor, Huge Icons, Heroicons, Tabler, Feather, Iconoir, Devicons, Octicons
• Apache-2.0: Remix Icon, Carbon, Blueprint
• CC0: Simple Icons, Cryptocurrency Icons (logos are trademarks of their owners)

---

Built by WebRenew

unicon.sh · Issues

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: webrenew
• Source: webrenew/unicon
• License: MIT
• Homepage: https://unicon.sh

Install and usage instructions live in the source repository linked above.