Worldbuilding Codex v1.3 — Relationship Graph #8

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#20.

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

Goal

Add a visual Relationship Graph that helps users explore connected lore across each world.

v1.3 should make entity relationships easier to understand by rendering world entities as nodes, relationships as directional edges, and selected connections as visually highlighted graph paths.

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 turned timeline events into a dedicated browsing experience with timeline search, filtering, participant visibility, route-safe navigation, and release polish.

v1.3 builds on that foundation by giving entity relationships their own visual exploration experience. Instead of only viewing relationships as form/list data, users should be able to see how characters, locations, factions, species, artifacts, cultures, and other entities connect across a world.

This epic groups the sprint-level work for the v1.3 Relationship Graph release.

Scope

Add a dedicated relationship graph page or section.
Render world entities as graph nodes.
Render entity relationships as directional graph edges.
Show relationship type or label information where practical.
Support graph navigation from entity nodes to entity detail pages.
Add relationship type filtering.
Add selected entity highlighting.
Highlight incoming and outgoing relationships for a selected entity.
Add useful empty, no-relationship, no-results, and fallback states.
Polish graph accessibility and keyboard behavior.
Polish graph responsive layout.
Confirm graph route refresh behavior.
Update release documentation for v1.3.

Child Issues

Sprint 1: Graph Foundation
Sprint 2: Navigation, Filtering & Highlighting
Sprint 3: Empty States, Accessibility & Release Polish

Acceptance Criteria

Users can open a dedicated Relationship Graph page or section for a world.
Relationship Graph route is protected behind authentication.
Relationship Graph route remains refresh-safe.
Entities render as visible graph nodes.
Relationships render as visible directional edges.
Relationship type or label information is visible where practical.
Users can navigate from a graph node to the matching entity detail page.
Users can filter graph edges by relationship type.
Relationship filtering updates the graph without crashing.
Users can select an entity in the graph.
Selected entities are visually highlighted.
Incoming relationships for the selected entity are highlighted.
Outgoing relationships for the selected entity are highlighted.
Users can clear graph selection and reset filters.
Worlds with no entities show a helpful empty state.
Worlds with entities but no relationships show a helpful empty state.
Filtered graph results with no matches show a clear no-results state.
Graph controls are keyboard reachable and clearly labelled.
Graph highlighting is understandable and does not rely only on color where practical.
Relationship Graph page is usable on desktop and mobile.
README, ROADMAP, CHANGELOG, sprint docs, PR description, and release notes are updated for v1.3.

Final Verification Checklist

Local Verification

App runs locally.
User can log in locally.
A world with entities and relationships loads successfully.
Dedicated Relationship Graph route/page loads successfully.
Relationship Graph route refresh works.
Entity nodes render correctly.
Relationship edges render correctly.
Relationship type or label information appears where practical.
Entity node navigation works.
Relationship type filtering works.
Graph filter reset works.
Selected entity highlighting works.
Incoming relationship highlighting works.
Outgoing relationship highlighting works.
Clear selection works.
World with no entities shows a helpful empty state.
World with entities but no relationships shows a helpful empty state.
Filtered no-results state appears when applicable.
Keyboard navigation works for graph controls.
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 Relationship Graph route/page loads successfully.
Production Relationship Graph route refresh works.
Production entity nodes render correctly.
Production relationship edges render correctly.
Production graph node navigation works.
Production relationship filtering works.
Production selected entity highlighting works.
Production empty/no-results graph states work.
Backend health endpoint is reachable.
No major production console errors appear.

Release Verification

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

Out of Scope

World import/export.
Public world sharing.
Advanced graph search.
Saved graph views.
Graph layout persistence.
Drag-and-drop graph editing.
Creating relationships directly from the graph.
Editing relationships directly from the graph.
Deleting relationships directly from the graph.
Advanced graph clustering.
Public graph sharing.
AI-assisted lore analysis.
Lore consistency warnings.
Collaboration or invite-based editing.

Imported from GitHub issue `conorgregson/worldbuilding-codex#20`. Source: https://github.com/conorgregson/worldbuilding-codex/issues/20 Original author: @conorgregson Original state: closed  --- ## Goal Add a visual Relationship Graph that helps users explore connected lore across each world. v1.3 should make entity relationships easier to understand by rendering world entities as nodes, relationships as directional edges, and selected connections as visually highlighted graph paths. --- ## 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 turned timeline events into a dedicated browsing experience with timeline search, filtering, participant visibility, route-safe navigation, and release polish. v1.3 builds on that foundation by giving entity relationships their own visual exploration experience. Instead of only viewing relationships as form/list data, users should be able to see how characters, locations, factions, species, artifacts, cultures, and other entities connect across a world. This epic groups the sprint-level work for the v1.3 Relationship Graph release. --- ## Scope - Add a dedicated relationship graph page or section. - Render world entities as graph nodes. - Render entity relationships as directional graph edges. - Show relationship type or label information where practical. - Support graph navigation from entity nodes to entity detail pages. - Add relationship type filtering. - Add selected entity highlighting. - Highlight incoming and outgoing relationships for a selected entity. - Add useful empty, no-relationship, no-results, and fallback states. - Polish graph accessibility and keyboard behavior. - Polish graph responsive layout. - Confirm graph route refresh behavior. - Update release documentation for v1.3. --- ## Child Issues - [x] Sprint 1: Graph Foundation - [x] Sprint 2: Navigation, Filtering & Highlighting - [x] Sprint 3: Empty States, Accessibility & Release Polish --- ## Acceptance Criteria - [x] Users can open a dedicated Relationship Graph page or section for a world. - [x] Relationship Graph route is protected behind authentication. - [x] Relationship Graph route remains refresh-safe. - [x] Entities render as visible graph nodes. - [x] Relationships render as visible directional edges. - [x] Relationship type or label information is visible where practical. - [x] Users can navigate from a graph node to the matching entity detail page. - [x] Users can filter graph edges by relationship type. - [x] Relationship filtering updates the graph without crashing. - [x] Users can select an entity in the graph. - [x] Selected entities are visually highlighted. - [x] Incoming relationships for the selected entity are highlighted. - [x] Outgoing relationships for the selected entity are highlighted. - [x] Users can clear graph selection and reset filters. - [x] Worlds with no entities show a helpful empty state. - [x] Worlds with entities but no relationships show a helpful empty state. - [x] Filtered graph results with no matches show a clear no-results state. - [x] Graph controls are keyboard reachable and clearly labelled. - [x] Graph highlighting is understandable and does not rely only on color where practical. - [x] Relationship Graph page is usable on desktop and mobile. - [x] README, ROADMAP, CHANGELOG, sprint docs, PR description, and release notes are updated for v1.3. --- ## Final Verification Checklist ### Local Verification - [x] App runs locally. - [x] User can log in locally. - [x] A world with entities and relationships loads successfully. - [x] Dedicated Relationship Graph route/page loads successfully. - [x] Relationship Graph route refresh works. - [x] Entity nodes render correctly. - [x] Relationship edges render correctly. - [x] Relationship type or label information appears where practical. - [x] Entity node navigation works. - [x] Relationship type filtering works. - [x] Graph filter reset works. - [x] Selected entity highlighting works. - [x] Incoming relationship highlighting works. - [x] Outgoing relationship highlighting works. - [x] Clear selection works. - [x] World with no entities shows a helpful empty state. - [x] World with entities but no relationships shows a helpful empty state. - [x] Filtered no-results state appears when applicable. - [x] Keyboard navigation works for graph controls. - [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 Relationship Graph route/page loads successfully. - [x] Production Relationship Graph route refresh works. - [x] Production entity nodes render correctly. - [x] Production relationship edges render correctly. - [x] Production graph node navigation works. - [x] Production relationship filtering works. - [x] Production selected entity highlighting works. - [x] Production empty/no-results graph states work. - [x] Backend health endpoint is reachable. - [x] No major production console errors appear. ### Release Verification - [x] README updated for v1.3. - [x] ROADMAP updated for v1.3 release status. - [x] CHANGELOG includes v1.3.0 entry. - [x] GitHub release notes prepared. - [x] Sprint blueprints include final verification notes. - [x] Version tagged as v1.3.0. --- ## Out of Scope - World import/export. - Public world sharing. - Advanced graph search. - Saved graph views. - Graph layout persistence. - Drag-and-drop graph editing. - Creating relationships directly from the graph. - Editing relationships directly from the graph. - Deleting relationships directly from the graph. - Advanced graph clustering. - Public graph sharing. - AI-assisted lore analysis. - Lore consistency warnings. - Collaboration or invite-based editing.

foravo_admin

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