Worldbuilding Codex v1.2 — Timeline Explorer #12

New issue

Closed

opened 2026-05-19 05:04:49 +00:00 by foravo_admin · 0 comments

foravo_admin commented

2026-05-19 05:04:49 +00:00

Owner

Copy link

Imported from GitHub issue conorgregson/worldbuilding-codex#15.

Source: https://github.com/conorgregson/worldbuilding-codex/issues/15
Original author: @conorgregson
Original state: closed

Goal

Turn Worldbuilding Codex’s existing event tracking into a dedicated timeline browsing experience for each world.

v1.2 should make timeline events easier to browse, search, filter, understand, and verify as part of the app’s core lore-management workflow.

Context

Worldbuilding Codex v1.0 established the stable portfolio release with the core world, entity, relationship, and timeline workflows complete.

v1.1 improved entity browsing by adding search, filtering, sorting, no-results guidance, URL query state, accessibility polish, and responsive improvements.

v1.2 builds on that foundation by giving timeline events their own focused browsing experience. Instead of only treating events as part of the broader world workflow, this release should make the timeline feel like a dedicated feature.

This epic groups the sprint-level work for the v1.2 Timeline Explorer release.

Scope

Add a dedicated world timeline route.
Improve chronological event layout.
Sort events predictably by timeline/date fields.
Add timeline event search.
Add lightweight timeline filtering.
Preserve timeline browsing state through URL query parameters.
Add useful empty and no-results states.
Show event participants and role labels clearly.
Polish timeline accessibility and responsive behavior.
Update release documentation for v1.2.

Child Issues

Sprint 1: Timeline Route & Chronological Layout
Sprint 2: Timeline Search, Filtering & Empty States
Sprint 3: Participants, Polish & Release Wrap-Up

Acceptance Criteria

Users can open a dedicated timeline page for a world.
Timeline route is protected behind authentication.
Timeline route remains refresh-safe.
Timeline events are ordered by sort year, sort index, and date label where available.
Users can search timeline events by title, summary, description, and participants.
Users can filter timeline events using lightweight timeline controls.
Timeline search/filter state is preserved in URL query parameters.
Timeline events clearly show attached entities and role labels.
Empty and filtered no-results states are clear and actionable.
Timeline page is usable on desktop and mobile.
Timeline controls are keyboard reachable and clearly labelled.
README, ROADMAP, CHANGELOG, sprint docs, PR description, and release notes are updated for v1.2.

Final Verification Checklist

Local Verification

App runs locally.
User can log in locally.
A world with timeline events loads successfully.
Dedicated timeline route loads successfully.
Timeline route refresh works.
Timeline events render in chronological order.
Timeline search works.
Timeline filters work.
Search and filters combine correctly.
Timeline URL query state persists after refresh.
Empty timeline state appears for worlds with no events.
No-results state appears for filtered/search results.
Participant names and role labels appear where available.
Participant/entity links work where supported.
Keyboard navigation works.
Focus states are visible.
Mobile layout is usable.
No major console errors appear.

Production Verification

Production frontend loads successfully.
Production login works.
Production world detail flow works.
Production timeline route loads successfully.
Production timeline route refresh works.
Production timeline search/filtering works.
Production participant display works.
Backend health endpoint is reachable.
No major production console errors appear.

Release Verification

README updated for v1.2.
ROADMAP updated for v1.2 release status.
CHANGELOG includes v1.2.0 entry.
GitHub release notes prepared.
Sprint blueprints include final verification notes.
Version tagged as v1.2.0.

Out of Scope

Relationship graph work.
World import/export.
Public world sharing.
Advanced fictional calendar systems.
Timeline eras.
Drag-and-drop event ordering.
Saved timeline views.
AI-assisted lore tools.
Collaboration or invite-based editing.

Imported from GitHub issue `conorgregson/worldbuilding-codex#15`. Source: https://github.com/conorgregson/worldbuilding-codex/issues/15 Original author: @conorgregson Original state: closed  --- ## Goal Turn Worldbuilding Codex’s existing event tracking into a dedicated timeline browsing experience for each world. v1.2 should make timeline events easier to browse, search, filter, understand, and verify as part of the app’s core lore-management workflow. --- ## Context Worldbuilding Codex v1.0 established the stable portfolio release with the core world, entity, relationship, and timeline workflows complete. v1.1 improved entity browsing by adding search, filtering, sorting, no-results guidance, URL query state, accessibility polish, and responsive improvements. v1.2 builds on that foundation by giving timeline events their own focused browsing experience. Instead of only treating events as part of the broader world workflow, this release should make the timeline feel like a dedicated feature. This epic groups the sprint-level work for the v1.2 Timeline Explorer release. --- ## Scope - Add a dedicated world timeline route. - Improve chronological event layout. - Sort events predictably by timeline/date fields. - Add timeline event search. - Add lightweight timeline filtering. - Preserve timeline browsing state through URL query parameters. - Add useful empty and no-results states. - Show event participants and role labels clearly. - Polish timeline accessibility and responsive behavior. - Update release documentation for v1.2. --- ## Child Issues - [x] Sprint 1: Timeline Route & Chronological Layout - [x] Sprint 2: Timeline Search, Filtering & Empty States - [x] Sprint 3: Participants, Polish & Release Wrap-Up --- ## Acceptance Criteria - [x] Users can open a dedicated timeline page for a world. - [x] Timeline route is protected behind authentication. - [x] Timeline route remains refresh-safe. - [x] Timeline events are ordered by sort year, sort index, and date label where available. - [x] Users can search timeline events by title, summary, description, and participants. - [x] Users can filter timeline events using lightweight timeline controls. - [x] Timeline search/filter state is preserved in URL query parameters. - [x] Timeline events clearly show attached entities and role labels. - [x] Empty and filtered no-results states are clear and actionable. - [x] Timeline page is usable on desktop and mobile. - [x] Timeline controls are keyboard reachable and clearly labelled. - [x] README, ROADMAP, CHANGELOG, sprint docs, PR description, and release notes are updated for v1.2. --- ## Final Verification Checklist ### Local Verification - [x] App runs locally. - [x] User can log in locally. - [x] A world with timeline events loads successfully. - [x] Dedicated timeline route loads successfully. - [x] Timeline route refresh works. - [x] Timeline events render in chronological order. - [x] Timeline search works. - [x] Timeline filters work. - [x] Search and filters combine correctly. - [x] Timeline URL query state persists after refresh. - [x] Empty timeline state appears for worlds with no events. - [x] No-results state appears for filtered/search results. - [x] Participant names and role labels appear where available. - [x] Participant/entity links work where supported. - [x] Keyboard navigation works. - [x] Focus states are visible. - [x] Mobile layout is usable. - [x] No major console errors appear. ### Production Verification - [x] Production frontend loads successfully. - [x] Production login works. - [x] Production world detail flow works. - [x] Production timeline route loads successfully. - [x] Production timeline route refresh works. - [x] Production timeline search/filtering works. - [x] Production participant display works. - [x] Backend health endpoint is reachable. - [x] No major production console errors appear. ### Release Verification - [x] README updated for v1.2. - [x] ROADMAP updated for v1.2 release status. - [x] CHANGELOG includes v1.2.0 entry. - [x] GitHub release notes prepared. - [x] Sprint blueprints include final verification notes. - [x] Version tagged as v1.2.0. --- ## Out of Scope - Relationship graph work. - World import/export. - Public world sharing. - Advanced fictional calendar systems. - Timeline eras. - Drag-and-drop event ordering. - Saved timeline views. - AI-assisted lore tools. - Collaboration or invite-based editing.

foravo_admin

2026-05-19 05:04:49 +00:00