Shoreline Access for Everyone
Welcome to the Street Ends mobile app Github. The Steet Ends app aims to offer you an easy and convenient resource for finding respite in the public parks that dot Seattle's waterfront, and discover the story behind the people and communities who make it all possible. This app is a work-in-progress, built using React Native for cross platform support, made by Loan Pham, David Prismantas, Alex Sutherland, Jennifer Villacis, and Andy Wilson.
For the official and most in-depth deployment instructions, reference the official React Native docs at https://reactnative.dev/docs/environment-setup
. If you'd like to get up and running quickly, see below if you're on a Mac.
To properly set up your local machine for React Native development, you will need the following:
- Brew Package Manager
- Node
- Watchman
- Appropriate JDK
- Android Studio
To start, paste and run the following command into a terminal window to install Brew:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
Next, install Node (if you don't have it), Watchman, and the required JDK (if you don't have it) via Brew using the following commands:
brew install node
brew install watchman
brew cask install adoptopenjdk/openjdk/adoptopenjdk8
Next, install Android Studio, and make sure the following items are checked during installation:
- Android SDK
- Android SDK Platform
- Android Virtual Device
- Performance (Intel ® HAXM)
Configure the Android SDK in Android Studio by opening up Preferences
and then under Appearance & Behavior
> System Settings
> Android SDK
, select the SDK Platforms
tab, check the Show Package Details
box in the bottom right corner, expand the Android 10 (Q)
section, and make sure the following options are checked:
- Android SDK Platform 29
- Intel x86 Atom_64 System Image
- Google APIs Intel x86 Atom System Image
Next, select the SDK Tools
tab, check the Show Package Details
box, expand the Android SDK Build-Tools
option, then ensure that 29.0.2 is selected.
Click Apply
to install the Android SDK and tools.
Open up a terminal in your home directory, and run the following command to create a new text file:
nano .zprofile
Next, paste in the following lines:
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/tools/bin
export PATH=$PATH:$ANDROID_HOME/platform-tools
Hit ctrl+s to save the file, and your dev environment should now be ready!
Start by cloning the repo to your local machine using your preferred method. Then:
- Open a new terminal window at your project root directory.
- Run the following command to install the needed dependencies:
npm install
- Run the following command to start the JavaScript bundler Metro, and leave it running in the terminal window:
npx react-native start
- In a new terminal window, run the following command to launch your app in an emulator:
npx react-native run-android
And voila, you should be seeing our app running on your emulator shortly!