New documentation site and examples app

Replaces the old storybook with static HTML documentation and an interactive
examples app. The documentation is now easier to customize, easier to maintain,
and faster to load. The interactive examples are a dedicated Next.js app that
can be loaded and edited in codesandbox, as well as embedded in the
documentation where needed.

Author: necolas

.github/CONTRIBUTING.md

@@ -70,16 +70,23 @@ yarn compile
 yarn compile --watch
 ```
 
-## Documentation and visual tests
+## Documentation
 
-To run the interactive storybook:
+To run the documentation website:
 
 ```
-yarn docs
+yarn docs:dev
 ```
 
-When you're also making changes to the 'react-native-web' source files, run this
-command in another process:
+## Examples
+
+To run the examples app:
+
+```
+yarn examples:dev
+```
+
+When you're also making changes to the 'react-native-web' source files, run this command in another process:
 
 ```
 yarn compile --watch
@@ -90,7 +97,7 @@ yarn compile --watch
 To run the benchmarks locally:
 
 ```
-yarn benchmarks
+yarn benchmarks:dev
 open ./packages/benchmarks/dist/index.html
 ```
 

.gitignore

@@ -1,3 +1,5 @@
+.next
+build
 coverage
 node_modules
 dist

README.md

@@ -2,77 +2,15 @@
 
 [![npm version][package-badge]][package-url] [![Build Status][ci-badge]][ci-url] [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://reactjs.org/docs/how-to-contribute.html#your-first-pull-request)
 
-**Compatibility: React Native >= 0.63**.
-
-"React Native for Web" makes it possible to run [React
-Native][react-native-url] components and APIs on the web using React DOM.
-
-* **High-quality web interfaces**: makes it easy to
-create [fast](https://github.com/necolas/react-native-web/blob/master/packages/benchmarks/README.md),
-adaptive web UIs in JavaScript. It provides native-quality interactions, support
-for multiple input modes (touch, mouse, keyboard), optimized vendor-prefixed
-styles, built-in support for RTL layout, built-in accessibility, and integrates
-with React Dev Tools.
-
-* **Write once, render anywhere**: interoperates with existing React DOM
-components and is compatible with the majority of the React Native API. You can
-develop new components for native and web without rewriting existing code.
-React Native for Web can also render to HTML and critical CSS on the server
-using Node.js.
-
-Who is using React Native for Web in production?
-[Twitter](https://mobile.twitter.com),
-[Expo](https://docs.expo.io/workflow/web/),
-[Major League Soccer](https://matchcenter.mlssoccer.com),
-[Flipkart](https://twitter.com/naqvitalha/status/969577892991549440),
-[Uber](https://www.youtube.com/watch?v=RV9rxrNIxnY),
-[The Times](https://github.com/newsuk/times-components),
-[DataCamp](https://www.datacamp.com/community/tech/porting-practice-to-web-part1).
-
-Browser support: Chrome, Firefox, Edge, Safari 7+, IE 10+.
-
-Components and APIs deprecated in React Native are not supported by React Native for Web.
-
-## Quick start
-
-The easiest way to get started is to edit this
-[CodeSandbox](https://codesandbox.io/s/q4qymyp2l6) template. You don’t need to
-install anything to try it out.
+"React Native for Web" makes it possible to run [React Native][react-native-url] components and APIs on the web using React DOM.
 
 ## Documentation
 
-The [documentation app](https://necolas.github.com/react-native-web/docs) covers
-installation, configuration, APIs, and guides.
-
-The [React Native documentation][react-native-url] contains more information
-about the [Gesture Responder
-system](https://facebook.github.io/react-native/docs/gesture-responder-system.html),
-[animations](https://facebook.github.io/react-native/docs/animations.html), and
-other design details.
-
-## Libraries and integrations
-
-List of React Native packages with known web compatibility:
-
-* [React Native Directory](https://reactnative.directory/?web=true)
-
-Examples of using React Native for Web with other web tools:
-
-* [Docz](https://github.com/doczjs/docz/tree/master/examples/react-native)
-* [Gatsby](https://github.com/slorber/gatsby-plugin-react-native-web)
-* [Next.js](https://github.com/zeit/next.js/tree/master/examples/with-react-native-web)
-  (and [example recipes](https://gist.github.com/necolas/f9034091723f1b279be86c7429eb0c96))
-* [Phenomic](https://github.com/phenomic/phenomic/tree/master/examples/react-native-web-app)
-* [Razzle](https://github.com/jaredpalmer/razzle/tree/master/examples/with-react-native-web)
-* [Storybook](https://github.com/necolas/react-native-web/tree/master/packages/docs/)
-* [Styleguidist](https://github.com/styleguidist/react-styleguidist/tree/master/examples/react-native)
+The [documentation site](https://necolas.github.com/react-native-web/) covers installation, guides, and APIs.
 
-## Examples
+## Example
 
-And here is a simple example to get you started. The documentation includes
-interactive examples and the [source
-code](https://github.com/necolas/react-native-web/blob/master/packages/docs) is
-also available.
+And here is a simple example to get you started. The example app includes interactive examples and the [source code](https://github.com/necolas/react-native-web/blob/master/packages/docs) is also available.
 
 ```js
 import React from 'react';
@@ -99,116 +37,31 @@ AppRegistry.runApplication('App', { rootTag: document.getElementById('react-root
 
 This example will render the `App` into a container on the page.
 
-You'll notice that there is no reference to `react-dom`; the `App` component is
-defined using the platform-agnostic APIs and Components introduced by React
-Native. This allows the app to be rendered to web and native platforms.
-
-## Compatibility with React Native
-
-React Native v0.60
-
-### Components
-
-| Name                     | Status | Notes |
-| :----------------------- | :----- | :---- |
-| ActivityIndicator        | ✓      |  |
-| Button                   | ✓      |  |
-| CheckBox                 | ✓      |  |
-| FlatList                 | ✓      |  |
-| Image                    | ✓      | Missing multiple sources ([#515](https://github.com/necolas/react-native-web/issues/515)) and HTTP headers ([#1019](https://github.com/necolas/react-native-web/issues/1019)). |
-| ImageBackground          | ✓      |  |
-| KeyboardAvoidingView     | (✓)    | Mock. No equivalent web APIs. |
-| Modal                    | ✓      |  |
-| Picker                   | ✓      |  |
-| Pressable                | ✓      |  |
-| RefreshControl           | ✘      | Not started ([#1027](https://github.com/necolas/react-native-web/issues/1027)). |
-| SafeAreaView             | ✓      |  |
-| ScrollView               | ✓      | Missing momentum scroll events ([#1021](https://github.com/necolas/react-native-web/issues/1021)). |
-| SectionList              | ✓      |  |
-| StatusBar                | (✓)    | Mock. No equivalent web APIs. |
-| Switch                   | ✓      |  |
-| Text                     | ✓      | Missing `onLongPress` ([#1011](https://github.com/necolas/react-native-web/issues/1011)) support. |
-| TextInput                | ✓      | Missing rich text features ([#1023](https://github.com/necolas/react-native-web/issues/1023)), and auto-expanding behaviour ([#795](https://github.com/necolas/react-native-web/issues/795)). |
-| Touchable                | ✓      | Includes additional support for mouse and keyboard interactions. |
-| TouchableHighlight       | ✓      |  |
-| TouchableNativeFeedback  | ✘      | Not started ([#1024](https://github.com/necolas/react-native-web/issues/1024)). |
-| TouchableOpacity         | ✓      |  |
-| TouchableWithoutFeedback | ✓      |  |
-| View                     | ✓      |  |
-| VirtualizedList          | ✓      |  |
-| YellowBox                | (✓)    | Mock. No YellowBox functionality. |
-
-### Modules
-
-| Name                     | Status | Notes |
-| :----------------------- | :----- | :---- |
-| AccessibilityInfo        | (✓)    | Mock. No equivalent web APIs. |
-| Alert                    | ✘      | Not started ([#1026](https://github.com/necolas/react-native-web/issues/1026)). |
-| Animated                 | ✓      | Missing `useNativeDriver` support. |
-| Appearance               | ✓      |  |
-| AppRegistry              | ✓      | Includes additional support for server rendering with `getApplication`. |
-| AppState                 | ✓      |  |
-| BackHandler              | (✓)    | Mock. No equivalent web APIs. |
-| Clipboard                | ✓      |  |
-| DeviceInfo               | (✓)    | Limited information. |
-| Dimensions               | ✓      |  |
-| Easing                   | ✓      |  |
-| Geolocation              | ✓      |  |
-| I18nManager              | ✓      | Includes additional support for runtime switch to RTL. |
-| InteractionManager       | (✓)    |  |
-| Keyboard                 | (✓)    | Mock. |
-| LayoutAnimation          | (✓)    | Missing translation to web animations. |
-| Linking                  | ✓      |  |
-| NativeEventEmitter       | ✓      |  |
-| NativeMethodsMixin       | ✓      |  |
-| NativeModules            | (✓)    | Mocked. Missing ability to load native modules. |
-| PanResponder             | ✓      |  |
-| PixelRatio               | ✓      |  |
-| Platform                 | ✓      |  |
-| Settings                 | ✘      | No equivalent web APIs. |
-| Share                    | ✓      | Only available over HTTPS. Read about the [Web Share API](https://wicg.github.io/web-share/). |
-| StyleSheet               | ✓      |  |
-| UIManager                | ✓      |  |
-| Vibration                | ✓      |  |
-| useColorScheme           | ✓      |  |
-| useWindowDimensions      | ✓      |  |
+You'll notice that there is no reference to `react-dom`; the `App` component is defined using the platform-agnostic APIs and Components introduced by React Native. This allows the app to be rendered to web and native platforms.
 
 ## Contributing
 
-The main purpose of this repository is to help evolve React web and native
-development towards the platform-agnostic design of React Native, and in the
-process make it faster and easier to build high-quality experiences for the web
-with React. Development happens in the open on GitHub, and we are grateful for
-contributing bugfixes and improvements. Read below to learn how you can take
-part in improving React Native for Web.
+The main purpose of this repository is to help evolve React web and native development towards the platform-agnostic design of React Native, and in the process make it faster and easier to build high-quality experiences for the web with React. Development happens in the open on GitHub, and we are grateful for contributing bugfixes and improvements. Read below to learn how you can take part in improving React Native for Web.
 
 ### Code of conduct
 
-Facebook has adopted a [Code of Conduct][code-of-conduct] that this project
-expects all participants to adhere to. Please read the full text so that you
-can understand what actions will and will not be tolerated.
+Facebook has adopted a [Code of Conduct][code-of-conduct] that this project expects all participants to adhere to. Please read the full text so that you can understand what actions will and will not be tolerated.
 
 ### Contributing guide
 
-Read the [contributing guide][contributing-url] to learn about the
-development process, how to propose bugfixes and improvements, and how to build
-and test your changes to React Native for Web.
+Read the [contributing guide][contributing-url] to learn about the development process, how to propose bugfixes and improvements, and how to build and test your changes to React Native for Web.
 
 ### Good first issues
 
-To help you get you familiar with the contribution process, there is a list of
-[good first issues][good-first-issue-url] that contain bugs which have a
-relatively limited scope. This is a great place to get started.
+To help you get you familiar with the contribution process, there is a list of [good first issues][good-first-issue-url] that contain bugs which have a relatively limited scope. This is a great place to get started.
 
 ## License
 
-React Native for Web is [MIT licensed](./LICENSE). By contributing to React
-Native for Web, you agree that your contributions will be licensed under its
-MIT license.
+React Native for Web is [MIT licensed](./LICENSE). By contributing to React Native for Web, you agree that your contributions will be licensed under its MIT license.
 
 [package-badge]: https://img.shields.io/npm/v/react-native-web.svg?style=flat
-[package-url]: https://yarnpkg.com/en/package/react-native-web
-[ci-badge]: https://github.com/necolas/react-native-web/workflows/test/badge.svg
+[package-url]: https://www.npmjs.com/package/react-native-web
+[ci-badge]: https://github.com/necolas/react-native-web/workflows/tests/badge.svg
 [ci-url]: https://github.com/necolas/react-native-web/actions
 [react-native-url]: https://facebook.github.io/react-native/
 [contributing-url]: https://github.com/necolas/react-native-web/blob/master/.github/CONTRIBUTING.md

package.json

@@ -7,10 +7,14 @@
     "compile": "npm-run-all clean -p \"compile:* -- {@}\" --",
     "compile:commonjs": "cd packages/react-native-web && cross-env BABEL_ENV=commonjs babel --root-mode upward src --out-dir dist/cjs --ignore \"**/__tests__\"",
     "compile:es": "cd packages/react-native-web && babel --root-mode upward src --out-dir dist --ignore \"**/__tests__\"",
-    "benchmarks": "cd packages/benchmarks && yarn build",
-    "benchmarks:release": "cd packages/benchmarks && yarn release",
-    "docs": "cd packages/docs && yarn start",
-    "docs:release": "cd packages/docs && yarn release",
+    "benchmarks": "cd packages/benchmarks && yarn dev",
+    "benchmarks:build": "cd packages/benchmarks && yarn build",
+    "benchmarks:release": "yarn benchmarks:build && git checkout gh-pages && rm -rf ./docs/benchmarks && mv packages/benchmarks/dist ./docs/benchmarks && git add -A && git commit -m \"Deploy benchmarks\" && git push origin gh-pages && git checkout -",
+    "docs": "cd packages/docs && yarn dev",
+    "docs:build": "cd packages/docs && yarn build",
+    "docs:release": "yarn docs:build && git checkout gh-pages && rm -rf ./docs && mv packages/docs/dist ./docs && git add ./docs && git commit -m \"Deploy documentation\" && git push origin gh-pages && git checkout -",
+    "examples": "cd packages/examples && yarn dev",
+    "examples:build": "cd packages/examples && yarn build",
     "flow": "flow",
     "fmt": "prettier --write \"**/*.js\"",
     "fmt:report": "prettier --check \"**/*.js\"",
@@ -20,7 +24,7 @@
     "precommit": "lint-staged",
     "prerelease": "yarn test && yarn compile && yarn compile:commonjs",
     "release": "node ./scripts/release/publish.js",
-    "postrelease": "yarn benchmarks:release && yarn docs:release",
+    "postrelease": "yarn docs:release && yarn benchmarks:release && ",
     "test": "yarn flow && yarn lint:report && yarn jest --runInBand"
   },
   "devDependencies": {

packages/benchmarks/README.md

@@ -1,4 +1,4 @@
-# benchmarks
+# Benchmarks
 
 Try the [benchmarks app](https://necolas.github.io/react-native-web/benchmarks) online.
 

packages/benchmarks/package.json

@@ -3,8 +3,8 @@
   "name": "benchmarks",
   "version": "0.14.13",
   "scripts": {
-    "build": "mkdir -p dist && cp -f index.html dist/index.html && ./node_modules/.bin/webpack-cli --config ./webpack.config.js",
-    "release": "NODE_ENV=production yarn build && git checkout gh-pages && rm -rf ../../benchmarks && mv dist ../../benchmarks && git add -A && git commit -m \"Benchmarks deploy\" && git push origin gh-pages && git checkout -"
+    "dev": "mkdir -p dist && cp -f index.html dist/index.html && ./node_modules/.bin/webpack-cli --config ./webpack.config.js",
+    "build": "NODE_ENV=production yarn dev"
   },
   "dependencies": {
     "aphrodite": "^2.4.0",