@webrenew/unicon

CLI for browsing and exporting 19,000+ icons from 9 libraries.

Like shadcn/ui, but for icons. Search once, copy exactly what you need.

Installation

``bash
npm install -g @webrenew/unicon

Or use npx (no install needed)


npx @webrenew/unicon search arrow
`

Quick Start

`bash


Search for icons

unicon search "dashboard settings"

Get icon as React component

unicon get home

Copy to clipboard (macOS)

unicon get home | pbcopy

Save to file

unicon get settings --format react -o ./Settings.tsx

Bundle multiple icons

unicon bundle --category Dashboards -o ./icons

Preview in terminal

unicon preview star
`

Commands

| Command | Description |
|---------|-------------|
| search | AI-powered semantic search |
| get | Get single icon (React, Vue, Svelte, SVG) |
| bundle | Export multiple icons at once |
| preview | ASCII preview in terminal |
| info | Show icon metadata |
| init | Create .uniconrc.json config |
| sync | Regenerate all configured bundles |
| add | Add bundle to config |
| categories | List available categories |
| sources | List icon libraries |
| skill | Install AI assistant rules |

Output Formats

| Format | Flag | Description |
|--------|------|-------------|
| React | --format react | TypeScript component (default) |
| Vue | --format vue | Vue 3 SFC |
| Svelte | --format svelte | Svelte component |
| SVG | --format svg | Raw SVG |
| JSON | --format json | Icon metadata |

Config-Driven Workflow

For larger projects, define bundles in .uniconrc.json:

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

Icon Libraries

| Library | Icons |
|---------|-------|
| Lucide | 1,900+ |
| Phosphor | 1,500+ |
| Huge Icons | 1,800+ |
| Heroicons | 292 |
| Tabler | 4,600+ |
| Feather | 287 |
| Remix Icon | 2,800+ |
| Simple Icons | 3,300+ |
| Iconoir | 1,600+ |

AI Integration

Install rules for AI coding assistants:

`bash
unicon skill --ide claude
unicon skill --ide cursor
unicon skill --all
``

Then ask your AI to "add a home icon" and it will use Unicon.

Links

- Website: unicon.sh
- Full CLI Docs: CLI.md
- GitHub: github.com/WebRenew/unicon

License

MIT