Skip to content

Repository files navigation

Strides

Couch to 5K, built for people who don't run yet — and grounded in the science of not getting hurt.

Strides turns "I want to run a 5K" into a concrete, personalized plan and coaches you through every session: a run/walk timer with audio + haptic cues, a screen that stays awake, a live notification, and progress you can see. It's for the person before they'd ever open Strava.

Everything stays on your device — no account, no analytics, no data ever leaves your phone.

Features

  • Personalized plan. Pick your goal (5K), your timeline, and how many runs a week. Strides generates a run/walk progression scaled safely to you — and pushes back on goals that would get a beginner hurt.
  • The session player. Big glanceable run/walk timer with a countdown ring, audio + haptic cues, screen-stays-awake, and a persistent notification.
  • Evidence-based. Every recommendation is sourced (NHS Couch to 5K, peer-reviewed sports medicine). The Method screen shows the why, honestly — including which "rules" are actually myths.
  • Track everything. Streaks, calendar, week-by-week progress, longest run.
  • Forgiving. Repeat any week with no penalty. A missed run is just a missed run.

Stack

Expo SDK 56 · React Native · expo-router · TypeScript (strict) · expo-sqlite (local-first). See AGENTS.md for the architecture and conventions.

Develop

npm install
npx expo start          # then press a / i, or scan with a dev build

# native run (JDK 17 required):
export JAVA_HOME=/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home
npx expo run:android

Type-check: npx tsc --noEmit.

License

MIT © Emile Legendre

About

Couch to 5K, built for people who don't run yet — a private, science-backed run/walk coach. Expo · React Native · local-first.

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages