Technologies

• Node v8.9.4
• Express
• React
  • via create-react-app
• react-app-rewired
• React Native
  • via create-react-native-app
• React Native Web
• React Router
• React Router Native
• Storybook
• NativeBase
  • NativeBase Kitchen Sink (src)
• Sequelize w/ Postgres
• Redux
  • connected-react-router
  • react-native-redux-router
• Passport
  • passport-facebook-token
• Expo

Environment

Mac

1. Install Homebrew: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
2. Install: brew install postgresql@9.6
3. Start Postgres: brew services start postgresql@9.6
4. Add line to your ~/.bash_profile: echo 'export PATH="/usr/local/opt/postgresql@9.6/bin:$PATH"' >> ~/.bash_profile
5. Create default database: createdb
6. Install pg Admin 4: brew cask install pgadmin4
7. Install ngrok: brew csk install ngrok
8. Install React Native Debugger: brew cask install react-native-debugger

Windows

1. Install Chocolately
   1. Open PowerShell as administrator by right clicking icon
   2. run Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
2. Install postgresql: choco install postgresql -y
3. Install pg Admin 4 : choco install pgadmin4 -y
4. Install ngrok: choco install ngrok -y
5. Install React Native Debugger
6. Create default database: createdb
7. TODO: Android Instructions.

Setup

1. install dependencies: yarn install
2. create local env file: cp .env.example .env
3. create database yarn sequelize db:create
4. run migrations yarn sequelize db:migrate
5. seed database yarn sequelize db:seed:all
6. Ask for Facebook API keys for .env

Development

Web

1. yarn dev
   • it'll give some warning about an untrusted certificate, just click advanced and proceed
2. serve web storybook: yarn storybook

Native IOS

Running the App

1. yarn api in one terminal window
2. ngrok http 8080 in another terminal window
3. 🔥 Fill in https ngrok url for API_SERVER in .env 🔥
4. yarn native-start in another terminal window
5. Open native app on ios simulator: yarn ios
   • Or Send to your iPhone npx expo-cli send -s <your-phone-number-or-email>

• Note: Do not use the "Open in iOS Simulator" button in the Expo Debugger popup.

Running Storybook Native

1. 🔥 Fill in STORYBOOK=true in .env 🔥
2. Serve native storybook: yarn native-storybook
3. Open native app on ios simulator: yarn ios
   • Or Send to your iPhone npx expo-cli send -s <your-phone-number-or-email>