README.md

strava-box

Update a gist to contain your YTD Strava distances

---

Previous Work

This repo is based off of matchai's waka-box.

Setup

Prep work

1. Create a new public GitHub Gist (https://gist.github.com/)
2. Create a GitHub token with the gist scope and copy it. (https://github.com/settings/tokens/new)
3. Create a Strava Application (https://www.strava.com/settings/api)
   • Copy the Client ID and Client Secret.
4. Get your Athlete Token by going to https://www.strava.com, click your profile photo in the top right corner. Copy the ID in the url. https://www.strava.com/athletes/12345

Project setup

1. Fork this repo
2. Get the refresh token:
   1. Clone this repo locally
   2. Make a copy of sample.env called .env, and add all the tokens/IDs requested (see environment variables section below), excluding the refresh token.
   3. Run npm install to install the necessary dependencies to run the project.
   4. Run ./strava-api.js, open the link provided, and click to authorize the app.
   5. The refresh token will be printed to your terminal.
3. Open the repository settings in GitHub, and open the page Security › Secrets and Variables › Actions.
4. Add the following repository secrets:

Environment variables

When completing a DOTENV file, do not include any spaces or quotes around the codes. E.g. STRAVA_CLIENT_ID=12345

• GIST_ID: The ID portion from your gist url https://gist.github.com/<github username>/6d5f84419863089a167387da62dd7081.
• GIST_TOKEN: The GitHub token generated above.
• STRAVA_ATHLETE_ID: The ID you got from visiting your profile page.
• STRAVA_CLIENT_ID: The client ID you got from the Strava API page.
• STRAVA_CLIENT_SECRET: The client secret you got from the Strava API page.
• STRAVA_REFRESH_TOKEN: The token from Project Setup, step 2.
• (optional) UNITS: miles, km, metres or meters