You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/SETUP-EXPO.md
+5-7Lines changed: 5 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,14 +1,12 @@
1
1
# Setup guide for Expo Apps
2
2
3
-
> If you use React Native without Expo, please follow [this guide](./SETUP-REACT-NATIVE.md) instead. This guide applies to Expo native apps only.
3
+
> If you use React Native without Expo, please follow [this guide](./SETUP-REACT-NATIVE.md) instead. This guide applies to Expo apps only.
4
4
5
-
`react-native-vector-icons` works out of the box with Expo native apps. No additional configuration is required.
6
-
7
-
For web, see the [web setup guide](./SETUP-WEB.md).
5
+
Icon packages from `@react-native-vector-icons` work out of the box with Expo, across all platforms. No additional configuration is required.
8
6
9
7
## ⚠️ Important: Avoid Manual Font Duplication
10
8
11
-
> **Note:** For recent versions of `react-native-vector-icons`, you usually do **not** need to add the icon fonts manually via the `expo-font` config plugin. The library automatically handles bundling its fonts for native platforms.
9
+
> **Note:** For recent versions of [`@react-native-vector-icons`](https://www.npmjs.com/org/react-native-vector-icons), you do **not** need to add the icon fonts manually via the `expo-font` config plugin. The library automatically handles bundling its fonts for native platforms.
12
10
13
11
Manually adding icon fonts via the `expo-font` plugin may lead to **duplicate font copies** and iOS build errors such as:
14
12
@@ -20,7 +18,7 @@ This issue has been discussed in [issue #1746](https://github.com/oblador/react-
20
18
21
19
✅ **Only add your own custom fonts** (e.g., brand fonts you provide) in the `expo-font` plugin configuration — not fonts from this library.
22
20
23
-
### ✅ Example: Correct Usage with Custom Fonts Only
21
+
### Example: Correct Usage with Custom Fonts Only
24
22
25
23
```js
26
24
module.exports= {
@@ -39,5 +37,5 @@ module.exports = {
39
37
}
40
38
```
41
39
42
-
🚫 **Do not add fonts from `node_modules/@react-native-vector-icons/Fonts` unless you have a specific advanced use case.**
40
+
🚫 **Do not add fonts from `node_modules/@react-native-vector-icons/some-font` unless you have a specific advanced use case.**
43
41
Avoiding this helps prevent build conflicts and ensures smooth integration with Expo and native builds.
0 commit comments