Pride in London mobile app
Clone or download
markholland Merge pull request #621 from redbadger/bump-fastlane
Upgrades to latest version of Fastlane
Latest commit 123e2fb Dec 13, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci disables e2e while not working Nov 19, 2018
.github Merge branch 'master' into date-filter-ui-design Apr 14, 2018
android updates to latest fastlane Dec 13, 2018
assets Merge branch 'master' into native-splash-screens Jun 30, 2018
doc/adr add ADR for luxon May 18, 2018
e2e migrates to detox v8 Jun 29, 2018
flow-typed/npm add flow types for reselect; Jun 7, 2018
images Add browserstack logo Apr 4, 2018
ios updates to latest fastlane Dec 13, 2018
scripts remove space Jun 6, 2018
src Revert "Optimize Contentful image loading" Nov 19, 2018
.adr-dir Introducing ADRs Feb 3, 2018
.babelrc Fresh setup without expo Jan 20, 2018
.buckconfig Fresh setup without expo Jan 20, 2018
.codeclimate.yml We Enjoy Typing Jun 2, 2018
.editorconfig Add .editorconfig Apr 28, 2018
.env.example Set bugsnag release stage from env May 9, 2018
.eslintignore add stack navigator Feb 12, 2018
.eslintrc migrates to detox v8 Jun 29, 2018
.flowconfig Ignore platform folders in flow config May 14, 2018
.gitattributes Fresh setup without expo Jan 20, 2018
.gitignore migrates to detox v8 Jun 29, 2018
.node-version add node-version Feb 11, 2018
.watchmanconfig Fresh setup without expo Jan 20, 2018
BrewFile aggressive caching in iOS builds Apr 22, 2018
CONTRIBUTING.md Add accessibility tips to CONTRIBUTING.md Apr 14, 2018
LICENSE Add licence file Feb 24, 2018
README.md add missing colon Jun 20, 2018
app.json Connect time picker to redux store Mar 17, 2018
index.js add basic redux implementation Feb 24, 2018
package.json upgrade react-native-safe-area-view Nov 19, 2018
yarn.lock upgrade react-native-safe-area-view Nov 19, 2018

README.md

Pride in London App

CircleCI Maintainability Test Coverage

iOS: https://itunes.apple.com/gb/app/pride-in-london/id1250496471

Android: https://play.google.com/store/apps/details?id=org.prideinlondon.festival

Installation and setup

Prerequisites

More information on getting started can be found here: https://facebook.github.io/react-native/docs/getting-started.html under the Building projects with React Native tab.

General

Clone the repository

$ git clone git@github.com:redbadger/pride-london-app.git

And install dependencies

$ yarn

iOS

  • Install Xcode from the App Store and accept the license agreement.
  • Run Xcode once so that it can install additional components it will need.

To develop on a real device locally you will need to install the development provisioning profile from fastlane.

Install fastlane using

[sudo] gem install fastlane -NV

or alternatively using brew cask install fastlane

You can then run the following command from the ios folder:

fastlane match development --readonly

You will need access to the private match-ios-certificates repo and will be prompted for the passphrase. Ask on the channel to get this sent to you in a secure way ;) On success you should be presented with the installed certificates and provisioning profile for org.prideinlondon.festival.

Next, open Xcode and the PrideLondonApp.xcodeproj. Plug in your device via USB, and select it in the device dropdown in the top left of Xcode. Then hit the build (Play) button.

Android

  • Install Android Studio.
  • Install the Android SDK and necessary components.
    • Open Android Studio. If this is the first time you open it, it will prompt you to install the Android SDK. You can proceed with the default settings.
    • Select "Open an existing Android Studio project" and select the ./android folder in this repository. This will help you to get the necessary dependencies installed.
    • Android Studio will automatically try to build the project. You will see the Gradle process running.
    • When dependencies are missing (e.g. SDK Platform or build tools), it will error and show a link to install them (e.g. "Install Build Tool xx.x.x and sync project"). Click on the link (in the Gradle Sync tab) to resolve. Repeat this until you get a BUILD SUCCESSFUL message.
    • It will also automatically create the file ./android/local.properties with a entry sdk.dir=<path to your android sdk>, which is required for the build to work. You will need this in the next step
  • Create and start an emulator (aka AVD (Android Virtual Device)).
    • Open Android Studio and click on the AVD Manager icon (4th from the far right) in the toolbar (this will appear when the project compiled correctly).
    • Choose any device you want.
    • Select a system image. Choose a recommended one (e.g. API 27). Click on the download link next to the image name. It will automatically start downloading.
    • Click next through to finish.
    • Start your AVD by clicking the green play button under actions.
  • Add <path to your android sdk>/platform-tools (find it in ./android/local.properties) to your PATH. This is required because React Native will run adb to install the app on your emulator/device. e.g. add
    export PATH="<path-to-sdk>/platform-tools:$PATH"
    
    to your .bashrc/.zshrc
  • Make sure you have Java 8 installed (Java 9 won't work). If you wany, you can point JAVA_HOME to the embedded JDK from Android Studio to make sure you have a JDK version, which works with Android.

Environment Variables

In order to run the application locally you will need to find and add some environment variables to the project. These can be found in .env.example. Copy this file into another file called .env:

cp .env.example .env

And fill in the required variables from the appropriate developer portals (e.g. app.contentful.com/spaces/<space-id>/api/keys) - use the Delivery API key.

Running

iOS

  • yarn run-ios [--simulator="iPhone X"]

Android

  • yarn run-android

Debugging

The recommended tool for debugging is React Native Debugger which has built in support for Redux Devtools.

To install React Native Debugger:

brew update && brew cask install react-native-debugger

Then to debug:

  1. Close any other debugger windows you have open
  2. Open the App from your Applications folder
  3. Start debugging in the app using one of the following methods:
Platform Command
iOS Press Cmd+R to reload, Cmd+D or shake for dev.
Android Double tap R on your keyboard to reload, shake or press menu button for dev menu.

Generating test data

Note: You do not need to do this if you are just getting your environment set up. This is for filling the remote CMS with mock data for testing purposes.

In order to fill the test CMS space with test data you can use our generate-content script. It goes without saying make sure you are doing this on a test CMS rather than production.

To generate test data:

node ./scripts/generate-content.js generate -s <space_id> -a <access_token>

To specify a specific number of items to generate just pass a number as the first argument:

node ./scripts/generate-content.js generate -s <space_id> -a <access_token> 5

To delete the generated data again:

node ./scripts/generate-content.js delete -s <space_id> -a <access_token>

For both commands you can skup the -s and -a flags by setting the environment variables CONTENTFUL_SPACE_ID and CONTENTFUL_MANAGEMENT_KEY respectively. E.g.

export CONTENTFUL_SPACE_ID=<space_id>
export CONTENTFUL_MANAGEMENT_KEY=<access_token>
node ./scripts/generate-content.js generate 5

Tests

E2E

End to end tests use Detox with Jest as the test runner. Some setup is required for running the tests locally.

Contributing

Pieces of work currently up for grabs will be listed on the issues page and tracked on the projects page. If you are able to work on the piece of work, comment on the issue. You can also discuss the feature in the isssue page. Be honest about if you have the time to work on it, there's no shame in parking a piece of work and letting someone else pick it up if you're too busy.

Follow the contribution guidelines to have a smooth experience getting your changes in.

Architecture Decision Records

We will keep a collection of records for "architecturally significant" decisions: those that affect the structure, non-functional characteristics, dependencies, interfaces, or construction techniques.

When making such changes please include a new ADR in your PR.

To find out more about ADRs have a read of this article: http://thinkrelevance.com/blog/2011/11/15/documenting-architecture-decisions

Links

  • CI Pipeline: View and debug builds

  • We would like to thank BrowserStack for allowing us to use their resources to test the Pride in London App for free! BrowserStack Logo

  • We would like to thank Bugsnag for allowing us to use their tool to monitor the Pride in London App for free