Description
Home is the signed-in workspace cockpit: a single landing surface that answers what changed, what needs attention, and where the user should resume. Its full-width constellation hero visualizes the current knowledge graph and supports progressive drill-down, while the lower regions combine workspace statistics, recent activity, attention counts, and “jump back in” destinations. A cold or sparse workspace receives useful first-run guidance instead of an empty graph.
The page is deliberately more than a dashboard of disconnected numbers. Graph density controls the hero treatment, activity and recent destinations are independently resilient, and the bottom regions preserve their reading order and internal scrolling at desktop and tablet widths. The result is a stable starting point even when one backing read is unavailable.
Selling Points
- Gives users one trustworthy place to resume work, reducing the time spent hunting through modules after each sign-in.
- Turns graph growth into visible progress, so buyers can see their knowledge base becoming more connected rather than merely larger.
- Separates “recent” from “needs attention,” helping users distinguish convenient shortcuts from work that genuinely requires action.
- Handles new, sparse, and mature workspaces with purpose-built states, keeping the first session useful without hiding advanced graph behavior.
- Keeps independent regions usable when one read fails, so a transient graph or activity error does not blank the whole home experience.
User Story
A team lead opens Dots at the start of the day. They inspect the constellation for a newly connected cluster, scan the activity rail for overnight changes, notice two review items in Needs You, and use Jump Back In to reopen yesterday’s Dotabase. They leave Home with both situational awareness and a concrete next action.
Extension Surface
This feature is configurable rather than externally pluggable. apps/web/src/modules/home/components/HeroControlBar.tsx exposes graph filters and view controls, while apps/web/src/modules/home/hooks/use-graph-filter.tsx maintains the selected lens across reads. The fixed region composition is not a public widget-registration surface; users shape what the graph shows, not the page’s component inventory.
Capabilities & Limits
- Presents graph exploration, workspace statistics, recent destinations, activity, and attention counts in one coherent layout.
- Adapts between ambient first-run imagery and live graph scenes based on real graph density.
- Preserves keyboard and screen-reader access to graph nodes and region headings.
- Limit: stat tiles are readouts, not arbitrary drill links, and Home does not support user-authored dashboard widgets or free-form rearrangement.
Implementation Map
apps/web/src/modules/home/pages/HomePage.tsxapps/web/src/modules/home/components/ConstellationHero.tsxapps/web/src/modules/home/components/JumpBackInRegion.tsxapps/web/src/modules/home/components/ActivityFeed.tsx