treinante

Website

Treinante is a running analytics platform for importing runs, analysing training, tracking progress, and using practical training tools. It is designed for road, trail, track, and mixed runners, with features that adapt to the data each runner provides.

About me · Twitter / X · GitHub

Screenshots

Features

• Supabase authentication, onboarding, and protected routes
• GPX upload, Strava sync, and manual run entry
• Normalised run storage across all import sources
• Per-run analysis with splits, pace, heart rate, elevation, and GAP
• Dashboard charts for volume, pace, elevation, and heart rate trends
• Personal record extraction and history
• Fitness and freshness tracking with ATL, CTL, and TSB
• Race prediction tools
• Segment matching and progress tracking
• Weekly training summaries
• Public training calculators

Getting Started

Install dependencies:

pnpm install

Create a local environment file:

cp .env.local.example .env.local

Fill in the required values in .env.local, then start the dev server:

pnpm dev

Open http://localhost:3000 in your browser.

Database Workflow

Database schema changes live in supabase/migrations. Do not rely on one-off SQL Editor changes as the source of truth.

Link the Supabase CLI once per machine:

pnpm exec supabase link --project-ref <ref>

Apply migrations:

pnpm db:push

Regenerate database types:

pnpm db:types

Project Structure

src/app/          Next.js App Router routes and route handlers
src/components/   Shared UI, layout, chart, run, tool, and segment components
src/hooks/        Client-side React hooks
src/lib/          Supabase, IndexedDB, import, calculation, and reporting helpers
src/types/        Shared TypeScript contracts and generated database types
prd/              Product requirements and build order
supabase/         SQL migrations and Supabase project files

Development Notes

• Use pnpm for package operations, not npm or yarn.
• Do not install packages published less than 1 day ago.
• PRDs define product scope and implementation order.
• Keep schema changes in SQL migrations.
• Keep secrets out of git.

Documentation

• prd/README.md - PRD index and suggested build order
• prd/00-overview/PRD.md - product vision, architecture, and constraints
• AGENTS.md - repository-specific working rules for agents