Node Types¶

Graph Core supports multiple node types for organizing different kinds of information.

Available Types¶

Every type is created in the current workspace; see Workspaces.

Type Details¶

Task¶

Tasks represent actionable items with completion tracking.

Fields:

• Title, Notes, Tags
• Due date, Start date, End date
• Importance (1-5)
• Completed status

Special Behaviors:

• Shows checkbox in Cards, Table, Detail Panel, and Tooltips
• Auto-sets start_date to today when created
• Auto-sets end_date when marked complete
• Appears in Tasks view grouped by due date
• Shows urgency indicators based on due date proximity
• Timeline view renders tasks as date-range bars

Project¶

Projects are containers for organizing related work.

Fields:

• Title, Notes, Tags
• Start date, End date
• Importance
• Completed status

Special Behaviors:

• Shows completion checkbox (like tasks)
• Auto-sets start_date to today when created
• Timeline view renders children within project bar span
• Can have custom colors that inherit to children
• Shows progress based on child task completion

Note¶

Notes are general-purpose text containers.

Fields:

• Title, Notes (markdown), Tags
• Importance

Special Behaviors:

• No completion checkbox
• Full-text search includes content
• Markdown rendering in detail panel
• Notes field uses rich text editor

Person¶

Persons represent contacts and people.

Fields:

• Title (name), Notes
• Email, Phone
• Organization, Role
• Website
• Color (auto-assigned or custom)

Special Behaviors:

• Created in the current workspace, like any other node
• Can be @mentioned in the notes of any node in the same workspace via the @ key
• Shows in People view with organization grouping
• Unique color auto-assigned based on node ID
• Color inheritance: own color > parent org color > linked org color
• Graph view renders as circular badge with initials (not rectangular card)
• No completion checkbox in tooltips
• Person-specific form layout in detail panel
• Mini-avatar badges in child lists

Organization¶

Organizations group related persons.

Fields:

• Title (company name), Notes
• Color

Special Behaviors:

• Created in the current workspace, like any other node
• Groups persons in People view
• Shows members count and linked persons
• Members section displays persons linked to organization
• Can be created on-demand when linking persons
• Organization-specific form layout in detail panel

Event¶

Events represent time-based occurrences.

Fields:

• Title, Notes
• Start date, End date
• Location

Special Behaviors:

• Timeline view renders events as date-range bars
• Events without end_date extend to current date
• Supports custom bar labels in timeline

Milestone¶

Milestones mark achievements or deadlines.

Fields:

• Title, Notes
• Due date
• Importance

Special Behaviors:

• Displayed as markers in Timeline view
• Shows urgency based on date proximity
• Standard icon and color display

Group¶

Groups are structural containers for organizing nodes.

Fields:

• Title, Notes, Tags

Special Behaviors:

• Timeline view renders as vertical bars spanning all child rows
• Used for hierarchical organization of content
• No special completion tracking

Topic¶

Topics represent discussion or knowledge areas.

Fields:

• Title, Notes, Tags

Special Behaviors:

• Standard display type
• Uses standard icon and color
• No special completion logic

Component¶

Components represent technical or modular elements.

Fields:

• Title, Notes, Tags

Special Behaviors:

• Standard display type
• Uses standard icon and color
• Useful for technical documentation

Tag¶

Tag nodes are the label nodes behind the tag system. They are ordinary nodes with type: 'tag', which is what lets a tag be renamed, linked and deleted through the same machinery as any other node.

Fields:

• Title, Notes

Special Behaviors:

• Hidden from node lists whenever a type filter is active, so tags do not appear alongside content nodes
• Reached through the sidebar rather than by browsing the hierarchy
• Selectable in every type picker, so an existing node can be converted to a tag
• Deleting one goes through the standard node deletion: it is undoable and lands in Trash

Common Fields¶

All node types support these fields:

Importance Levels¶

Color Coding¶

Each type has a distinct color scheme:

These are the type default backgrounds defined in src/utils/constants.js. A person is normally shown in a colour derived from its node ID instead, and any node can carry a custom colour that overrides its type default.

View-Specific Rendering¶

See Also¶

• Workspaces
• Views Guide
• Keyboard Shortcuts