Skip to content

ux(dashboard): meaningful container names + readable node cards#412

Open
maximbelyakov wants to merge 2 commits into
Egonex-AI:mainfrom
maximbelyakov:ux/dashboard-containers-and-cards
Open

ux(dashboard): meaningful container names + readable node cards#412
maximbelyakov wants to merge 2 commits into
Egonex-AI:mainfrom
maximbelyakov:ux/dashboard-containers-and-cards

Conversation

@maximbelyakov

Copy link
Copy Markdown

Two UX improvements for the layer-detail view

1. Meaningful container names (deriveContainers)

  • Community (Louvain) clusters were labeled "Cluster A/B/C" — meaningless to users. Now labeled by member file basenames: sagas · service · actions +2.
  • When ALL nodes of a layer sit flat in one folder (common for Redux slice folders or Java packages), folder grouping yields 1 bucket and the code fell back to Louvain, splitting a cohesive unit into arbitrary anonymous clusters. A single folder covering the whole set is itself meaningful — keep it as ONE container named after the folder (e.g. meetingTypes).

Tests updated; new test covers member-derived community names. 43/43 dashboard tests pass.

2. Readable node cards and visible portal edges

The style commit is opinionated — happy to gate it behind a setting if preferred.

Found while building a graph for a real Java + TypeScript codebase (49 files, 171 nodes).

1. Community clusters are now labeled by their member files
   ("sagas · service · actions +2") instead of "Cluster A/B/C".
2. A single folder covering the whole filtered set (e.g. a Redux slice
   folder like src/store/meetingTypes) is kept as ONE container named
   after the folder instead of being split into anonymous Louvain
   communities. Tests updated + new coverage for both behaviors.
- Node cards: 310px max width (was 220), titles wrap to 2 lines and
  truncate at 60 chars (was 24), summaries clamp at 3 lines (was 2).
  NODE_WIDTH/HEIGHT layout constants bumped to match.
- Portal edges: stroke opacity 0.2 -> 0.55, width 1.6 - they were
  nearly invisible on the dark background, making layers look
  disconnected even when edges existed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant