Mumbai at 5:30 AM is a different city — quiet, peaceful, almost unreal.
There were days I didn't step outside at all. No sunlight, no random conversations, no reason to leave the house. Just me and my laptop. And the worst part? It didn't even feel wrong anymore.
So I made a rule: every Sunday = one run at a completely new place.
Not near my house. Not the gym. Not the same boring route.
For 2–3 weeks it was amazing. Then I hit a problem — I ran out of places. Because beyond the "famous spots", you don't really know where to go in Mumbai.
So instead of overthinking it, I built something. A small app in 30 minutes. That tiny thing changed everything.
Now I wake up at 5 AM excited. I take routes I've never seen before. I explore a city I thought I already knew.
| Feature | Description |
|---|---|
| 🤖 AI Spot Finder | Answers 4 quick questions about your vibe, distance & time — Gemini suggests the perfect spot |
| 🌤️ Live Weather | Uses real weekend weather via Open-Meteo so you're never caught off guard |
| 🚌 Transit Directions | Exact step-by-step public transport directions to get there |
| 📓 Run Journal | Logs every run — distance, rating, location, date |
| 📊 Stats Tracker | Tracks total KMs, average rating, and your personal best |
| Home | Discover | History |
 |
 |
 |
| Layer | Technology |
|---|---|
| Mobile App | React Native (Expo) |
| Database | Supabase |
| AI Suggestions | Gemini 2.5 Flash |
| Maps & Directions | Google Maps + Directions API |
| Weather | Open-Meteo (free, no key needed) |
# 1. Clone the repo
git clone https://github.com/SnehaDeshmukh28/RunSpot.git
cd RunSpot
# 2. Install dependencies
npm install
# 3. Set up environment variables
cp .env.example .env
# Fill in your API keys (see below)
# 4. Start the app
npx expo start
# 5. Scan the QR code with Expo Go on Android| Service | Where to get it |
|---|---|
| Supabase URL + Anon Key | supabase.com |
| Google Maps API Key | console.cloud.google.com — enable Maps SDK, Places & Directions |
| Gemini API Key | aistudio.google.com |
RunSpot/
├── src/
│ └── screens/ # Home, Discover, History screens
├── assets/ # App icons and images
├── screenshots/ # README screenshots
├── App.js # Entry point
├── .env.example # Environment variable template
└── package.json
PRs are welcome! If you want to add a new running spot, fix a bug, or extend support to another city — go for it.
- Fork the repo
- Create your branch (
git checkout -b feature/add-delhi-spots) - Commit your changes (
git commit -m 'Add Delhi running spots') - Push to the branch (
git push origin feature/add-delhi-spots) - Open a Pull Request
If this made you want to go for a run — drop a ⭐ on the repo. It genuinely helps more people find it.
Built with 🏃 and 5 AM energy by Sneha Deshmukh · Mumbai, India