# outdoors.live

> Multilingual (English / Romanian) platform for outdoor sports events in Romania and beyond — trail running, road running, cycling (MTB, gravel, road), triathlon and multisport. Race calendar, course maps (GPX, 3D), start lists, results with per-checkpoint splits, live tracking and live streams, news, videos and public athlete profiles. A REST API powers the mobile app.

Site: https://outdoors.live (English). Romanian version of every page: prefix the path with `/ro`, e.g. https://outdoors.live/ro/find.

## Key pages

- [Home](https://outdoors.live/): races happening today, upcoming and recent events
- [Find a race](https://outdoors.live/find): searchable race list with filters (sport type, distance, month, year, county, city, course profile/terrain, event format, labels)
- [Calendar](https://outdoors.live/calendar): month-by-month race calendar
- [Live](https://outdoors.live/live): live streams and live tracking for races in progress
- [News](https://outdoors.live/news): outdoor sports news and event announcements
- [Videos](https://outdoors.live/videos): race videos, channels and playlists
- [Athletes](https://outdoors.live/athlete): public athlete profiles with race history
- [Partners](https://outdoors.live/partners)
- [About](https://outdoors.live/about)
- [Contact](https://outdoors.live/contact)

## Race pages: maps, 3D map, elevation profile, checkpoints

Every competition (race distance) page has tabs:

- **Map** — interactive 2D map of the GPX course with start/finish, checkpoints and aid stations; during a live race it shows runner positions (head runners / leaders and, where enabled, the full field with GPS-tracked athletes, searchable by name). Multi-segment courses can be shown combined or as alternative tracks.
- **3D map** — terrain view of the course rendered from the GPX track with satellite imagery and elevation, including a fly-along animation of the route and live leader positions when the race is on.
- **Profile** — elevation profile of the course with checkpoint markers, distance/ascent per segment, and live leader progress plotted on the profile.
- **Checkpoints** — list of checkpoints/aid stations with distance, altitude, cut-offs and, once results exist, per-checkpoint split times and checkpoint records.
- **Start list** and **Results** — results with per-checkpoint splits, runner status (finisher, ranked, on course, DNF), and a personal page per bib.
- **Weather** widget for the course area and a countdown before the start.

Embeddable, chrome-free versions of these views exist for organisers and TV/broadcast graphics: `/{event-slug}/{season-slug}/{competition-slug}/embed/map`, `/embed/3dmap`, `/embed/profile`, `/embed/results`, `/embed/estimate` (live pace-estimate overlay) and `/embed/estimate3d`.

## Mobile apps

outdoors.live has native apps for **iOS and Android** (details and download links at https://outdoors.live/mobile). The app uses the same public API as the website and offers:

- Everything from the platform — events, seasons, competitions, news, videos, results — optimised for mobile
- **Live GPS tracking** — athletes share their live position during a race so friends, family and fans can follow them on the course map in real time; spectators can see the field on the map
- **Live streaming** — watch race broadcasts and chat with other fans inside the competition page
- **Push notifications** — alerts when a followed competition is about to start, when results are published, or when news is posted; notification topics and channels are configurable
- **Bucket list** — save races you plan to do, add your bib number, and sync your results automatically

## User profile & account

Registration is free (https://outdoors.live/register). A logged-in user has a profile at https://outdoors.live/profile with tabs:

- **Personal** — first/last name, birthday, sex, preferred language; optional athlete fields (photo, club, team, social links, sport types, ITRA / UTMB links)
- **Security** — password change
- **Notifications** — email / push preferences per topic (race alerts, newsletter, results, news)
- **Race alerts** — seasons the user is subscribed to for start/results alerts
- **Bucket list** — saved races and bib numbers (also at https://outdoors.live/bucketlist)

A user who has raced gets a **public athlete profile** at `https://outdoors.live/athlete/{id}.{first}.{last}` listing their race history and results on the platform (plus imported UTMB results where linked).

Organisers can claim their events and manage them from a dashboard (organisation, seasons, competitions, GPX tracks, results providers, partners, news, live streaming). The dashboard is not public.

## URL structure

- Event: `https://outdoors.live/{event-slug}` — one page per event (e.g. a race series)
- Edition ("season", usually a year): `https://outdoors.live/{event-slug}/{season-slug}`
- Race / distance ("competition"): `https://outdoors.live/{event-slug}/{season-slug}/{competition-slug}` — course map, elevation profile, 3D view, start list, results with checkpoint splits, live tracking when the race is on
- Runner page for one race: `https://outdoors.live/{event-slug}/{season-slug}/{competition-slug}/bib/{bib}.{name}`
- Athlete profile: `https://outdoors.live/athlete/{id}.{first}.{last}`
- News article: `https://outdoors.live/news/{slug}`
- Sitemap: https://outdoors.live/sitemap.xml
- Robots: https://outdoors.live/robots.txt

## Public API

- [OpenAPI 3.0 spec](https://outdoors.live/api/v1/openapi.json): the single source of truth for the public REST API, base path `https://outdoors.live/api/v1`
- Read-only, no auth needed: `/seasons/today`, `/seasons/next`, `/seasons/past`, `/seasons/live-now`, `/seasons/search`, `/events/{slug}`, `/competitions/{id}/results`, `/competitions/{id}/start-list`, `/news`, `/videos`, `/athletes/{id}`, `/search`, `/cities`
- Authenticated (JWT via `POST /auth/login`, then `Authorization: Bearer <token>`): `/profile`, `/bucket-list`, `/notifications`
- Responses are JSON. Bilingual text fields are objects of the form `{"en": "...", "ro": "..."}`.

## Optional

- [Privacy policy](https://outdoors.live/privacy)
- [Terms](https://outdoors.live/terms)
- [Cookie policy](https://outdoors.live/cookie-policy)
- [Mobile app](https://outdoors.live/mobile)