Skip to content

About

🧠 AI-powered mind mapping desktop app for macOS β€” Gemini, ChatGPT & Claude support

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🧠 MindMap Tool

A beautiful, AI-powered mind mapping desktop app for macOS β€” built with Electron, React, and ReactFlow.

License Platform Electron React

⬇️ Download

Download for macOS

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.app

This 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.


✨ Features

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

πŸ“Έ Screenshots

Coming soon β€” run the app to see the beautiful dark-themed UI with glassmorphism effects.


πŸš€ Quick Start

Prerequisites

  • Node.js v18 or later
  • macOS 12 or later (for Electron desktop mode)

Install & Run

# 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:dev

Open http://localhost:5173 in your browser, or the Electron window will launch automatically.


🎯 How to Use

Getting Started

  1. Create a map β€” A default "My First Mind Map" is created on launch
  2. Add nodes β€” Click the + button on any node, or press Tab
  3. Edit labels β€” Double-click any node to rename it
  4. Organize β€” Drag nodes to rearrange, use color picker to categorize

AI Suggestions

  1. Open the sidebar (☰ button)
  2. Select your AI provider: Gemini, ChatGPT, or Claude
  3. Enter your API key
  4. Click ✨ on any node to generate 5 creative branch ideas
  5. Click a suggestion to add it as a child branch

Notes

  • Click the πŸ“„ icon on any node to expand the notes section
  • Notes are saved with your map and included in exports

Views

  • πŸ—ΊοΈ Mind Map β€” Visual canvas with drag-and-drop (default)
  • πŸ“‹ List View β€” Hierarchical outline with expand/collapse

Export Options

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

πŸ› οΈ Tech Stack

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

πŸ“ Project Structure

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

⌨️ Keyboard Shortcuts

Shortcut Action
Tab Add child to selected node
Delete / Backspace Delete selected node
⌘Z Undo
βŒ˜β‡§Z Redo
Double-click node Edit label

πŸ”‘ AI API Keys

Get your free API keys:

Keys are stored locally in your browser's localStorage β€” never sent to any server except the respective AI provider.


πŸ“¦ Build & Package

# Production build
npm run build

# Package as .dmg (macOS)
npm run electron:build

πŸ“„ License

MIT License β€” free for personal and commercial use.


Made with ❀️ for thinkers, researchers, and idea explorers.


⬇️ Download & Install

Download for macOS

Installation steps:

  1. Download the .dmg file (90 MB)
  2. Open the DMG and drag MindMap Tool into Applications
  3. ⚠️ Open Terminal and run:
    sudo xattr -cr /Applications/MindMap\ Tool.app
    (Enter your Mac password when prompted)
  4. 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.

About

🧠 AI-powered mind mapping desktop app for macOS β€” Gemini, ChatGPT & Claude support

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages