zest

zest is an open-source, self-hostable dashboard for your running data.

Description

zest integrates with services like Strava, using their API to download all available running activities and storing them locally in a PostgreSQL database.

Integrations:

• Strava
• Garmin Connect
• Upload .FIT file

Getting started

Install dependencies by running yarn in the root folder.

Project structure

Every folder in the /appsfolder represents a yarn workspace.

• apps/api contains the Nest.js API
• apps/web contains the Vite.js React frontend

Running scripts for the individual workspaces can be done from the root project folder using yarn workspace <workspace-name> run <script-name>. For example running the apps individually in development mode:

Development mode

# start both api and web in dev mode
turbo dev

• The API is available at localhost:3000, with the Swagger docs accessible at localhost:3000/docs.
• The frontend is available at localhost:5173.

Testing

API

Testing is done using the jest testing framework. Tests are stored *.spec.ts files next to the code files they are testing.

yarn workspace api run test