Starter kit for universal full–fledged React apps. One stack for browser, mobile, server.

Originally based on Este.js

Prerequisites

• node.js Node 6+, install via nvm highly recommended
• gulp yarn global add gulp
• yarn
• react-native-cli yarn global add react-native-cli

Start Development

• install dependencies yarn

Web app

• run gulp
• point your browser to localhost:3000

iOS app

• run gulp ios

Android app

• run gulp android

Dev Tasks

• gulp eslint --fix fix fixable eslint issues
• gulp messages-export export messages for translators (with MISSING prefix when untranslated)
• gulp messages-check check missing and unused translations
• gulp clean-ios/gulp clean-android clean ios/android build
• yarn run build-size-check display info about latest build
• yarn run devtools start standalone React devtools for native apps
• rm -fr $TMPDIR/react-* reset native packager cache
• watchman watch-del-all clear watchman watches

E2E Tasks

• gulp test-e2e [-p] -d [ios|android|browser|i|a|b] [-s ${folderName}] start E2E tests for selected platform, possibly in production mode
• android avd & open AVD manager to start Android simulator

More info in separate document E2E-TESTING.md

Next.js

Look at Next.js github, not just the old blogpost.

Next.js give us:

• server side rendering with automatic code splitting
• prefetching pages
• nice documentation and many examples

Almost everything in Next.js is configurable, but the folders structure not yet. So the pages folder is temporally in src, although it should goes inside browser folder. The pages folder will be moved as soon as this PR #936 will be merged in Next.js.

Storybook

• yarn run storybook-web run Storybook for Web

• point your browser to localhost:9001

• yarn run storybook-native run Storybook for native

• We can show react-native components in browser due to the library react-native-web

• point your browser to localhost:9002

• create stories alongside components (eg. Button.stories.js for Button.js)

• Storybook watches /src/browser directory for web app and /src/native for native app, and rebuilds itself as you touch any *.stories.js

Production Tasks

• gulp build build app for production
• gulp start run app in production mode
• npm test run all checks and tests

Updates from devstack to your project

• create branch in your project's repo (e.g. devstack-update) and push it
• add devstack as remote to your project (git remote add devstack https://github.com/actum/devstack.git)
• fetch remote (git fetch devstack)
• merge branch from devstack remote to devstack-update (use --allow-unrelated-histories if necessary)
• merge your project's master to devstack-update
• solve eventual conflicts
• create PR from devstack-update to your master