Skip to content
Skills Library
Programming · Building & coding

mindnode-ui

/mindnode-ui

Build MindNode-inspired mind mapping interfaces — 8 node shapes, 27+ themes, layout algorithms (horizontal, vertical, radial with D3), keyboard shortcuts, focus mode, dual view. React + xyflow/react v12 + Zustand + Tailwind. Triggers on mind map, visual thinking tool, node-based diagram, brainstorm canvas, MindNode.

Licence
MIT
Last repository change
19.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
10
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 19.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Build MindNode-inspired mind mapping interfaces — 8 node shapes, 27+ themes, layout algorithms (horizontal, vertical, radial with D3), keyboard shortcuts, focus mode, dual view. React + xyflow/react v12 + Zustand + Tailwind. Triggers on mind map, visual thinking tool, node-based diagram, brainstorm canvas, MindNode.

Original author description

Build MindNode-inspired mind mapping interfaces — 8 node shapes, 27+ themes, layout algorithms (horizontal, vertical, radial with D3), keyboard shortcuts, focus mode, dual view. React + xyflow/react v12 + Zustand + Tailwind. Triggers on mind map, visual thinking tool, node-based diagram, brainstorm canvas, MindNode.

How it works

  1. Key Design Principles
  2. Quick Reference
  3. Reference Files
  4. Key Implementation Patterns
  5. Tech Stack Assumptions
Original SKILL.md headings · 126 lines, 716 words
SKILL.md preview
---
name: mindnode-ui
description: "Build MindNode-inspired mind mapping interfaces — 8 node shapes, 27+ themes, layout algorithms (horizontal, vertical, radial with D3), keyboard shortcuts, focus mode, dual view. React + xyflow/react v12 + Zustand + Tailwind. Triggers on mind map, visual thinking tool, node-based diagram, brainstorm canvas, MindNode."
---

# MindNode UI

Build mind mapping interfaces inspired by [MindNode](https://www.mindnode.com/) — the Apple-native visual thinking app by IdeasOnCanvas GmbH. This skill encodes MindNode's design system, interaction model, and layout algorithms, adapted for React + ReactFlow + Zustand + Tailwind CSS 3.

## Key Design Principles

- **Visual-first thinking** — spatial canvas for non-linear ideas, outline for linear structure
- **Apple-native aesthetic** — soft rounded elements, generous whitespace, purple accent (#6C63FF)
- **ADHD-friendly** — Focus mode isolates one subtree, Quick Entry captures ideas fast
- **Keyboard-driven** — Tab=child, Return=sibling, arrows=navigate, no mouse required

---

## Quick Reference

### Node Shapes (8)

| Shape | Key | Use Case |
|-------|-----|----------|
| Rounded | Default | General ideas |
| Rectangle | Structured | Facts, definitions |
| Pill | Stadium | Tags, labels |
| Cloud | Organic | Brainstorms |
| Line | Minimal | Subtitles |
| Embedded | Inset | References |
| Hexagon | Process | Decision points |
| Octagon | Warning | Critical items |

### Essential Keyboard Shortcuts

| Action | Mac | Description |
|--------|-----|-------------|
| New child | `Tab` | Add child to selected node |
| New sibling | `Return` | Add sibling after selected |
| New main | `Shift+Return` | Add root-level branch |
| Edit title | `Cmd+Return` | Enter contentEditable mode |
| Navigate | `Arrow keys` | Move between nodes |
| Fold/unfold | `Option+.` | Toggle subtree visibility |
| Cross-link | `Cmd+L` | Connect non-adjacent nodes |
| Mind map view | `Cmd+1` | Switch to canvas view |
| Outline view | `Cmd+2` | Switch to list view |
| Delete | `Backspace` | Remove node, re-parent children |

### Theme Types

| Type | Behavior | Example |
|------|----------|---------|
| Dynamic | Auto light/dark adaptation | Elegant, Fresh |
| Static | Fixed colors | Rainbow, Goth Pastel, Twilight |
| Personal | Extracted from current document | User-defined |

### Layout Directions

| Direction | Root Position | Tree Expands |
|-----------|---------------|-------------|
| Horizontal | Left | Rightward (default) |
| Vertical | Top | Downward |
| Compact | Center | Outward (dense) |
| Radial | Center | All directions (polar) |

---

## Reference Files

Load these on demand based on what aspect of MindNode UI is needed.

### Routing Table

| When working on... | Load |
|---------------------|------|
| Color palette, typography, visual language, Apple aesthetic | [references/design-system.md](references/design-system.md) |
| Node shapes, SVG paths, contentEditable, Node Well | [references/node-types.md](references/node-types.md) |
| Dynamic/static themes, per-level colors, theme gallery | [references/themes.md](references/themes.md) |
| Tree layout, D3 radial, auto-arrange, flexible positioning | [references/layout-algorithms.md](references/layout-algorithms.md) |
| Keyboard shortcuts, focus mode, drag, outline sync | [references/interaction-patterns.md](references/interaction-patterns.md) |
| Dual view (mind map + outline), canvas, connections, export | [references/canvas-and-views.md](references/canvas-and-views.md) |
| ReactFlow custom nodes/edges, Zustand store, performance | [references/reactflow-integration.md](references/reactflow-integration.md) |
| Porting to Project Pilot specifically | [references/project-pilot-porting.md](references/project-pilot-porting.md) |

---

## Key Implementation Patterns

### Node Well (Primary Creation UX)

The plus button appearing on hover/selection that creates a child node. This is MindNode's signature interaction — not a toolbar, not a menu, but a contextual affordance on each node.

→ See [references/node-types.md](references/node-types.md) for implementation details.

### D3 Radial Tree Layout

Compute tree positions with `d3.tree()`, then transform to polar coordinates:
```
x = radius × cos(angle − π/2)
y = radius × sin(angle − π/2)
```

→ See [references/layout-algorithms.md](references/layout-algorithms.md) for full algorithm with code.

### Per-Level Hierarchical Theming

Each theme defines colors per depth level: root (prominent), level 1 (branch colors, cycled from palette), level 2+ (progressively softer). Branch children inherit their parent's color family.

→ See [references/themes.md](references/themes.md) for theme data structures and CSS generation.

### Dual View Sync

Mind map and outline views share a single data model. Changes in either view propagate immediately. Selection state syncs bidirectionally.

→ See [references/canvas-and-views.md](references/canvas-and-views.md) for architecture and data model.

---

## Tech Stack Assumptions

This skill assumes:
- **React 18** with TypeScript
- **@xyflow/react v12** for the canvas (custom nodes, edges, handles)
- **Zustand** for state management (single store with slices)
- **Tailwind CSS 3** with CSS custom properties (`var(--color-*)`)
- **D3** (`d3-hierarchy`, `d3-shape`) for tree layout computation
- **No Framer Motion on ReactFlow nodes** — RF manages transforms, FM would override them

For Project Pilot–specific adaptation, see [references/project-pilot-porting.md](references/project-pilot-porting.md).
Files in this package (10)
  • README.md 1 KB
  • SKILL.md 5 KB
  • references/canvas-and-views.md 28 KB
  • references/design-system.md 14 KB
  • references/interaction-patterns.md 28 KB
  • references/layout-algorithms.md 16 KB
  • references/node-types.md 18 KB
  • references/project-pilot-porting.md 32 KB
  • references/reactflow-integration.md 30 KB
  • references/themes.md 17 KB

Versions

The database has no other skills named mindnode-ui.

Database snapshot: 13.11.2026 · package version eb0827b06077 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 95react-flow
    Expert guidance for React Flow (@xyflow/react): building interactive node-based graphs, custom nodes and edges, handles, state management, layouting, TypeScript patterns, performance optimization, accessibility, SSR, and theming. Use when writing React Flow code, creating custom…
  • 100react-flow-node-ts
    Create React Flow node components with TypeScript types, handles, and Zustand integration. Use when building custom nodes for React Flow canvas, creating visual workflow editors, or implementing node-based UI components.
  • 100react-flow-implementation
    Implements React Flow node-based UIs correctly using @xyflow/react. Use when building flow charts, diagrams, visual editors, or node-based applications with React. Covers nodes, edges, handles, custom components, state management, and viewport control.
  • 100react-flow-code-review
    Reviews React Flow code for anti-patterns, performance issues, and best practices. Use when reviewing code that uses @xyflow/react, checking for common mistakes, or optimizing node-based UI implementations.
  • 100react-flow-node-ts
    Create React Flow node components with TypeScript types, handles, and Zustand integration. Use when building custom nodes for React Flow canvas, creating visual workflow editors, or implementing no...
  • 100journey-map
    Loads full context for a React Flow (@xyflow/react) user journey mapping project. Use when working on, extending, debugging, or building features for the journey map tool. Triggers on: "journey map project", "open journey map", "work on journey map", "build user journey", "react…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.