# RunFolio

> Every finish, framed. RunFolio is a portfolio for runners: each person logs the
> races they have finished — distance, finish time, bib, photographs — and gets
> one public page that holds all of it. Races can be imported from Strava or
> entered by hand. Using it is free, and a profile is public at a stable URL.

Every public page has a JSON twin at the same address with `.json` appended, so
nothing here needs to be scraped out of HTML. All JSON responses send
`Access-Control-Allow-Origin: *` and are cached for five minutes.

## Data

- [Runner profile JSON](https://runfolio.in/runner/USERNAME.json): one runner — their totals, personal bests, races per year, races per city, and every race with its date, distance, finish time, computed pace and photograph URLs. Replace `USERNAME`.
- [Race JSON](https://runfolio.in/runner/USERNAME/RACE_ID.json): one race in full, with its whole gallery. `RACE_ID` is the uuid from the page URL.
- [Directory JSON](https://runfolio.in/api/explore.json): the runners who have opted into being listed. Accepts `?q=` (name or username), `?city=` (the runner's own location) and `?page=`.
- [API notes](https://runfolio.in/api-docs): the three endpoints above, with example responses.
- [Capability descriptor](https://runfolio.in/.well-known/runfolio.json): the same endpoints, machine-readable.

## Pages

- [Home](https://runfolio.in/): what the product is.
- [Features](https://runfolio.in/features): what it does, in detail.
- [Explore](https://runfolio.in/explore): the runner directory. Listed runners only.
- [About](https://runfolio.in/about): why it exists and who built it.
- [FAQ](https://runfolio.in/faq): cost, privacy, Strava, deletion.
- [Tools](https://runfolio.in/tools): free calculators, no account needed.
- [Changelog](https://runfolio.in/changelog): what has shipped.
- [Contact](https://runfolio.in/contact): questions and feature requests.

## Tools

- [Training plan generator](https://runfolio.in/tools/training-plan): Turn a 5K or 10K time trial into target paces, predicted finish times and a week-by-week plan for a half or full marathon.
- [Pace calculator](https://runfolio.in/tools/pace-calculator): A distance and a time give the pace you ran, per kilometre and per mile. A distance and a pace give the finish time, with the splits to hit on the way.
- [Race time predictor](https://runfolio.in/tools/race-predictor): One result you have already run, turned into what it is worth at 5K, 10K, the half and the marathon.
- [Split planner](https://runfolio.in/tools/split-planner): A goal time as the number you need to see at each marker — even, a negative split, or the fade you would rather plan than discover.
- [Khadakwasla Ultra training plan](https://runfolio.in/tools/khadakwasla-ultra): The full ten-week block for the 25K, 35K and 55K at Khadakwasla on 22 November 2026 — every session, the pace zones, the fuelling, and what to do on race morning.

## Not published

These are not reachable at any URL, by design rather than by obscurity:

- **Dates of birth.** Stored, never public — the database view every public page
  reads through does not carry the column.
- **Email addresses.** Held by the authentication provider and never exposed.
- **Strava tokens.** Held in a table with no read policy for any public role.
- **Runners who have left the directory.** Their pages stay public at their own
  address; they are absent from https://runfolio.in/explore, from the directory JSON and
  from the sitemap.
- **Anything under `/dashboard`.** Requires a session and belongs to one person.

## Terms

- [Privacy](https://runfolio.in/privacy)
- [Terms](https://runfolio.in/terms)

Written and run by Sanket Tambare. Corrections and questions:
sanket.tambare01@gmail.com.