---
# nuzlocke-tracker-x4p6
title: Genlocke overview page
status: completed
type: feature
priority: normal
created_at: 2026-02-09T07:42:19Z
updated_at: 2026-02-09T09:40:02Z
parent: nuzlocke-tracker-25mh
blocking:
    - nuzlocke-tracker-lsc2
    - nuzlocke-tracker-lsdy
---

A dedicated dashboard page for a genlocke, showing progress, configuration, and cumulative stats across all legs.

## Page Layout

### Progress Section
- Visual timeline or step indicator showing all legs in order
- Each leg shows: game icon/color, game name, leg status (upcoming / active / completed / failed)
- The active leg is highlighted and links to its run page
- Completed legs show key stats (encounters, deaths, HoF team)

### Configuration Section
- Display the selected genlocke rules (Keep HoF / Retire HoF)
- Display the nuzlocke rules applied to all legs
- List of all games in leg order

### Cumulative Stats Section
- Total encounters across all legs
- Total deaths across all legs
- Total unique Pokemon caught
- Current surviving team count
- Legs completed / total legs

### Quick Actions
- Link to active leg's run page
- Link to genlocke-wide graveyard (if implemented)
- Link to lineage view (if implemented)

## Backend
- `GET /api/v1/genlockes` — List all genlockes (for a genlocke list page)
- `GET /api/v1/genlockes/{id}` — Get genlocke with legs, runs, and aggregated stats

## Frontend
- New route: `/genlockes/:genlockeId`
- Also need a genlocke list page at `/genlockes` (or integrate into the existing runs list)
- Consider adding a "Genlockes" nav item alongside "Runs"

## Checklist
- [ ] Implement `GET /api/v1/genlockes` endpoint (list all genlockes with basic info and leg count)
- [ ] Implement `GET /api/v1/genlockes/{id}` endpoint (full genlocke with legs, runs, and aggregated stats)
- [ ] Add TypeScript types for genlocke detail/list API responses
- [ ] Build the genlocke list page at `/genlockes` showing all genlockes with status and progress
- [ ] Build the genlocke detail page at `/genlockes/:genlockeId`
- [ ] Build the progress section: visual leg timeline with game colors, statuses, and links to runs
- [ ] Build the configuration section: display genlocke rules and nuzlocke rules
- [ ] Build the cumulative stats section: aggregate encounters, deaths, and completions across legs
- [ ] Add quick action links (active leg, graveyard, lineage — placeholder links for unimplemented features)
- [ ] Build "Retired Families" section: when retireHoF is enabled, display cumulative retired Pokemon with sprites grouped by leg (data available via `GET /api/v1/genlockes/{id}/retired-families`)
- [ ] Add "Genlockes" navigation item to the app nav bar
- [ ] Add `/genlockes` and `/genlockes/:genlockeId` routes to the React Router config