This project is dedicated to providing the best possible mobile app for the HERO System family of games. Since 2018, this application has been freely offered on the Android Play Store, Apple App Store, and Amazon Appstore. Not only is the app free - it is also ad free, respects user privacy, and it will remain that way.
Up until 2020 this project has been a private project which was a single developer's (me!) labour of love. I am opening up the project to anyone who is interested in helping out in the hope that we can make the app bettter from a technical, feature, and user satisfaction level. Now, if you have an idea for a killer feature to add to the app, you can grab the code, build your feature, and submit a PR. If you don't have the technical ability, feel free to open a ticket and file your idea with the project.
This project was bootstrapped with Create React Native App.
- Screenshots
- Updating to New Releases
- Available Scripts
- Writing and Running Tests
- Troubleshooting
- Donating
Here are some screenshots of the current app as of 2020-01-11 (click to enlarge).
 |
 |
 |
 |
 |
 |
You should only need to update the global installation of create-react-native-app very rarely, ideally never.
Updating the react-native-scripts dependency of your app should be as simple as bumping the version number in package.json and reinstalling your project's dependencies.
Upgrading to a new version of React Native is something that should be done sparingly and only with the assistance of 3rd party tools such as RN diff PURGE.
Below is a list of available commands.
Runs your app in development mode.
Sometimes you may need to reset or clear the React Native packager's cache. To do so, you can pass the --reset-cache flag to the start script:
npm start -- --reset-cache
Runs the jest test runner on your tests.
Like npm start, but also attempts to open your app in the iOS Simulator if you're on a Mac and have it installed.
Like npm start, but also attempts to open your app on a connected Android device or emulator. Requires an installation of Android build tools (see React Native docs for detailed setup). We also recommend installing Genymotion as your Android emulator. Once you've finished setting up the native build environment, there are two options for making the right copy of adb available to Create React Native App:
- Make sure that you can run adb from your terminal.
- Open Genymotion and navigate to
Settings -> ADB. Select “Use custom Android SDK tools” and update with your Android SDK directory.
- Find Genymotion’s copy of adb. On macOS for example, this is normally
/Applications/Genymotion.app/Contents/MacOS/tools/. - Add the Genymotion tools directory to your path (instructions for Mac, Linux, and Windows).
- Make sure that you can run adb from your terminal.
This project is set up to use jest for tests. You can configure whatever testing strategy you like, but jest works out of the box. Create test files in directories called __tests__ or with the .test extension to have the files loaded by jest. See the the template project for an example test. The jest documentation is also a wonderful resource, as is the React Native testing tutorial.
Occasionally you will run into build issues that will baffle and confuse you such as a build working one day and not the next. This is usually a caching issue and can be fixed by flushing the various caches in your development environment.
Very often you can simply do the old trick of removing your node modules and rebuilding.
rm -rf node_modules/
npm install
After re-installing your node_modules don't forget to rebuild your app in XCode or by running npm run android if you're building the android app.
From time to time you will have to go down the dark path of forcing all of your caches to refresh. This is deailed below.
Execute the following commands to flush the general caches. It's recommended that you complete quit XCode if you are working on a Mac before you do any of this.
# from within your project root
rm -rf node_modules
rm -rf $TMPDIR/react-*
rm -rf $TMPDIR/metro-*
watchman watch-del-all
rm -rf node_modules
npm cache clean --force
npm cache verify
If you are building the Android app
rm -rf android/build
If you are building in iOS
rm -rf ios/build
rm -rf ios/pods
rm -rf ios/Podfile.lock
Once all your various caches have been flushed you can begin to rebuild.
npm install
For iOS you will need to rebuild your CocoaPods
cd ios/
pod deintegrate
pod install
If you feel like donating to the project for whatever reason you can do so by clicking here... street Cyberline doesn't buy itself!