Instantly run a React application on your local device.

🤖 - Automated setup (runs all the boring commands for you)

✨ - Less useless dirt on your drive (saves the project temporarily)

👶 - Super easy to use (even your grandma will get it)

npm install -g react-instant

yarn global add react-instant

npx react-instant ...

Setup a preview of a selected React application. react-instant <GIT_URL>

eg. react-instant https://github.com/DRFR0ST/karutek.git

after the setup you can preview the project in your browser under http://127.0.0.1:5000/

Override default port.

react-instant https://github.com/DRFR0ST/karutek.git -p 5050

Displays the current version.

react-instant -v

Save the project permanenty in a local directory.

react-instant Misieq01/notemaster -s ./notemaster/

Switches branch after clone.

react-instant Misieq01/notemaster -b=dev

Verbose log output.

react-instant --verbose

Skip the testing step.

react-instant DRFR0ST/sourcer --excludeTest

Script name executed on build.

react-instant DRFR0ST/sourcer --buildScript compose

Path to an .env file, that should be copied into the project.

react-instant DRFR0ST/circles-web --envPath /some/cool/path/.myEnvFile

Mainly used for testing. It skips the serving process and exits after build. Is not useful unless used with --save flag.

react-instant DRFR0ST/physiomedica-website --omitServe

Forces clean-up when exiting.

react-instant DRFR0ST/physiomedica-website --forceClean

The programs listed below are required to run this app correctly.

• git
• yarn
• serve

• If you want to preview a github repository project, use a shorthand by providing only a github and repo name. eg. react-instant Misieq01/notemaster

• The provided project's package.json has to contain a build command (like the one generated by create-react-app). You can change the script name by using buildScript flag.
• When using envPath flag, make sure to name your selected file .env, otherwise it will not be copied correctly. (See #10)

Thanks to all contributors for making this a better tool and spreading the love to all your lazy (as me) friends!

@xomod