# MindBook

> MindBook is a free, browser-based mind mapping and linked knowledge base. It combines an XMind-style mind map canvas with a Notion-style knowledge layer, AI chat, and Markdown pages that link bidirectionally to mind map nodes.

MindBook helps students, researchers, writers, product managers, and engineers capture ideas quickly in a mind map, attach rich context via linked Markdown notes, and use AI to expand, summarize, and rewrite content. It runs in any modern browser, supports 12 languages, and works on laptop and tablet.

## TL;DR

- **Mind map editor:** React Flow canvas with `@antv/hierarchy` tree layouts, keyboard-driven editing, pan/zoom, focus mode, collapse/expand, search.
- **Knowledge layer:** first-class Markdown pages with WikiLinks (`[[Page]]`), embeds (`![[Page]]`), backlinks, tags, TOC, callouts, Mermaid diagrams, footnotes, templates, daily notes, bookmarks.
- **Knowledge graph:** Cytoscape.js visualization of page and node relationships; tag view.
- **AI:** Vercel AI SDK with streaming SSE responses; actions to summarize text into a map, expand branches, and rewrite notes. Structured map output is validated before being applied.
- **Search:** unified across mind map nodes, page content, tags, and knowledge sources.
- **Import / export:** Markdown outline → mind map; export to Markdown, JSON, SVG, PNG, PDF.
- **Auth:** Auth0 (with a dev-only dummy fallback); API routes verify tokens.
- **i18n:** 12 locales with test-enforced key parity (en, zh, ja, ko, es, fr, de, pt, ru, vi, th, id).
- **Reliability:** error boundary, toast notifications, offline indicator, autosave, command palette (`Cmd/Ctrl+K`).

## Use cases

- Capture and structure ideas in a fast, keyboard-driven mind map.
- Attach Markdown notes to nodes for richer context.
- Build a personal knowledge base with bidirectional links between pages and nodes.
- Summarize long text or documents into a navigable mind map with AI.
- Brainstorm with AI: expand branches and rewrite notes without losing your structure.
- Export maps for sharing (PNG, SVG, PDF) or further editing (Markdown, JSON).

## Tech stack

React 19, TypeScript, Vite 7, Zustand, React Flow, `@antv/hierarchy`, Cytoscape.js, Vercel AI SDK (`@ai-sdk/gateway`), Auth0, Neon serverless Postgres, Vitest, Lucide icons, `react-markdown` with `remark-gfm`.

## Links

- Website: https://mindbook.dev/
- Sitemap: https://mindbook.dev/sitemap.xml
- robots.txt: https://mindbook.dev/robots.txt
- Full LLM context: https://mindbook.dev/llms-full.txt
- Product spec: https://mindbook.dev/SPEC.md
- Architecture: https://mindbook.dev/ARCHITECTURE.md
- Roadmap: https://mindbook.dev/TODO.md

## Optional

MindBook is open to integration. AI chat requires an operator-provided AI Gateway key; all other mind map and knowledge features work standalone.