Skip to content

Commit cac2cc2

Browse files
committed
Update web support section
1 parent f93576b commit cac2cc2

File tree

2 files changed

+29
-5
lines changed

2 files changed

+29
-5
lines changed

docs/web-support.md

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,22 @@
11
---
22
id: web-support
33
title: React Navigation on the Web
4-
sidebar_label: Web Support
4+
sidebar_label: Web support
55
---
66

7-
Starting in v3, React Navigation has built-in support for web sites, including server rendering.
7+
> Note: starting in v3, React Navigation has built-in support for use in web sites, including server rendering. This has not yet been widely used in production and we consider this feature to be experimental.
8+
9+
# With react-native-web
10+
11+
> "[React Native for Web](https://github.com/necolas/react-native-web)" makes it possible to run React Native components and APIs on the web using React DOM.
12+
13+
This approach allows you to reuse most of React Navigation on the web because React Native for Web maps React Native primitives like `View`, `Text`, and others to their equivalents on the web.
14+
15+
The easiest way to get started with this approach is to use to use the [Expo CLI web support beta](https://blog.expo.io/expo-cli-and-sdk-web-support-beta-d0c588221375). More information on how to set this up in other projects will follow in the future, help on documenting it is also welcome!
16+
17+
# With standard web tools
18+
19+
This approach requires that you rebuild the navigation views for your app (at least until the community builds out an alternative), but allows you to leverage routers and simple navigators that don't require views, like the switch navigator.
820

921
To set up a navigator in a React app, [(such as one created with create-react-app)](https://github.com/react-navigation/example-web):
1022

website/versioned_docs/version-3.x/web-support.md

Lines changed: 15 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,23 @@
11
---
22
id: version-3.x-web-support
3-
title: React Navigation on the Web
4-
sidebar_label: Web Support
53
original_id: web-support
4+
title: React Navigation on the Web
5+
sidebar_label: Web support
66
---
77

8-
Starting in v3, React Navigation has built-in support for web sites, including server rendering.
8+
> Note: starting in v3, React Navigation has built-in support for use in web sites, including server rendering. This has not yet been widely used in production and we consider this feature to be experimental.
9+
10+
# With react-native-web
11+
12+
> "[React Native for Web](https://github.com/necolas/react-native-web)" makes it possible to run React Native components and APIs on the web using React DOM.
13+
14+
This approach allows you to reuse most of React Navigation on the web because React Native for Web maps React Native primitives like `View`, `Text`, and others to their equivalents on the web.
15+
16+
The easiest way to get started with this approach is to use to use the [Expo CLI web support beta](https://blog.expo.io/expo-cli-and-sdk-web-support-beta-d0c588221375). More information on how to set this up in other projects will follow in the future, help on documenting it is also welcome!
17+
18+
# With standard web tools
19+
20+
This approach requires that you rebuild the navigation views for your app (at least until the community builds out an alternative), but allows you to leverage routers and simple navigators that don't require views, like the switch navigator.
921

1022
To set up a navigator in a React app, [(such as one created with create-react-app)](https://github.com/react-navigation/example-web):
1123

0 commit comments

Comments
 (0)