@epdoc/strava - Monorepo

This is a Deno workspace containing the Strava CLI application and its supporting packages.

Workspaces

packages/strava-api

Strava API client library providing:

• OAuth2 authentication flow
• Type-safe API endpoints
• Schema definitions for Strava data structures
• Token management and refresh logic

packages/strava

CLI application built on @epdoc/cliapp providing:

• athlete - Display athlete information and bike list
• kml - Generate KML files for Google Earth with activity routes
• pdf - Create Acroforms XML files for PDF forms
• segments - Analyze starred segments with effort times

Installation

cd ~/mydevfolder
mkdir epdoc
cd epdoc
git clone https://github.com/epdoc/strava.git

Quick Start

# Run from workspace root
deno run -A ./packages/strava/main.ts --help

# Or use the athlete command
deno run -A ./packages/strava/main.ts athlete

See the strava README for more information.

Configuration

The CLI uses configuration files in ~/.strava/:

• credentials.json - OAuth tokens from Strava (StravaCredsData)
• user.settings.json - User preferences and customization (UserSettings)
• segments.json - Cached segment data (CacheFile)
• clientapp.secrets.json - Strava app client ID and secret (ClientConfig)

Development

This project was converted from a legacy Nodejs application. See github.com/jpravetz/epdoc-strava for the original Node.js implementation documentation.