Kickoff: Graph Layout Enhancements
- Dominant language
- TypeScript
- Stars
- 481
- Forks
- 108
- Avg merge
- 6d 8h
- Merged PRs (30d)
- 5
Description
> [!NOTE]
> **Kickoff — Wayfinder not yet run, no chart yet.** Placeholder child of the **Graph Layout Enhancements** initiative (#2017). "Placeholder" means only that there's no chart — the content below is real. Run `/wayfinder` against the initiative to create the map; **this kickoff closes when that map is created**.
## Rough intent
Research and scope how to give users richer, more configurable graph layout: more algorithms, tunable options, and dependable persistence.
## Paths to explore
- **New layout algorithms** *(research + prototype)* — which additional layouts are worth offering beyond today's set (hierarchical/DAG, radial, concentric, grid, geographic)? What does each require from the Cytoscape layer?
- **Configurable layout options** *(prototype)* — let users tune a layout: spacing, edge length/springiness (relates to #321), direction, iterations. What UI exposes this without overwhelming?
- **Layout persistence** *(grilling)* — reconcile with the committed v3.3 work (#890 save layout choice to saved graph/session, #1430 save layout choice in schema explorer) and node-position persistence (#1428). What's the complete persistence model?
- **Auto/suggested layout** *(prototype)* — should the app pick a sensible layout based on graph shape? (Overlaps the AI-chosen-layout path in the AI initiative — coordinate, don't duplicate.)
## Potential blockers & pitfalls
- **Cytoscape coupling:** layout work rides on the Cytoscape abstraction; the deep-module rework (#1891) may change what's available — coordinate sequencing.
- **Overlap with AI initiative:** "AI-chosen canvas layout" lives in the AI Model Integration kickoff; keep the boundary clear (this initiative = the layout *engine + options*; AI = *choosing* one).
## Related issues
- Initiative: #2017
- Committed v3.3 (independent): #890, #1430
- Related: #321 (edge length/springiness), #1428 (persist node positions), #691 (roadmap: rendering), #1486 (roadmap: schema explorer)
> [!IMPORTANT]
> Internal only — this issue is maintained by the core team and is not accepting external contributions.
Contributor guide
Research direction
Start with initiative #2017 and run `/wayfinder` against it to create the map. Review the paths to explore, related issues, Cytoscape coupling, and the AI initiative boundary while scoping the work. Done means the initiative map exists; this kickoff then closes.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- react, typescript
- Domain
- data-visualization, frontend
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Needs clarification
- Newbie friendliness
- 15/100