Roc Icons (@marcus/roc)
Handcrafted SVG icon library with 416 icons across 4 styles. Use this skill when adding, replacing, or configuring icons in any project.
Browse all icons: https://roc.haplab.com
Install
npm install @marcus/roc
Requires Node.js 22+.
Styles
| Style |
Import path |
Description |
Use when |
| outline |
*/outline |
Rounded strokes, 1.5px |
Default for most UI |
| solid |
*/solid |
Filled shapes |
Active/selected states, nav bars |
| duotone |
*/duotone |
Tinted bg + outline strokes |
Feature highlights, dashboards |
| sharp |
*/sharp |
Angular, miter joins, butt caps |
Technical/developer UIs |
Pick one style per context. Don't mix outline and solid in the same toolbar.
React
import { Home, Bell, Search } from '@marcus/roc/react/outline';
<Home size={20} className="text-gray-500" />
<Bell size={20} />
<Search size={16} /> {/* stroke auto-adjusts to 1.75 at <=16px */}
Import patterns
// Single style barrel import
import { Home, Bell } from '@marcus/roc/react/outline';
import { Home, Bell } from '@marcus/roc/react/solid';
import { Home, Bell } from '@marcus/roc/react/duotone';
import { Home, Bell } from '@marcus/roc/react/sharp';
Props
| Prop |
Type |
Default |
Notes |
size |
number |
24 |
Width and height in px |
strokeWidth |
number |
auto |
1.75 at <=16px, 1.5 at 20px+. Only on stroked styles (outline, duotone, sharp). |
className |
string |
— |
CSS class |
...rest |
SVGProps |
— |
All standard SVG attributes passed through |
Svelte
<script>
import Home from '@marcus/roc/svelte/outline/Home.svelte';
import Bell from '@marcus/roc/svelte/solid/Bell.svelte';
</script>
<Home size={24} class="icon" />
<Bell size={20} />
Import patterns
// Individual component (recommended for Svelte)
import Home from '@marcus/roc/svelte/outline/Home.svelte';
// Barrel import (works but larger bundle)
import { Home, Bell } from '@marcus/roc/svelte/outline';
Component names are PascalCase: arrow-left.svg becomes ArrowLeft.svelte.
HTML Sprite
Copy dist/sprite.svg to your public directory, then:
<svg width="24" height="24" class="text-gray-700">
<use href="/sprite.svg#home-outline" />
</svg>
Symbol IDs: {name}-{style} (e.g., bell-solid, search-duotone, home-sharp).
Duotone Setup
Duotone icons require a CSS custom property. Add once globally:
:root {
--color-duotone-fill: rgba(94, 106, 210, 0.15);
}
Adjust the color/opacity to match your design system. Common values:
/* Blue tint (default) */
--color-duotone-fill: rgba(94, 106, 210, 0.15);
/* Brand-colored */
--color-duotone-fill: rgba(var(--brand-rgb), 0.12);
/* Neutral */
--color-duotone-fill: rgba(0, 0, 0, 0.08);
Metadata
import metadata from '@marcus/roc/metadata';
// { icons: [...], categories: [...], total: 416 }
Use for building icon pickers, search, or documentation.
Available Icons
416 icons across 18 categories. See references/icon-catalog.md for the full list.
Categories: Navigation, Data, Communication, People, System, Brand, Actions, Files, Media, Weather, Transport, Commerce, Development, Devices, Objects, Food, Gaming, Nature
Common icons by use case:
| Use case |
Icons |
| Navigation |
home, arrow-*, chevron-*, caret-*, compass, map, globe |
| Forms & input |
search, check, x, plus, minus, eye, eye-off, pencil |
| CRUD actions |
plus, pencil, trash, copy, download, upload, share |
| Auth & security |
lock, unlock, key, shield, shield-check, fingerprint, sign-out |
| Notifications |
bell, mail, inbox, send, message-circle, chat |
| Media controls |
play, pause, stop, skip-forward, skip-back, volume, volume-off |
| Status & feedback |
check-circle, x-circle, alert-triangle, alert-circle, info, help-circle |
| Data viz |
chart, pie-chart, line-chart, bar-chart, trending-up, trending-down, activity |
| E-commerce |
shopping-cart, shopping-bag, credit-card, dollar, euro, tag, receipt |
| Social/Brand |
github, twitter-logo, discord-logo, slack-logo, linkedin-logo + 30 more |
Migration from Other Libraries
From Lucide / Heroicons / Phosphor
- Replace the import source:
// Before (Lucide)
import { Home, Bell } from 'lucide-react';
// After (Roc)
import { Home, Bell } from '@marcus/roc/react/outline';
Props map directly: size, strokeWidth, className all work the same.
Name differences: most icon names match Lucide conventions. Check the icon catalog for exact names. Key differences:
- Kebab-case filenames:
arrow-left not arrowLeft
- PascalCase components:
ArrowLeft (same as Lucide)
- Brand icons use
-logo suffix: github (icon), twitter-logo, discord-logo
From Font Awesome
Replace <i> tags with components:
// Before
<i className="fa-solid fa-house" />
// After
import { Home } from '@marcus/roc/react/solid';
<Home size={20} />
Svelte migration
<!-- Before (any icon lib) -->
<Icon name="home" />
<!-- After (Roc) -->
<script>
import Home from '@marcus/roc/svelte/outline/Home.svelte';
</script>
<Home size={24} />
Checklist for Migration
1---2name: roc-icons3description: "Use Roc icon library (@marcus/roc) in projects. Covers React, Svelte, and HTML sprite usage, all 4 styles, and migration from other icon sets."4tags: [icons, react, svelte, svg, ui]5metadata:6 source: https://skillmd.com/skills/marcus/roc-icons7---89# Roc Icons (@marcus/roc)1011Handcrafted SVG icon library with 416 icons across 4 styles. Use this skill when adding, replacing, or configuring icons in any project.1213**Browse all icons**: https://roc.haplab.com1415## Install1617```bash18npm install @marcus/roc19```2021Requires Node.js 22+.2223## Styles2425| Style | Import path | Description | Use when |26|-------|------------|-------------|----------|27| **outline** | `*/outline` | Rounded strokes, 1.5px | Default for most UI |28| **solid** | `*/solid` | Filled shapes | Active/selected states, nav bars |29| **duotone** | `*/duotone` | Tinted bg + outline strokes | Feature highlights, dashboards |30| **sharp** | `*/sharp` | Angular, miter joins, butt caps | Technical/developer UIs |3132Pick one style per context. Don't mix outline and solid in the same toolbar.3334## React3536```jsx37import { Home, Bell, Search } from '@marcus/roc/react/outline';3839<Home size={20} className="text-gray-500" />40<Bell size={20} />41<Search size={16} /> {/* stroke auto-adjusts to 1.75 at <=16px */}42```4344### Import patterns4546```jsx47// Single style barrel import48import { Home, Bell } from '@marcus/roc/react/outline';49import { Home, Bell } from '@marcus/roc/react/solid';50import { Home, Bell } from '@marcus/roc/react/duotone';51import { Home, Bell } from '@marcus/roc/react/sharp';52```5354### Props5556| Prop | Type | Default | Notes |57|------|------|---------|-------|58| `size` | number | 24 | Width and height in px |59| `strokeWidth` | number | auto | 1.75 at <=16px, 1.5 at 20px+. Only on stroked styles (outline, duotone, sharp). |60| `className` | string | — | CSS class |61| `...rest` | SVGProps | — | All standard SVG attributes passed through |6263## Svelte6465```svelte66<script>67 import Home from '@marcus/roc/svelte/outline/Home.svelte';68 import Bell from '@marcus/roc/svelte/solid/Bell.svelte';69</script>7071<Home size={24} class="icon" />72<Bell size={20} />73```7475### Import patterns7677```js78// Individual component (recommended for Svelte)79import Home from '@marcus/roc/svelte/outline/Home.svelte';8081// Barrel import (works but larger bundle)82import { Home, Bell } from '@marcus/roc/svelte/outline';83```8485Component names are PascalCase: `arrow-left.svg` becomes `ArrowLeft.svelte`.8687## HTML Sprite8889Copy `dist/sprite.svg` to your public directory, then:9091```html92<svg width="24" height="24" class="text-gray-700">93 <use href="/sprite.svg#home-outline" />94</svg>95```9697Symbol IDs: `{name}-{style}` (e.g., `bell-solid`, `search-duotone`, `home-sharp`).9899## Duotone Setup100101Duotone icons require a CSS custom property. Add once globally:102103```css104:root {105 --color-duotone-fill: rgba(94, 106, 210, 0.15);106}107```108109Adjust the color/opacity to match your design system. Common values:110111```css112/* Blue tint (default) */113--color-duotone-fill: rgba(94, 106, 210, 0.15);114115/* Brand-colored */116--color-duotone-fill: rgba(var(--brand-rgb), 0.12);117118/* Neutral */119--color-duotone-fill: rgba(0, 0, 0, 0.08);120```121122## Metadata123124```js125import metadata from '@marcus/roc/metadata';126// { icons: [...], categories: [...], total: 416 }127```128129Use for building icon pickers, search, or documentation.130131## Available Icons132133416 icons across 18 categories. See [references/icon-catalog.md](references/icon-catalog.md) for the full list.134135**Categories**: Navigation, Data, Communication, People, System, Brand, Actions, Files, Media, Weather, Transport, Commerce, Development, Devices, Objects, Food, Gaming, Nature136137**Common icons by use case**:138139| Use case | Icons |140|----------|-------|141| Navigation | `home`, `arrow-*`, `chevron-*`, `caret-*`, `compass`, `map`, `globe` |142| Forms & input | `search`, `check`, `x`, `plus`, `minus`, `eye`, `eye-off`, `pencil` |143| CRUD actions | `plus`, `pencil`, `trash`, `copy`, `download`, `upload`, `share` |144| Auth & security | `lock`, `unlock`, `key`, `shield`, `shield-check`, `fingerprint`, `sign-out` |145| Notifications | `bell`, `mail`, `inbox`, `send`, `message-circle`, `chat` |146| Media controls | `play`, `pause`, `stop`, `skip-forward`, `skip-back`, `volume`, `volume-off` |147| Status & feedback | `check-circle`, `x-circle`, `alert-triangle`, `alert-circle`, `info`, `help-circle` |148| Data viz | `chart`, `pie-chart`, `line-chart`, `bar-chart`, `trending-up`, `trending-down`, `activity` |149| E-commerce | `shopping-cart`, `shopping-bag`, `credit-card`, `dollar`, `euro`, `tag`, `receipt` |150| Social/Brand | `github`, `twitter-logo`, `discord-logo`, `slack-logo`, `linkedin-logo` + 30 more |151152## Migration from Other Libraries153154### From Lucide / Heroicons / Phosphor1551561. Replace the import source:157158```jsx159// Before (Lucide)160import { Home, Bell } from 'lucide-react';161162// After (Roc)163import { Home, Bell } from '@marcus/roc/react/outline';164```1651662. Props map directly: `size`, `strokeWidth`, `className` all work the same.1671683. Name differences: most icon names match Lucide conventions. Check the [icon catalog](references/icon-catalog.md) for exact names. Key differences:169 - Kebab-case filenames: `arrow-left` not `arrowLeft`170 - PascalCase components: `ArrowLeft` (same as Lucide)171 - Brand icons use `-logo` suffix: `github` (icon), `twitter-logo`, `discord-logo`172173### From Font Awesome174175Replace `<i>` tags with components:176177```jsx178// Before179<i className="fa-solid fa-house" />180181// After182import { Home } from '@marcus/roc/react/solid';183<Home size={20} />184```185186### Svelte migration187188```svelte189<!-- Before (any icon lib) -->190<Icon name="home" />191192<!-- After (Roc) -->193<script>194 import Home from '@marcus/roc/svelte/outline/Home.svelte';195</script>196<Home size={24} />197```198199## Checklist for Migration200201- [ ] Install `@marcus/roc`202- [ ] Remove old icon package from dependencies203- [ ] Find-and-replace imports (match old names to Roc names via catalog)204- [ ] Add duotone CSS variable if using duotone style205- [ ] Verify icon rendering at target sizes (16, 20, 24)206- [ ] Check that `currentColor` inheritance works with your color system