Skip to content

Document React Native Nano Icons - #1522

Merged
satya164 merged 4 commits into
mainfrom
@stachbial/native-tab-icon-docs
Oct 14, 2026
Merged

satya164 merged 4 commits into
mainfrom
@stachbial/native-tab-icon-docs

Conversation

@stachbial

Copy link
Copy Markdown
Contributor

Add React Native Nano Icons to the icons guide as a provider of custom native symbols: SF Symbols on iOS and vector drawables on Android.

@stachbial
stachbial requested a review from satya164 October 14, 2026 12:08
@stachbial
stachbial marked this pull request as ready for review October 14, 2026 12:08
@netlify

netlify Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for react-navigation-docs ready!

Name Link
🔨 Latest commit 4261ed6
🔍 Latest deploy log https://app.netlify.com/projects/react-navigation-docs/deploys/6acf7af18e20902e82a024ba
😎 Deploy Preview https://deploy-preview-1522--react-navigation-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Comment thread versioned_docs/version-8.x/icons.md Outdated

### [React Native Nano Icons](https://github.com/software-mansion-labs/react-native-nano-icons)

[React Native Nano Icons](https://nano-icons.swmansion.com/) provides a way to use custom SVG files as performant font-based icons, both in JavaScript-based and native navigation components.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

let's remove this part as it's not necessary to mention if it's supported everywhere

Suggested change
[React Native Nano Icons](https://nano-icons.swmansion.com/) provides a way to use custom SVG files as performant font-based icons, both in JavaScript-based and native navigation components.
[React Native Nano Icons](https://nano-icons.swmansion.com/) provides a way to use custom SVG files as performant font-based icons.

Comment thread versioned_docs/version-8.x/icons.md Outdated
Comment on lines +551 to +555
To use it, install the `react-native-nano-icons` package, then set it up depending on where the icons are rendered.

For JavaScript-based components, such as the `custom` [implementation](bottom-tab-navigator.md#implementation) of Bottom Tab Navigator, follow the [quick start](https://github.com/software-mansion-labs/react-native-nano-icons#-quick-start) and use the `Icon` component created with `createNanoIconSet`.

For native components, such as the tab bar with the `native` implementation, follow the [native symbols setup](https://github.com/software-mansion-labs/react-native-nano-icons#-native-symbols) to generate SF Symbols on iOS and vector drawables on Android from your SVG files, and rebuild the app.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

both native and custom implementations expose the same API so I think it'd be simpler to not mention this here and show a single path for everything.

so i'd make it like

Suggested change
To use it, install the `react-native-nano-icons` package, then set it up depending on where the icons are rendered.
For JavaScript-based components, such as the `custom` [implementation](bottom-tab-navigator.md#implementation) of Bottom Tab Navigator, follow the [quick start](https://github.com/software-mansion-labs/react-native-nano-icons#-quick-start) and use the `Icon` component created with `createNanoIconSet`.
For native components, such as the tab bar with the `native` implementation, follow the [native symbols setup](https://github.com/software-mansion-labs/react-native-nano-icons#-native-symbols) to generate SF Symbols on iOS and vector drawables on Android from your SVG files, and rebuild the app.
To use it, install the `react-native-nano-icons` package, then follow the [quick start](https://github.com/software-mansion-labs/react-native-nano-icons#-quick-start) to set it up with your SVG icons.

then at the end of the section, we can mention the Icon component for more general usage.

Comment thread versioned_docs/version-8.x/icons.md Outdated
Comment on lines +557 to +565
Pass the SVG file name to the `nativeNanoSymbol` function to create a type-safe icon. For example, for `newspaper.svg`:

```js
import { nativeNanoSymbol } from 'react-native-nano-icons/symbols';

// ...

tabBarIcon: nativeNanoSymbol('newspaper'),
```

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

more accurate would be to say icon name (as it's not a file name)

also rephrasing the sentence to avoid the pattern of "Do this" which reads more like instruction instead of guide:

Suggested change
Pass the SVG file name to the `nativeNanoSymbol` function to create a type-safe icon. For example, for `newspaper.svg`:
```js
import { nativeNanoSymbol } from 'react-native-nano-icons/symbols';
// ...
tabBarIcon: nativeNanoSymbol('newspaper'),
```
Then you can use the icon by passing the name to the `nativeNanoSymbol` function:
```js
import { nativeNanoSymbol } from 'react-native-nano-icons/symbols';
// ...
tabBarIcon: nativeNanoSymbol('newspaper'),
```
Here, we use `newspaper` as the icon name, which is the filename `newspaper.svg` without extension.

@satya164 satya164 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks 🙌

@satya164
satya164 merged commit 2d2169a into main Oct 14, 2026
5 checks passed
@satya164
satya164 deleted the @stachbial/native-tab-icon-docs branch October 14, 2026 12:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants