Skip to content

thehighnotes/mindmap

Repository files navigation

Mindmap Brainstorm Tool

License Version Downloads Platform

A powerful, intuitive mindmap application for visual brainstorming and organizing ideas. Works both as a standalone Electron desktop app and as a web application.

Features

Core Features

  • Visual Brainstorming - Create interactive mind maps with unlimited nodes
  • Real-time Collaboration - Work together with team members in real-time
  • Smart Save - Automatic versioning and backup system
  • Multiple Export Formats - Export to PNG, JSON, or legacy formats
  • Keyboard Shortcuts - Fast navigation and editing with comprehensive shortcuts
  • Customizable Themes - Light/dark mode with customizable colors
  • Responsive Design - Works seamlessly on desktop and web
  • Offline First - Full functionality without internet connection

Advanced Features

  • Modern Interface - Clean, intuitive user interface
  • File Association - Open .mindmap and .mindmap2 files directly
  • Cross-platform - Native apps for Windows, macOS, and Linux
  • Import/Export - Support for various mindmap formats
  • Undo/Redo - Complete history management
  • Navigation - Easy navigation through complex mindmaps
  • Zoom Controls - Navigate large mindmaps with ease
  • Flexible Layout - Arrange nodes freely on canvas

Installation

Download Pre-built Binary

Download the latest release for your platform from the Releases page.

  • Windows: Download the .exe portable version or installer
  • macOS: Download the .dmg file
  • Linux: Download the .AppImage or .deb package

Build from Source

Prerequisites

  • Node.js 18 or higher
  • npm or yarn package manager
  • Git

Steps

# Clone the repository
git clone https://github.com/thehighnotes/mindmap.git
cd mindmap

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for your platform
npm run build

# Build for specific platforms
npm run dist:win    # Windows
npm run dist:mac    # macOS
npm run dist:linux  # Linux

Usage

Quick Start

  1. Launch the application
  2. Click "New Mindmap" or press Ctrl+N
  3. Double-click the central node to edit
  4. Press Tab to create child nodes
  5. Press Enter to create sibling nodes
  6. Drag nodes to reorganize your mindmap

Keyboard Shortcuts

Action Windows/Linux macOS
New Mindmap Ctrl+N Cmd+N
Open Ctrl+O Cmd+O
Save Ctrl+S Cmd+S
Export Ctrl+E Cmd+E
Undo Ctrl+Z Cmd+Z
Redo Ctrl+Y Cmd+Shift+Z
Delete Node Delete Delete
Edit Node F2 or Double-click F2 or Double-click
Add Child Tab Tab
Add Sibling Enter Enter
Navigate Arrow Keys Arrow Keys
Zoom In/Out Ctrl+Plus/Minus Cmd+Plus/Minus
Reset Zoom Ctrl+0 Cmd+0

Web Version

The application also works as a web app. Simply open index.html in a modern browser for full functionality without installation.

Project Structure

mindmap-electron/
├── electron/           # Electron main process files
│   ├── main.js        # Main process entry
│   ├── menu.js        # Application menu
│   └── preload.js     # Preload script
├── js/                # Application logic
│   ├── core.js        # Core mindmap functionality
│   ├── export.js      # Export functionality
│   ├── collaboration.js # Real-time collaboration
│   └── smart-save.js  # Version control system
├── css/               # Stylesheets
├── assets/            # Icons and resources
└── index.html         # Main application file

Configuration

Settings

The application stores preferences locally including:

  • Theme preferences
  • Auto-save settings
  • Export options
  • Collaboration preferences

File Formats

  • .mindmap2 - Modern JSON-based format with full feature support
  • .mindmap - Legacy format for backward compatibility
  • .png - Image export for sharing
  • .json - Raw data export

Development

Technologies Used

  • Electron - Cross-platform desktop framework
  • Vanilla JavaScript - Core application logic
  • CSS3 - Modern styling with animations
  • HTML5 - Semantic markup
  • Local Storage - Persistent settings
  • WebRTC - Real-time collaboration support

Contributing

Contributions are welcome! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Please read CONTRIBUTING.md for details on our code of conduct and development process.

Testing

# Run in development mode with debugging
npm run dev

Building for Production

Code Signing

The application uses SignPath for code signing on Windows. Releases are automatically signed through GitHub Actions.

Build Configuration

See package.json for detailed build configuration. The app supports:

  • Windows: Portable and NSIS installer
  • macOS: DMG package
  • Linux: AppImage and DEB packages

Support

Getting Help

Roadmap

Planned Features

  • Cloud sync (optional premium feature)
  • Mobile applications
  • Plugin system
  • AI-powered features
  • Template library
  • Presentation mode
  • Mind map animations
  • Voice input
  • Markdown support in nodes

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Author

Mark Wind

Releases

See the Releases page for version history.


Note: This is an open-source project. Feel free to use, modify, and distribute according to the MIT license.

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors