🗺️ Study Room Connections

Room Connections is an interactive, zoomable graph that shows how your study rooms relate to one another. Each node is a room you belong to. Each edge (line) between nodes is a connection you define — labelled with whatever relationship makes sense to you, like related research, reference, or spawned from.

Unlike a feed or a folder, a graph lets you see clusters, paths, and gaps in your knowledge work at a glance. The map is yours — no one else can see or edit your connections.

Imagine a family using NotaeLibrary together. You create a room called Family Album as a shared archive and invite your partner, your adult children, and a sibling. Over time the family builds out a constellation of rooms — some created by you, some by others who then invited you in.

• Homeroom node — the room with a blue border and glow is your Homeroom. It is always the default centre of the graph and cannot be removed from the canvas.
• Radial rings — rooms are arranged in concentric rings around the focal node. Rooms directly connected to the focal node sit on the first ring (~220 px out), second-degree rooms sit on the second ring (~420 px), and so on.
• Edge labels — each connection displays its label on the line midpoint. Hover a label to read it without zooming.
• Faded nodes— a node that appears semi-transparent means you haven't visited that room recently (time-decay opacity). Rooms visited in the past 30 days are fully opaque; 30–90 days = 70%; 90–180 days = 40%; 180+ days = 20%. Pin a room to override this and keep it fully visible regardless of activity.
• Disconnected rooms— rooms you belong to that have no connections to the focal room yet are clustered at the right-hand periphery so they're always reachable.

1. 1

   Single-click to re-centre

   Click any node to make it the new focal room. The graph re-arranges radially around that room and a breadcrumb trail appears at the top of the canvas so you can trace your path back.
2. 2

   Breadcrumb trail

   The breadcrumb bar shows every room you have clicked through in this session. Click any crumb to jump back to that focal point. Click the Homeroom name (the first crumb, always shown in indigo) to instantly reset the focal room to your Homeroom.
3. 3

   Double-click to open the World graph

   Double-clicking a room node opens that room's World graph— the entity/relation knowledge graph inside the room itself. A "← Back to Room Connections" link will appear there so you can return to this view.
4. 4

   Pan & zoom

   Drag the canvas background to pan. Scroll to zoom. The zoom controls in the bottom-left corner also provide fit-to-view and lock-zoom buttons.
5. 5

   Depth selector

   The Depth 1 / 2 / 3 buttons in the top-left toolbar control how many hops from the focal room are shown at once.

   • Depth 1 — only rooms directly connected to the focal node.
   • Depth 2 (default) — direct connections plus their connections.
   • Depth 3 — three hops out; good for seeing the full landscape.

   Your Homeroom is always shown regardless of the depth setting.

Connections are directional — they go from one room to another — but the graph treats them as undirected when computing layout and depth, so the direction is purely a semantic hint for you.

1. 1

   Hover a node to reveal handles

   Move your cursor over any room node. Small circular handle dots appear on the left and right edges of the card — these are the connection anchors.
2. 2

   Drag from a handle to another node

   Click and drag from a handle. A line follows your cursor. Release on top of another room node to start creating a connection between those two rooms.
3. 3

   Fill in the popover

   A small popover appears asking for:

   • Relation label (required) — a short phrase describing how the rooms relate, e.g. spawned from, reference material, contradicts, follow-up.
   • Personal note (optional) — a private note to yourself about why you made this connection. Only you can see it.
4. 4

   Press Enter or click Create

   The connection is saved immediately and the edge appears on the canvas. Press Escape or click Cancel to abort without saving.

If a room has faded due to inactivity but you want to keep it visually prominent, you can pin it. Pinned rooms always display at full opacity regardless of when you last visited.

• A 📌 pin button appears on any node that is either already pinned or has started to fade (opacity below 100%).
• Click the pin button on the node. The button turns amber when active. Click it again to unpin and restore time-decay behaviour.
• Pinning is stored on the connectionbetween you and that room, not on the room itself — so your pin does not affect anyone else's view.

Your room graph is automatically passed to Sage (the AI assistant embedded in each room) as additional context. Sage doesn't just look inside the room you're in — it walks the connection graph outward, hop by hop, gathering knowledge from adjacent rooms before answering you.

• In your Homeroom, Sage receives up to three hops of your graph — your full knowledge neighbourhood — labelled [Your Room Graph]. Ask things like "What do my travel rooms have in common?" or "Which albums mention the same people?"
• In any other room, Sage receives up to two hops from that room — labelled [Adjacent Rooms]. This lets it reference nearby rooms without overwhelming the context window.
• Edge labels are included in the context Sage receives, so it understands howrooms relate — not just that they do. A connection labelled “contradicts” tells Sage something very different from one labelled “supports”.
• The graph context is injected at the lowest priority behind the room's own knowledge, so it never crowds out your primary content.

• Label edges specifically.Labels like "related" become noise quickly. Prefer directional verbs: informed by, led to, contradicts findings in, background reading for.
• Use depth 1 for focus. When you want to see only what matters right now, set depth to 1. It removes distracting second-degree rooms.
• Navigate by clicking, not searching. Single-click a node to pivot the map around it. This is faster than looking up rooms in the sidebar when you know the topic neighbourhood you want to explore.
• Pin sparingly. Reserve pins for rooms you actively return to weekly. Fading is a useful signal — if a room is always fully opaque, you lose the ambient reminder of which rooms need revisiting.
• The graph persists your session. If you navigate away and come back, the map remembers your last focal room and breadcrumb trail for the duration of your browser session.