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
• Import activities
• Work with routes
• Configure parsing
• Export and persist data
• Metrics and calculations

Install

npm install @sports-alliance/sports-lib

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

npm install @xmldom/xmldom

Quick start

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 for the other supported formats and parsing options.