Run edge-react-gui locally

gistfile1.txt

This is a guide to help get your edge-react-gui react-native app running locally

INSTALLING
Requirements(Just posting the current ones I am using)
- XCode v9.2
- XCode build tools 9.2 
    - `xcodebuild -version` 
- *Important* - your npm install will hang unless you have a specific version installed 
    - https://github.com/Airbitz/edge-react-gui/issues/271
    - install nvm(node version manager)
        - 'curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.8/install.sh | bash'
    - make sure that the init is added to your bash profile(mine is .bash_profile)
    - restart terminal or source bash profile to apply changes
    - *INSTALL SPECIFIC VERSION* 
        - 'nvm install 8.9.3'    
- Clone our edge-react-gui fork 
    - 'git clone -b decred https://github.com/cipherzzz/edge-react-gui.git' 
    - rename env.example.json to env.json and change value for AIRBITZ_API_KEY key to 28a63ca516f72ea7f05e37fc4d4b26bee90afb4e
    - If you want your own api key it's a bit of a hassle but you do this
        - Download the airbitz wallet to your phone, create an account, scan the qr code located here - https://developer.airbitz.co 
        - verify your email and you should see your API Key
- Install dependencies for edge-react-gui -   
    - 'cd edge-react-gui' 
    - 'npm install --verbose'        
- Clone our edge-currency-bitcoin fork 
    - 'cd ..' 
    - 'git clone -b decred https://github.com/cipherzzz/edge-currency-bitcoin.git'
- Install Yarn v1.3.2 
    - 'npm install --global yarn@1.3.2'
- Install edge-currency-bitcoin dependencies 
    - 'yarn'
- Migrate edge-currency-bitcoin dependencies to edge-react-gui
    - 'cd ../edge-react-gui'
    - 'npm run updot edge-currency-bitcoin'
    - 'npm run postinstall'
     *This will copy the necessary files from edge-currency-bitcoin into the edge-react-gui/node_modules/edge-currency-bitcoin 
     replacing the npm installed version. 
- React-Native CLI 
    - install by running 'npm install -g react-native-cli'
- Install Android NDK(Optional - only if you want to run an android build)
    - Download the Android NDK for your system - https://developer.android.com/ndk/downloads/index.html
    - Unzip to an appropriate directory(Mine is /Users/macuser/Library/Android/android-ndk-r10e)
    - Set your ANDROID_NDK_HOME 
        - export ANDROID_NDK_HOME=<unzipped ndk path>
- Run the Edge App
    - iOS
        - 'react-native run-ios'
    - Android
        - Install Android emulator like Genymotion or through Android Studio
        - Start up your simulator
        - 'react-native run-android'
 - Login
    - User: 'cipherZ'
    - Password: 'D3credrocks'
    - OR use the account that you created your API key with
    
 - Troubleshooting
    - If you get a white screen, it may be a good idea to debug the app 
        - Apple-D will bring up a menu where you can select 'Start Remote JS Debugging'
        - Apple-R will reload the app when you make changes to the app itself but not to the currency plugin
        
DEVELOPING
 - edge-currency-bitcoin
    - To work on the plugin we can work in the edge-currency-bitcoin directory level with the edge-react-gui project. 
      To test your plugin changes locally
       - 'cd ../edge-react-gui'
        - 'npm run updot edge-currency-bitcoin'
        - 'npm run postinstall'
        *This will copy the necessary files from edge-currency-bitcoin into the edge-react-gui/node_modules/edge-currency-bitcoin 
        replacing the npm installed version. '
 - edge-react-gui
    - We shouldn't need to do much if any changes to the Edge app, but you can reload your changes
        - Apple-R