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 |
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.
<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.
npx expo install @patine-ui/icons react-native-svg
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'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
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).
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:
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
accessibilityLabelan icon is hidden from screen readers, so name the button or row it sits in. - Labelled when it stands alone. With
accessibilityLabelit'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.
mirroroverrides 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.