nuzlocke-tracker/.beans/nuzlocke-tracker-x4p6--genlocke-overview-page.md

title, status, type, priority, created_at, updated_at, parent, blocking

title	status	type	priority	created_at	updated_at	parent	blocking
Genlocke overview page	completed	feature	normal	2026-02-09T07:42:19Z	2026-02-09T09:40:02Z	nuzlocke-tracker-25mh	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