sports-lib

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 174 Open GitHub ↗

A Library for processing GPX, TCX, FIT and JSON files from services such as Strava, Movescount, Garmin, Polar etc

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Sports Lib

Sports Lib normalizes GPX, TCX, FIT, and service-specific JSON into shared activity and route models.

## Documentation

The hosted documentation contains the supported API and all consumer guidance:

- [API reference](https://sports-alliance.github.io/sports-lib/)
- [Import activities](https://sports-alliance.github.io/sports-lib/documents/Import_activities.html)
- [Work with routes](https://sports-alliance.github.io/sports-lib/documents/Work_with_routes.html)
- [Configure parsing](https://sports-alliance.github.io/sports-lib/documents/Configure_parsing.html)
- [Export and persist data](https://sports-alliance.github.io/sports-lib/documents/Export_and_persist_data.html)
- [Metrics and calculations](https://sports-alliance.github.io/sports-lib/documents/Metrics_and_calculations.html)
- [Three-dimensional power and training-response model](https://sports-alliance.github.io/sports-lib/documents/Three-dimensional_power_and_training-response_model.html)

## Install

```sh
npm install @sports-alliance/sports-lib
```

For GPX parsing in Node.js, also install a DOM parser:

```sh
npm install @xmldom/xmldom
```

## Quick start

```ts
import { SportsLib } from '@sports-alliance/sports-lib';
import { DOMParser } from '@xmldom/xmldom';

const event = await SportsLib.importFromGPX(gpxText, DOMParser);
const activity = event.getFirstActivity();
const distanceMetres = activity.getDistance().getValue();
```

See [Import activities](https://sports-alliance.github.io/sports-lib/documents/Import_activities.html) for the other supported formats and parsing options.

sports-lib

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README