Skip to content


Switch branches/tags


Failed to load latest commit information.
Latest commit message
Commit time
Jul 4, 2018
Mar 20, 2019

🌈️ Rainbow

the Ethereum wallet that lives in your pocket!

📲️ Available on the iOS App Store.

🤖 Android Beta available on Google Play Store

🐦️ Follow us on Twitter




  1. Install the latest version of XCode.

  2. Install Watchman:

    brew install watchman
  3. Install CocoaPods:

    sudo gem install cocoapods
  4. Install the required bundles and Pods for this project:

    yarn install-bundle && yarn install-pods


  1. Install system dependencies:

    sudo apt install libsecret-tools watchman
  2. Follow the React Native environment setup instructions carefully, which will involve installing Android Studio, the Android SDK, the emulator, etc. and making them available in your $PATH.

  3. Ensure at least one AVD image is available for the emulator (unless using a physical device).


If you are new to React Native, this is a helpful introduction:


  1. Run nvm use 14 to force Node.js v14.

  2. Set up your .env file, use our env.example as a guide.

    Note that some features are currently not accessible, we are working with our Data Providers in order to provide open source API Keys!

    Here are some resources to generate your own API keys:

  3. Ensure a google-services.json has been added to the relevant project directory/directories so the compile will not fail.

    This can either be the live Google Services config (for internal development) or a self-provided config for a personal Firebase project (third-party contributors) registered under the package name me.rainbow.


Note: Darwin versions of the application can only be developed/built on Darwin platforms with XCode.

  1. Start a React Native webserver with:

    yarn start
  2. Open rainbow-wallet/ios/Rainbow.xcworkspace in XCode.

  3. Run the project by clicking the play button.


Note: Linux development environments cannot develop or build Darwin versions of the project.

  1. Start a React Native webserver with:

    yarn start
  2. Build/install/start the debug version of the app in an emulator with:

    yarn android