Detail Panel¶
The detail panel provides comprehensive editing and viewing capabilities for any selected node.
Opening the Panel¶
- Click any node to open its detail panel
- Press Enter with a node selected
- Double-click a node's title to open in edit mode
Panel Modes¶
Pinned Mode¶
Click the pin icon to keep the panel open when clicking elsewhere. Useful when editing while browsing.
Fullscreen Mode¶
Click the expand icon or press Escape to toggle fullscreen. Provides maximum editing space.
Narrow Window Behavior: On narrow screens (below the responsive threshold), opening the detail panel automatically enters fullscreen mode to provide adequate editing space.
Detached Window¶
The detached window hides the pin, fullscreen, detach and link-search controls. Each of them acts on the main window's layout or opens the spotlight, neither of which the detached window has, so they are absent rather than present and inert.
Open the detail panel in a separate window:
- Click the "Open in Window" button in the panel header (or use context menu > "Open in Window")
- A separate window opens with the node's detail view
- Changes sync between windows via BroadcastChannel
Detached window features:
- Independent window that can be moved to another monitor
- Real-time sync with the main window
- Detaching the same node again focuses the existing window instead of opening a second one
- Quitting the app closes detached windows
- URL format:
?detached={nodeId}
Wrap With Parent¶
Creates a new item and moves the current one under it. The panel asks for the new item's title in an in-app dialog.
Native browser dialogs are not used anywhere in the app: Electron does not implement window.prompt, so it returns nothing without showing anything, and a feature built on it fails silently. The dialog is rendered once at the app root and shared through composables/usePrompt.js, so any component can ask for a value without adding one of its own.
Sections¶
The detail panel contains collapsible sections:
Notes Section¶
The notes section supports full Markdown editing.
View Modes:
| Mode | Description |
|---|---|
| Edit | Raw Markdown editor with syntax highlighting |
| Preview | Rendered Markdown output |
| Split | Side-by-side edit and preview; drag the divider to change the ratio, double-click it to reset |
Features:
- Markdown syntax highlighting
- External links open in browser
- Code blocks with syntax highlighting
- Tables and lists support
Lists and Enter:
Pressing Enter inside a list or blockquote continues it with the next marker, renumbering ordered lists as it goes. Lists are kept tight: Enter never inserts a blank line between items, whether or not the list already contains one. Pressing Enter on an empty list item ends the list and removes the marker.
Mentions¶
Type @ in the notes editor (Edit or Split mode) to mention and link to person nodes:
- Type
@followed by a name (e.g.,@John) - A dropdown appears with matching persons (up to 10 results)
- Use arrow keys to navigate, Enter or Tab to select — or click a suggestion
- The mention is inserted and a link to that person is created on the current node
Mention format: @[Person Name](person:123)
In Preview and Split mode the mention renders as a @Name chip rather than raw Markdown.
Keyboard navigation:
| Key | Action |
|---|---|
Arrow Down |
Next suggestion |
Arrow Up |
Previous suggestion |
Enter / Tab |
Insert selected mention |
Escape |
Close dropdown |
While the dropdown is open these keys belong to it, so Enter inserts a mention instead of a newline. When it is closed they behave normally.
Details:
- The person list is scoped to the current workspace and re-loads when you switch workspaces
- Mentions must follow a space, newline, or opening parenthesis; maximum query length is 30 characters
- An already-inserted mention does not re-open the dropdown when the cursor passes over it
- Moving the cursor out of the query, or leaving the editor, dismisses the dropdown
- Linked persons appear in the Linked Items section immediately after insertion
Sensitive Notes:
Toggle the "sensitive" flag to blur note content when not editing. Useful for private information.
Children Section¶
Displays and manages child nodes.
Features:
- Hierarchical child list
- Toggle completion status for tasks
- Add new child nodes
- Search within children
- Show/hide linked nodes (non-hierarchical relationships)
Table Section¶
Attach a spreadsheet to any node.
Features:
- Create and delete tables
- Add, remove, and rename columns
- Edit cell values directly
- Cell color formatting (colorblind-friendly palette)
- Copy, cut, and paste operations
- Multi-cell selection: drag across cells, or click a column header to take the whole column
- Columns share the available width equally, so the table always spans the panel; in fullscreen and detached mode the table section takes the full window width while Children and Metadata share a row
Formulas:
Cells support formulas for computed values. Enter a formula by starting with =:
- Formulas are stored separately from display values
- The cell shows the computed result while displaying the formula when editing
- Formula syntax follows standard spreadsheet conventions
Selection indicator:
A selected range is filled with the accent tint and outlined with a solid accent border drawn around the perimeter of the range, not around each cell in it. The fill alone is not a sufficient indicator: the grid is painted on a pure black background where the accent tint at its normal opacity is indistinguishable from the row hover colour.
Clicking a single cell opens its editor rather than marking a selection, so the editor's own focus ring is the indicator in that case.
Editing a cell:
Clicking a cell opens its editor. While the editor is open every keystroke belongs to the editor: characters are typed, Backspace and Delete remove characters, and Cmd/Ctrl + C/V/X operate on the text inside the cell. Enter commits the value and moves to the cell below. None of the table-level shortcuts below, and none of the application-wide shortcuts, fire while a cell editor is open.
The table also keeps the application-wide shortcuts from firing whenever the grid has focus, including after an edit is committed and focus returns to a cell. Enter, Space and n would otherwise navigate into the selected node, toggle the detail panel, or open the new-node dialog while the user is working in the table.
Table-level shortcuts (no cell editor open — select a range by dragging across cells or by clicking a column header):
| Key | Action |
|---|---|
Delete / Backspace |
Clear the selected cells |
| Any character | Type the same value into every selected cell |
Cmd/Ctrl + C |
Copy selection |
Cmd/Ctrl + V |
Paste |
Cmd/Ctrl + X |
Cut selection |
Cmd/Ctrl + B / Cmd/Ctrl + I |
Bold / italic the selection |
Escape |
Close the open menu, or clear the selection |
Editor stability:
Saving a cell writes to the database asynchronously and updates the local cell list, which re-renders the grid. Rows carry a stable identity so those re-renders update the existing rows in place instead of recreating them, and selection highlighting refreshes cells rather than redrawing rows. Both are required so that a save landing while the user is typing in another cell does not destroy that open editor and discard the text.
Metadata Section¶
Displays and edits all node properties in a grid layout.
Editable Fields:
- Title
- Type
- Due date, Start date, End date
- Importance level
- Location
- Email, Phone (for Person nodes)
- Organization, Role (for Person nodes)
- Website
- Color
Organization Autocomplete (Person nodes):
When editing a Person node, the organization field provides autocomplete:
- Type to search existing organizations in the workspace
- Arrow keys navigate the dropdown; Enter selects
- If no match exists, press Enter to create a new organization
- Multiple organizations can be linked to a person
- Click the X on an organization tag to unlink it
Organizations are displayed as tags showing the full hierarchy path (e.g., "Company > Department > Team").
Linked Items Section¶
Shows non-hierarchical relationships.
Features:
- View all nodes linked to the current node
- Create new links via search
- Remove existing links
- Navigate to linked nodes
Tags Section¶
Manage node tags for categorization.
Features:
- Add tags with autocomplete
- Remove existing tags
- Search by tag using
#tagnamein spotlight search
Color Picker¶
Click the color swatch to open the color picker.
Options:
- Visual color selector
- Hex value input
- Clear to remove custom color
Color Inheritance:
Nodes can inherit colors from their parent. When a node has no custom color set:
- Uses own color if set
- Falls back to parent's color
- Falls back to type default color