Repository navigation
Document React Native Nano Icons - #1522
Merged
Merged
Conversation
stachbial
marked this pull request as ready for review
October 14, 2026 12:08
✅ Deploy Preview for react-navigation-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
satya164
requested changes
Oct 14, 2026
|
|
||
| ### [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. |
Member
There was a problem hiding this comment.
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 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. |
Member
There was a problem hiding this comment.
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 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'), | ||
| ``` |
Member
There was a problem hiding this comment.
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. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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.