# React Native Icons (Pro)

> Patine Icons: 669 original SVG icons for React Native, Expo and the web, in outline, solid, duotone and color, across 27 categories from status and states to text editing, layout, development, food, sports and accessibility. Drawn on a 24-point grid with a 1.5 stroke, typed by name, mirrored in right-to-left layouts, decorative or labelled for screen readers, and tree-shakeable one module per icon. Part of Patine Pro, built on react-native-svg.

# Icons Pro

**Patine Icons** is an original set of 669 icons drawn for Patine, in 27 categories: status and states, navigation, actions, communication, media, files, text editing, layout, development, design, commerce and finance, charts, people, time, weather, devices, security, AI, maps and travel, home, food, sports, nature, science and math, accessibility, health and social. Every icon comes in four variants from one drawing:

| Variant | Looks like | Use it for |
| --- | --- | --- |
| `outline` (default) | A 1.5-point line with round caps and joins | Tab bars, buttons, lists: everywhere |
| `solid` | The shape filled, details cut out | The selected tab, a chosen star or heart |
| `duotone` | The line over a soft tint of the same color | Feature lists, settings rows, cards |
| `color` | Its own palette: an ink, a gradient fill and a warm accent | Empty states, onboarding, marketing |

```tsx
import { Icon } from '@patine-ui/pro';
```

## Example: an account menu

A profile menu drawn with the free set: one icon per row in the secondary color, the destructive row in the danger color, and the icons left out of the screen reader because each row already says what it does.

```tsx live
import { List, ListItem } from 'patine-ui';
import { Icon } from '@patine-ui/icons';
import type { IconName } from '@patine-ui/icons';

const ROWS: { icon: IconName; title: string; value?: string }[] = [
  { icon: 'user', title: 'Profile' },
  { icon: 'bell', title: 'Notifications', value: 'Mentions only' },
  { icon: 'card', title: 'Payment methods', value: 'Visa •••• 4242' },
  { icon: 'shieldCheck', title: 'Security', value: 'Two-step on' },
  { icon: 'globe', title: 'Language', value: 'English' },
];

export default function Example() {
  return (
    <List style={{ width: '100%', maxWidth: 400 }}>
      {ROWS.map((row) => (
        <ListItem key={row.title} leading={<Icon name={row.icon} />} title={row.title} value={row.value} onPress={() => {}} />
      ))}
      <ListItem leading={<Icon name="logOut" color="danger" />} title="Sign out" destructive showChevron={false} onPress={() => {}} />
    </List>
  );
}
```

## Free icons

227 of these icons are free and MIT licensed in `@patine-ui/icons`: the outline variant, with the same names and props as Pro's `Icon`, so moving up to Pro is an import change. It takes your `patine-ui` theme colors and flips directional icons in right-to-left layouts. `react-native-svg` is its peer; it runs in Expo Go and on the web, and `patine-ui` itself stays at zero dependencies.

```sh
npx expo install @patine-ui/icons react-native-svg
```

```tsx
import { Glyph, Icon, iconBell } from '@patine-ui/icons';

<Icon name="trash" size="lg" color="danger" accessibilityLabel="Delete" />
<Glyph icon={iconBell} size={24} color="primary" /> // imports one icon, not the set
```

`ICON_META` has a category and search words for each icon. Coding agents find icons by meaning with the [MCP server](../resources/mcp)'s `search_icons` tool.

## Gallery

Search by name or meaning ("money", "ai", "arrow"), pick a variant, size, stroke and color, and click an icon to copy its JSX.

## Usage

```tsx live
import { View } from 'react-native';
import { Icon } from '@patine-ui/pro';

<View style={{ flexDirection: 'row', gap: 16, alignItems: 'center' }}>
  <Icon name="bell" size="lg" />
  <Icon name="heart" size="lg" variant="solid" color="#E11D48" />
  <Icon name="wallet" size="lg" variant="duotone" color="primary" />
  <Icon name="sparkles" size={48} variant="color" />
  <Icon name="arrowRight" size="lg" accessibilityLabel="Next" />
</View>
```

`color` takes a theme color (`'primary'`, `'text'`, `'danger'`…) or any CSS color, so icons follow light and dark mode. `secondaryColor` sets the second layer: the tint in `duotone`, the fill in `color`.

### States

Status icons come in families, so a UI can move between states without changing its look: loading (`loaderCircle`, `circleDashed`, `progress25` to `progress100`, `pending`), outcome (`checkSquare`, `xSquare`, `alertOctagon`, `verified`, `badgeAlert`, `badgeX`), sync (`cloudSync`, `cloudCheck`, `cloudAlert`, `cloudOff`), connection (`signalLow`, `signalMedium`, `signalOff`, `wifiLow`, `wifiMedium`, `wifiOff`, `batteryCharging`, `batteryWarning`) and toggles (`toggleOn`, `toggleOff`, `radioButton`, `circleDot`).

```tsx live
import { View } from 'react-native';
import { Icon } from '@patine-ui/pro';

<View style={{ flexDirection: 'row', flexWrap: 'wrap', gap: 16, alignItems: 'center' }}>
  <Icon name="loaderCircle" size="lg" color="textSecondary" />
  <Icon name="progress50" size="lg" variant="duotone" color="primary" />
  <Icon name="cloudSync" size="lg" variant="color" />
  <Icon name="checkSquare" size="lg" variant="color" />
  <Icon name="badgeAlert" size="lg" variant="color" />
  <Icon name="alertOctagon" size="lg" variant="color" />
  <Icon name="cloudOff" size="lg" variant="duotone" />
  <Icon name="signalMedium" size="lg" />
  <Icon name="batteryCharging" size="lg" variant="color" />
  <Icon name="toggleOn" size="lg" variant="solid" color="primary" />
</View>
```

### Light bundles: one module per icon

`Icon` looks icons up by name, so it ships the whole set (about 200 kB, 40 kB gzipped). For the lightest app, import each icon's data and draw it with `Glyph`. Every icon is its own module, so only the ones you import ship, with Metro as well as webpack:

```tsx
import { Glyph } from '@patine-ui/pro';
import { iconBell } from '@patine-ui/pro/icons/bell';
import { iconCart } from '@patine-ui/pro/icons/cart';

<Glyph icon={iconBell} variant="duotone" />
```

The data is plain: `{ name, tone, rtl?, paths: [[d, role]] }`, SVG paths on a 24-point grid, so you can also draw it in a web `<svg>` or export it to a design tool.

### Accessibility

- **Decorative by default.** Without `accessibilityLabel` an icon is hidden from screen readers, so name the button or row it sits in.
- **Labelled when it stands alone.** With `accessibilityLabel` it's an image with that name.
- **Right to left.** Directional icons (arrows, chevrons, undo, send, reply, log in and out) flip when the layout is right to left. `mirror` overrides it either way.
- **Readable without color.** Every variant keeps the outline, so meaning never rests on the fill or the palette alone.

## Props

`Icon` and `Glyph` take the same props; `Icon` takes `name`, `Glyph` takes `icon`.

| Prop | Type | Default |
| --- | --- | --- |
| `name` | `IconName`: one of the 669 names, typed | |
| `icon` (`Glyph`) | `IconGlyph`, e.g. `iconBell` | |
| `variant` | `'outline' \| 'solid' \| 'duotone' \| 'color'` | `'outline'` |
| `size` | `'sm'` (16), `'md'` (20), `'lg'` (24) or points | `'md'` |
| `color` | Theme color or CSS color | `'textSecondary'`; the icon's palette in `color` |
| `secondaryColor` | Theme color or CSS color | `color` at 20% in `duotone`; a gradient in `color` |
| `strokeWidth` | `number`, on the 24-point grid | `1.5` |
| `accessibilityLabel` | `string` | None: decorative |
| `mirror` | `boolean` | Directional icons in right-to-left layouts |
| `filled` | `boolean`, same as `variant="solid"` | `false` |
| `style` | `ViewStyle` | |

`ICONS` maps every name to its data and `ICON_META` gives each a category and search words, for building your own icon picker.

## Drawing new icons

Icons are SVG files in `packages/pro/src/icons/svg`, drawn on a 24 × 24 grid with a 1.5 stroke, round caps and joins, inside a 1-point margin. A `class` on each shape says what the variants do with it: `body` (a closed shape: filled in solid, tinted in duotone), `inner` (a detail inside a body, cut out in solid), `accent` (the second color in `color`) and `cut` (drawn on top with a gap, like the slash in `eyeOff`). `pnpm --filter @patine-ui/pro icons` checks every file (grid, stroke, no fills or transforms, closed bodies, points inside the margin) and writes the typed modules; the test suite fails if a file breaks a rule or the modules are stale.
