Skip to content

micahlt/itchy-native

Repository files navigation

Itchy Native

Itchy Native is an experimental multiplatform rewrite of the Itchy Ionic app, built with React Native + Expo.

Installation

We're not currently publishing public APK or IPA files, but you're welcome to build your own from this codebase or join the beta on the Google Play Store.

Development

Android

  1. Clone the repository and run npm install.
  2. Set up your environment according to the Expo Android docs.
  3. In the android directory, create a new file called key.properties. Inside of it, place information about your signing keystore in this format:
storePassword=[keystore password]
keyPassword=[key password]
keyAlias=[key alias]
storeFile=[path to your keystore]
  1. Prebuild the project with npx expo prebuild.
  2. Run npm run android to run the on an emulator or device.

iOS

  1. Clone the repository and run npm install.
  2. Set up your environment according to the Expo iOS docs.
  3. Install Ruby version 2.7.2 according to the Ruby docs if it's not already on your Mac.
  4. Install Cocoapods with sudo gem install cocoapods and resolve any errors that may occur.
  5. Prebuild the project with npx expo prebuild.
  6. Run npx expo run:ios to run the on the XCode simulator or your device.

Building

Android

  1. Go into the android directory with cd android.
  2. Run ./gradlew assembleRelease for an APK output or ./gradlew bundleRelease for an Android App Bundle output.

iOS

There aren't any iOS build instructions yet since the app hasn't been signed and is not on the App Store.