A beautiful, AI-powered mind mapping desktop app for macOS β built with Electron, React, and ReactFlow.
90 MB Β· macOS 12+ Β· Apple Silicon only (M1, M2, M3, M4)
Important
After installing, you MUST run this command in Terminal to open the app:
sudo xattr -cr /Applications/MindMap\ Tool.appThis is required because the app is not notarized with Apple. Without this step, macOS will say the app "is damaged". It's not damaged β this command just removes the quarantine flag.
| Feature | Description |
|---|---|
| πΊοΈ Interactive Mind Map | Drag, pan, zoom β create unlimited branches with ReactFlow canvas |
| π List / Outline View | Toggle between mind map and hierarchical list view |
| π€ AI Suggestions | Generate branch ideas with Gemini, ChatGPT, or Claude β click β¨ on any node |
| π Node Notes | Add detailed notes to any node with expandable textarea |
| π File Attachments | Attach images and documents to nodes |
| π¨ 7 Color Themes | Color-code branches for visual organization |
| π Dark & Light Mode | Premium glassmorphism design with smooth transitions |
| πΎ Auto-Save | Maps auto-save every 2 seconds |
| β©οΈ Undo/Redo | 50-step history with βZ / ββ§Z |
| π€ Multi-Format Export | PNG, JPEG, PDF, JSON, and Apple Notes |
| β¨οΈ Keyboard Shortcuts | Tab (add child), Delete, βZ/ββ§Z |
Coming soon β run the app to see the beautiful dark-themed UI with glassmorphism effects.
- Node.js v18 or later
- macOS 12 or later (for Electron desktop mode)
# Clone the repo
git clone https://github.com/elavenile/mindmap-tool.git
cd mindmap-tool
# Install dependencies
npm install
# Run in browser (dev mode)
npm run dev
# Run as desktop app
npm run electron:devOpen http://localhost:5173 in your browser, or the Electron window will launch automatically.
- Create a map β A default "My First Mind Map" is created on launch
- Add nodes β Click the + button on any node, or press Tab
- Edit labels β Double-click any node to rename it
- Organize β Drag nodes to rearrange, use color picker to categorize
- Open the sidebar (β° button)
- Select your AI provider: Gemini, ChatGPT, or Claude
- Enter your API key
- Click β¨ on any node to generate 5 creative branch ideas
- Click a suggestion to add it as a child branch
- Click the π icon on any node to expand the notes section
- Notes are saved with your map and included in exports
- πΊοΈ Mind Map β Visual canvas with drag-and-drop (default)
- π List View β Hierarchical outline with expand/collapse
Click π€ in the toolbar to choose:
- PNG / JPEG β High-resolution image (2Γ retina)
- PDF β Formatted printable document
- JSON β Full data backup for import
- π Apple Notes β Send directly to Apple Notes
| Technology | Purpose |
|---|---|
| Electron | Desktop shell with macOS-native styling |
| React 18 | UI framework |
| ReactFlow | Interactive canvas for mind map |
| Zustand | Lightweight state management |
| Vite | Fast development & build |
| Google Gemini / OpenAI / Claude | AI-powered branch suggestions |
mindmap-tool/
βββ electron/
β βββ main.js # Electron main process
β βββ preload.js # Secure IPC bridge
βββ src/
β βββ App.jsx # Root component
β βββ index.css # Design system (1500+ lines)
β βββ main.jsx # React entry point
β βββ components/
β β βββ MindMap/
β β β βββ MindMapCanvas.jsx # ReactFlow canvas
β β β βββ MindMapNode.jsx # Custom node component
β β βββ ListView/
β β β βββ ListView.jsx # Hierarchical list view
β β βββ Sidebar/
β β β βββ Sidebar.jsx # Map manager + AI panel
β β βββ Toolbar/
β β βββ Toolbar.jsx # Actions + export menu
β βββ store/
β β βββ mindMapStore.js # Mind map state (Zustand)
β β βββ appStore.js # App settings (Zustand)
β βββ services/
β βββ aiService.js # Multi-provider AI API
βββ index.html
βββ package.json
βββ vite.config.js
| Shortcut | Action |
|---|---|
Tab |
Add child to selected node |
Delete / Backspace |
Delete selected node |
βZ |
Undo |
ββ§Z |
Redo |
| Double-click node | Edit label |
Get your free API keys:
- Gemini: aistudio.google.com
- ChatGPT: platform.openai.com
- Claude: console.anthropic.com
Keys are stored locally in your browser's localStorage β never sent to any server except the respective AI provider.
# Production build
npm run build
# Package as .dmg (macOS)
npm run electron:buildMIT License β free for personal and commercial use.
Made with β€οΈ for thinkers, researchers, and idea explorers.
Installation steps:
- Download the
.dmgfile (90 MB) - Open the DMG and drag MindMap Tool into Applications
β οΈ Open Terminal and run:(Enter your Mac password when prompted)sudo xattr -cr /Applications/MindMap\ Tool.app- Double-click MindMap Tool in Applications β enjoy! π§
Warning
If you skip step 3, macOS will show a "damaged and can't be opened" error. This is a standard macOS security measure for unsigned apps β the app is perfectly safe.