Skip to content

README.md

Latest commit

 

History

History
164 lines (121 loc) · 5.06 KB

README.md

File metadata and controls

164 lines (121 loc) · 5.06 KB
Raw

ZMind

ZMind Logo

A fast, beautiful, cross-platform mind-mapping tool

Release License Platform

中文文档 → | Download | Development

Features

Multiple Layout Modes

Mode Description
Mind Map Classic bidirectional mind map — children split left and right
Logic Map All children arranged to the right of the parent
Tree Indented outline tree
Org Chart Top-down organization chart
Timeline Horizontal timeline
Fishbone Cause-and-effect fishbone diagram

Rich Themes

  • Default — Dark nodes with white text
  • Fresh — Colorful gradient nodes
  • Mind Map (脑图) — XMind-style: transparent nodes with fusion underline, thick curved branches
  • Classic — Traditional bordered nodes
  • Minimal — Clean light nodes with subtle borders
  • Markmap — Underline-only lightweight style

Node Customization

  • Multiple shapes: rounded rect, rectangle, ellipse, pill, diamond, hexagon, parallelogram, no-border
  • Fill color, text color, border color, shadow — all individually configurable
  • Paste images from clipboard directly into nodes (hover to show delete button)
  • Resize node width by dragging left / right edges (no corner handles)
  • Image hover-delete button

Branch & Connection Options

  • Rainbow branches — first-level branches get distinct colors, propagated to all descendants
  • Child width alignment — equalize all sibling node widths automatically
  • Edge alignment — connect edges at top (fusion), center (default), or bottom (fusion) of nodes
  • Collapse icons — chevron arrow, circle (XMind-style white circle), or dot

Editing

  • Double-click any node to edit in-place; all text auto-selected on entry
  • Enter to confirm; Shift+Enter for newline; Escape to cancel
  • Outline view with full keyboard navigation (Enter = new sibling, Tab = new child)
  • Drag-to-reorder / drag-to-reparent in Outline view
  • Undo / Redo

Other

  • Presentation mode — step through nodes as full-screen slides
  • Collapse / expand any subtree
  • Import & export .xmind files
  • Multiple sheets per document
  • Fully local — no cloud, no account required

Download

Pre-built binaries are on the Releases page.

Platform File
macOS (Intel + Apple Silicon universal) .dmg
Windows x64 .msi installer or .exe setup

macOS note: If macOS blocks the app, right-click → Open, or run:

xattr -cr /Applications/ZMind.app

Development

Prerequisites

Setup & run

pnpm install
pnpm tauri dev        # hot-reload in Tauri window

Build for release

# Current platform
pnpm tauri build

# macOS Universal (Intel + Apple Silicon)
pnpm tauri build --target universal-apple-darwin

# macOS Intel
pnpm tauri build --target x86_64-apple-darwin

# macOS Apple Silicon
pnpm tauri build --target aarch64-apple-darwin

# Windows x64
pnpm tauri build --target x86_64-pc-windows-msvc

Artifacts land in src-tauri/target/<target>/release/bundle/.

Create a release

Push a version tag — GitHub Actions will build all platforms and create a draft release automatically:

git tag v1.0.0
git push origin v1.0.0

Directory structure

zmind/
├── src/                    # Next.js frontend (TypeScript + React)
│   ├── app/                # App Router pages & layout
│   ├── components/
│   │   ├── MindMap/        # Canvas, nodes, edges
│   │   ├── Outline/        # Outline view
│   │   ├── Sidebar/        # Style sidebar
│   │   └── Toolbar/        # Top toolbar
│   ├── lib/                # Core: layout engine, themes, types
│   └── store/              # Zustand state (document + UI)
├── src-tauri/              # Tauri Rust backend + icons
└── public/                 # Static web assets & icons

Tech Stack

Layer Technology
Desktop shell Tauri 2
Frontend framework Next.js 15 (App Router, Static Export)
UI library React 19 + TailwindCSS 4
Mind-map canvas React Flow v12
State management Zustand + Immer
Language TypeScript 5

License

MIT