@i316/phosphor-react-native
v0.1.1
Published
i316: Phosphor icons as React Native components (react-native-svg).
Maintainers
Readme
@i316/phosphor-react-native
i316: Phosphor icons as React Native components, rendered with react-native-svg. 1,512 icons in 6 styles: thin, light, regular (default), bold, fill, duotone.
Other i316 Phosphor packages: @i316/phosphor-react (React web), @i316/phosphor-vue (Vue 3), @i316/phosphor-angular (Angular) and @i316/phosphor-web (plain HTML web component and raw SVGs).
npm install @i316/phosphor-react-native react-native-svgPeer dependencies: react >= 16.8, react-native-svg >= 13. Install react-native-svg in your app; it is never bundled.
Set up tree-shaking first
Metro (the React Native bundler) does not tree-shake. Without help, import { Bell } from '@i316/phosphor-react-native/regular' puts every regular icon in your app. Add the bundled Babel plugin, which rewrites those imports to per-icon files at compile time:
// babel.config.js (on Expo, add the same `plugins` line next to babel-preset-expo)
module.exports = {
presets: ['module:@react-native/babel-preset'],
plugins: ['@i316/phosphor-react-native/babel'],
};Then restart Metro with a clean cache (npx react-native start --reset-cache, or npx expo start -c). The plugin handles named imports from the root and from the style paths. Namespace imports (import * as Icons) can't be rewritten and still pull in the whole barrel.
Usage
// One style: every icon is exported as both `Bell` and `BellIcon`.
import { Bell, CaretDownIcon } from '@i316/phosphor-react-native/regular';
// Any style from the root: <Name><Style>Icon, or <Name>Icon to switch style at runtime.
import { HouseIcon, BellBoldIcon, PhosphorIconProvider } from '@i316/phosphor-react-native';
<PhosphorIconProvider size={20} color="currentColor">
<Bell title="Notifications" testID="bell" />
<HouseIcon variant={focused ? 'bold' : 'regular'} />
</PhosphorIconProvider>Props on an icon override the provider. Nested providers override their parent's values.
Props
| Prop | Default | |
|---|---|---|
| size | 24 | width and height |
| color | currentColor | icon color |
| secondaryColor | color | color of the translucent layer, duotone only |
| secondaryOpacity | as designed | opacity of that layer, duotone only |
| title | none | sets accessible, accessibilityRole="image" and accessibilityLabel |
| variant | regular | <Name>Icon only: which style to render |
All other props pass through to <Svg> (style, testID, onPress, …), and ref is forwarded.
License
Icons: Phosphor Icons (https://github.com/phosphor-icons/core), licensed under MIT. i316 modified them: reformatted and grouped into folders by each icon's primary upstream category; converted into React, React Native, Vue, Angular and web-component formats.
i316 code (components, runtime, tooling): MIT, © 2026 rahil316. See LICENSE for both licenses in full.
