React Native Infinity
CLI that generates React Native projects targeting any combination of platforms
iOS, Android, Web, Electron, Windows, MacOS
You can use the interactive tool in the docs to generate the CLI command you need, or simply use
npx react-native-infinity init to use the CLI interactive tool.
- Multi-Platform - Choose any combination of 6 platforms to target (iOS, Android, Web, Electron, Windows, MacOS)
- Add Platform - Add another platform anytime with
- UI Library - Add cross-platform UI libraries (Material Bread, UI Kitten)
- Interactive GUI - Online GUI to select platforms and libraries to get started
- Interactive CLI - Select platforms and libraries by answers questions in your terminal
You can install the project globally or use
$ npm install react-native-infinity -g
$ npx react-native-infinity <command>
init without a parameter will run an interactive prompt to gather the name, platforms, and UI library for the project.
init with the parameter
<name> provides the name of the app without using the interactive prompt. Although there are additional options and paramters, they are only used with the GUI tool on the website.
add-platform without a parameter starts a prompt to select a platform to add to your project.
add-platform <platform> with a parameter accepts a lowercase string indicating the platform to add.
npx react-native-infinity add-platform electron
Supported platform strings:
list lists all supported platforms with the shorthand name the GUI supports
React Native separates application code into
src and platform configuration into
ios. React Native Infinity extends this idea to more platforms. All application code lives in
src while each platform
windows has it's own folder that contains configuration files, including
webpack config. By separating out configuration in this way we can more easily pick and choose what platforms our apps should support both at initialization and later on.
This project is an experiment and meant as a starting off point for rendering on other platforms, not a full solution for all cases, some extra steps might be required for some platforms.
React Native on the web is supported by react-native-web, please check the documentation to learn more.
npm run web
./web/webpack.config.js. Config sets up an alias for
react-native-web. Runs on
npm run build-web
./web/webpack.config to build a production web build to
Electron with React requires two commands to run and uses react-native-web.
npm run electron
Starts the Electron window using config
npm run server
Runs react in the electron window using config
MacOS is supported by react-native-macos, please read the documentation for more information.
react-native-macos requires two commands to run an app:
npm run macos-start
Starts the packager
npm run macos
This command aliases
react-native-macos run-macos which opens a window.
Windows is supported by react-native-windows, please read the documentation for more information.
react-native-windows has some extra requirements to get running and requires React Native
0.59.10 at this time. Their Getting Started Guide is very helpful for getting up and running.
npm run windows
This command aliases
npm run android
react-native run-android, read the React Native docs for more information.
npm run ios
react-native run-ios, read the React Native docs for more information.
By extending the idea of isolated configuration further, we can easily copy over configuration for UI library setup as another step in initialization. Currently there are not many UI libraries that provide explicit support for all platforms, if you know of any more that should be added, please do not hesitate to create an issue or PR.
Material Bread supports all platforms and configuration is pretty simple, however, it does require setting up
react-native-svg if rendering on Android or IOS. Please read the docs for more information.
UI Kitten recently added support for
react-native-web, and configuration is very easy: simply select UI Kitten during
init. Please read the documentation for more information.