react.cordova

Reco (react.cordova)

Welcome to Reco (React+Cordova). Reco unifies React.js and Cordova into one CLI which bundles both platforms together and provides the developer with the ability to generate Cordova hybrid cross-platform applications built in React.js. This bundled platform facilitates and automates project initialization, compilation and build actions for React.js developers who wish to build web/mobile/desktop applications using the powerful and most vast Cordova environment. Reco is the bundle where both Cordova and React.js platforms merge and work together as one. Enjoy your coding and development experience using Reco!

       
      React.js                            Cordova

I dedicate a considerable amount of my free time to developing and maintaining this Cli, along with my other Open Source software. To help ensure this Cli is kept updated, new features are added and bugfixes are implemented quickly, please donate a couple of dollars (or a little more if you can stretch) as this will help me to afford to dedicate time to its maintenance. Please consider donating if you're using this plugin in an app that makes you money, if you're being paid to make the app, if you're asking for new features or priority bug fixes.

Installing Reco CLI

npm install -g react.cordova

Initialize a new bundle project

reco init com.example.hello "hello world"

Note: creates both react-app and cordova-app and then will merge one into the other

Explore Reco CLI

To get full CLI reference of all commands and features currently available, run the following command

reco help

New version

project folder
 |
 |--src
 |--public
 |--platforms
 |--plugins
 |--www
 |--build
 |--hooks
 |--package.json
 |--package-lock.json
 |-- ... 

Serve debug mode

To run a bundle serve React and Cordova simulation

npm start

Project build

Perform a build action for your project using the following command

npm run build

npm run build <cordova platform>

Builds cordova-app for browser, mobile and other platforms.

Note: will generate an apk installable package for Android devices
Note: will generate an xcworkspace XCode project that can be compiled and built for deployment on iOS devices

Integrated Cordova CLI

To run Cordova CLI simply prepend the reco prefix to any Cordova command line

For example:

cordova <any cordova command line to run>

cordova platform

cordova platform <add/rm> <cordova platform>

cordova plugin <add/rm> <cordova plugin>

Learn more about Cordova: Cordova get started.

Integrated React.js CLI

You can run React.js CLI from within the project's directory

For example:

npm start

npm test

npm install <npm packages for react>

npm uninstall <npm packages for react>

npm <any react command line to run>

Learn more about React.js apps: create React.js app documentation
Learn programming in React.js: React.js documentation

Old version ( < 2.0.0)

project folder
 |
 |--cordova
 |    |
 |    |--hooks
 |    |--platforms
 |    |--plugins
 |    |--www
 |    |--package.json
 |    |--package-lock.json
 |    |-- ...
 |
 |--react-js
 |    |--src
 |    |--public
 |    |--build
 |    |--package.json
 |    |--package-lock.json
 |    |-- ... 

Serve debug mode

To run a bundle serve React and Cordova simulation

reco start

or

npm start

Project build

Perform a build action for your project using the following command

reco build <cordova platform>

or

npm run build <cordova platform>

*Node: <cordova platform> is not requred.

Builds cordova-app for browser, mobile and other platforms.

Note: will generate an apk installable package for Android devices
Note: will generate an xcworkspace XCode project that can be compiled and built for deployment on iOS devices

Integrated Cordova CLI

To run Cordova CLI simply prepend the reco prefix to any Cordova command line

For example:

reco cordova <any cordova command line to run>

reco platform

reco platform <add/rm> <cordova platform>

reco plugin <add/rm> <cordova plugin>

Learn more about Cordova: Cordova get started.

Integrated React.js CLI

You can run React.js CLI from within the project's directory

For example:

reco start (Choose the first option)

reco test

reco install <npm packages for react>

reco uninstall <npm packages for react>

reco react <any react command line to run>

react <any react command line to run>

Learn more about React.js apps: create React.js app documentation
Learn programming in React.js: React.js documentation

---

Prerequisites

npm

get-npm

Java

Recommended version 1.8.0 get-Java

Cordova

npm install -g cordova

If you have any problems, please let us know here, and we will make our best effort to resolve it soon

Feel free to edit the code yourself: go to bin/cli.js

Created by Or Chuban (Choban)

Credits: Arik Wald