Knowledge Graph — Beatrice

🔗 What Are Relationships?

A relationship is a directed link between two nodes that captures how they connect.

Each relationship stores:

Source Node — the node where the relationship originates.
Target Node — the node it points to.
Type — a label describing the nature of the connection, each with its own color and icon.
Weight — a similarity score (0–100%) indicating connection strength.
Context — an optional note explaining why these nodes are connected.
Auto-Generated — whether the relationship was created by Beatrice (sparkle icon) or by you.

🌈 Color-Coded Relationship Types

Every relationship type has a unique color and icon, visible in the detail view and on the map.

Auto-Detected Relationships

🧠 Semantically Similar (Purple) — nodes with similar content or ideas, detected by on-device AI.
🕐 Temporal Context (Cyan) — notes created around the same time.
🏷️ Shared Tags (Orange) — nodes that share one or more tags.
🔗 Shared Source (Brown) — notes with a common origin.
💬 Citation (Indigo) — one node references or quotes another.

Manual Relationships

🔗 Related To (Blue) — a general connection between two nodes.
❌ Contradicts (Red) — conflicting information or viewpoints.
⬆️ Expands On (Green) — one node provides more detail on a topic.
📄 Summarizes (Teal) — a condensed version of another node.
⬅️ Prerequisite (Mint) — should be read first.
➡️ Follow-up (Pink) — should be read after.

🔧 Creating a Relationship

Link two nodes in a few taps.

1

Open a Node

Tap any node card to open its detail view.

2

Tap the Link Button

In the toolbar, tap the link.badge.plus icon to open the relationship picker.

3

Pick a Target Node

A searchable list shows all other nodes in your graph. Select the one you want to connect.

4

Choose a Relationship Type

Each type shows its icon, color, name, and a short description. Tap to select, then tap Add.

💡

Tip: Relationships are directed. “A expands on B” is different from “B expands on A.” Create links in both directions if the connection is bidirectional.

✏️ Editing Relationships

Change a relationship type at any time without deleting and recreating it.

Inline Type Change

In the Relationships section of a node detail view, tap the pencil circle icon next to any connection. A menu appears with all 11 relationship types. Select a new type and the badge updates instantly with the new color and icon.

Removing a Relationship

Tap the × button next to a connected node to delete that relationship. The connected node itself is not affected.

🗺️ Map View

Visualize your graph as a force-directed network.

Color-Coded Edges

Every connection line on the map is colored to match its relationship type. Purple lines mean semantic similarity, red means contradiction, green means expansion, and so on. This makes patterns instantly visible.

Edge Legend

The toolbar shows colored dots representing each active relationship type in your graph. Tap the legend to see a full breakdown with counts for each type.

Interacting with the Map

Drag nodes — reposition any node by dragging. The physics engine re-settles around it.
Tap a node — opens its detail inspector.
Re-layout — tap the scatter button to randomize positions and let the graph re-settle.
Isolated nodes — an orange badge shows how many nodes have no connections yet.

💡 Building a Strong Graph

Tips for making your knowledge graph more useful over time.

Use hub nodes — Create concept nodes as central hubs. Link many notes to a single concept (e.g., “SwiftUI”) to build a radial structure.
Be specific with types — “Expands On” and “Contradicts” give more signal than generic “Related To.”
Add context notes — A short note explaining why two nodes connect makes the graph more navigable later.
Let Synapse help — The Synapse Engine auto-discovers hidden connections, contradictions, and orphaned notes. See Synapse Engine.
Prune regularly — Remove relationships that no longer hold. A clean graph is a useful graph.