Mind Mapper

A minimal, fast, single-purpose mind mapping tool. Vanilla TypeScript + SVG, no framework, no backend.

Features

• Root node with unlimited children/grandchildren
• Add child (Tab), add sibling (Enter), delete (Delete/Backspace)
• Double-click (or F2) to edit a node's text inline
• Drag nodes to reposition, drag the background to pan, scroll/pinch or +/- to zoom
• Auto-saves to localStorage as you work
• Export the current map to a .json file, import it back later (or on another device)

Local development

Requires Node.js 18+.

npm install
npm run dev

This opens the app at http://localhost:5173 with hot reload.

Build

npm run build

Outputs a static site to dist/ — pure HTML/CSS/JS, deployable anywhere.

Deploying to GitHub Pages

This repo includes .github/workflows/deploy.yml, which builds and deploys automatically on every push to main.

One-time setup after pushing this repo to GitHub:

1. Go to your repo's Settings → Pages.
2. Under Build and deployment → Source, select GitHub Actions.
3. Push to main (or re-run the workflow from the Actions tab).
4. Your site will be live at https://<your-username>.github.io/<repo-name>/.

No further configuration needed — vite.config.ts uses a relative base path so it works under any repo subpath automatically.

Data & privacy

Everything lives in your browser's localStorage on the device you use it on — nothing is sent anywhere. Use Export periodically if you want a backup or want to move a map to another browser/device, then Import it there.