Project Strava Hack Run 🚴‍♂️🏃‍♂️

Effortless GPX Uploads to Strava with Project SHR

If you've ever wanted to add a GPX file to Strava without the hassle, Project SHR is here to make it effortless. This simple web app allows you to upload GPX files to Strava with a single click, track the upload status, and enjoy the freedom of "running" kilometers without ever leaving your desk.

🚀 What is Project SHR?

Project SHR is a lightweight web application designed to streamline the process of uploading GPX files to Strava. Whether you want to add past activities, experiment with route simulations, or simply automate your uploads, this tool makes it incredibly easy.

🔥 Key Features

✅ Upload GPX files directly to Strava – No need to manually import files; just select and upload. ✅ Track upload status – Know when your activity is processed and ready on Strava. ✅ Run kilometers without moving at all – Perfect for testing and simulations.

💡 How to Use

Select a .gpx file from your device.
Click "Upload GPX to Strava" to send the activity.
Click "Check Upload Status" to confirm if your activity is ready.
Open Strava and check your activity history.

🛠️ Setup & Installation

Setting up Project SHR is straightforward:

1️⃣ Clone the repository:

git clone https://github.com/luisbeqja/project_shr.git
cd project_shr

2️⃣ Install dependencies:

npm install

3️⃣ Configure Strava API credentials:

Create a .env file and add the following:

VITE_STRAVA_CLIENT_ID=your_client_id
VITE_STRAVA_CLIENT_SECRET=your_client_secret
VITE_STRAVA_REDIRECT_URI=your_redirect_uri
VITE_STRAVA_ACCESS_TOKEN=your_access_token
VITE_STRAVA_REFRESH_TOKEN=your_refresh_token

4️⃣ Run the project locally:

npm run dev

Visit: http://localhost:5173 in your browser.

🛠️ Technologies Used

TypeScript – Ensuring type safety and scalability.
Strava API – Seamless integration with Strava.
Alpine.js – Lightweight JavaScript framework for a smooth UI experience.

🎉 Get Started Today!

Project SHR simplifies GPX uploads, making it easier than ever to add activities to Strava. Whether you're testing routes, simulating workouts, or just looking for a quick way to upload GPX files, this tool has you covered.

🚴‍♂️ Ready to try it out? Clone the repo and start uploading today!