qreoct / runstarter

🏃‍♂️🏆 Turn your Miles into Smiles 🏆🏃‍♀️

RunSquad

🏃‍♂️🏆 Turn your Miles into Smiles 🏆🏃‍♀️

Run Squad is not just another running app; it's a dynamic and innovative platform designed to inspire, motivate, and connect runners of all levels to help them achieve their fitness goals. Whether you're a seasoned marathoner or a complete beginner, Run Squad is your virtual running companion that brings a whole new dimension to your fitness journey.

Team

Run Squad is built by the following developers from NUS School of Computing for CS3216.

Dexter (dexterleng)

Kleon (kleonang)

Jefferson (qreoct)

Joong (joongeo)

---

🔗 Development

This Project is based on Obytes starter

Requirements

• React Native dev environment
• Node.js LTS release
• Git
• Watchman, required only for macOS or Linux users
• Pnpm
• Expo Cli
• VS Code Editor ⚠️ Make sure to install all recommended extension from .vscode/extensions.json

👋 Quick start

Clone the repo to your machine and install deps :

git clone https://github.com/qreoct/runstarter

cd ./runstarter

pnpm install

Env setup (.env.development, .env.staging, .env.production respectively)

EAS_PROJECT_ID=
REACT_APP_IOS_CLIENT_ID=
REACT_APP_ANDROID_CLIENT_ID=

REACT_APP_FIREBASE_API_KEY=
REACT_APP_FIREBASE_AUTH_DOMAIN=
REACT_APP_FIREBASE_PROJECT_ID=
REACT_APP_FIREBASE_STORAGE_BUCKET=
REACT_APP_FIREBASE_MESSAGING_SENDER_ID=
REACT_APP_FIREBASE_APP_ID=
REACT_APP_FIREBASE_MEASUREMENT_ID=

To run the app on ios

pnpm ios

To run the app on Android

pnpm android

✍️ Documentation

• Project structure