Trash Walk is a mobile (iOS) app aimed at helping us make the world a cleaner place! The app is a tool for people cleaning (doing "trash walks"), and uses their phones GPS to save their walks to a shared database. This brings two main benefits:
- It documents the efforts made, for the ones volunteering their time (and everyone else!).
- Make the activitity more gratifying to the trash walkers themselves by "gamification" and social functions.
Except for the regular suspects; git, Node, npm, you need these things to work on the Trash Walk app. Follow the instructions supplied below them or on their links to get them up and running before you continue with Installation.
- Xcode (latest version, at least >9.3). Install from App Store.
- Cocoapods - a dependency manager for Swift and Objective-C Cocoa projects.
sudo gem install cocoapods - Expo XDE - the Expo development environment.
npm install -g exp
Recommended!
- The Trash Walk backend is highly recommended as well, if you want any sort of useful interaction with the app.
- React Native Debugger - a debugger built on the Chrome debugger, including React and Redux Dev Tools.
-
Clone this repo and enter!
git clone https://github.com/cherlin/trash-walk-frontend.git cd trash-walk-frontend -
Install dependencies.
npm install cd ios # ! Change into the ios folder ! pod install
-
While in the ios folder, run
exp startto start the Expo development environment that will build the JS bundle for your app. -
Run the trash-walk.xcworkspace file in Xcode (NOT the trash-walk.xcodeproj).
-
Set up an Identity for the app under General in Xcode. You will need to pick a bundle name that will be unique to the particular certificate that you then have to generate under Signing
-
Build the app! (click the Play-button in the top left corner when you have picked your target in the drop-down to the right of it.)
- React Native (ejected from Expo)
- Redux
- Other dependencies: