Noureddine RAMDI / Mind-Map-Wizard: AI-powered mind maps with a custom SVG rendering engine

Created Mon, 04 May 2026 10:23:01 +0000 Modified Sat, 23 May 2026 20:41:27 +0000

linus-sch/Mind-Map-Wizard

Mind-Map-Wizard takes a different approach to AI-powered mind mapping by using a custom SVG rendering engine that transforms markdown outlines generated by a large language model into interactive mind maps entirely in the browser. This design avoids any third-party visualization libraries, which are common in similar tools, and emphasizes privacy by keeping all user data stored locally.

What Mind-Map-Wizard does and how it is built

At its core, Mind-Map-Wizard is a browser-based JavaScript application that generates mind maps from user prompts or uploaded files. Instead of relying on popular visualization frameworks like D3 or GoJS, it uses a custom SVG engine to render the mind maps. The AI component uses OpenRouter to access large language models under a Bring Your Own Key (BYOK) model, which means users provide their own API keys, keeping control over their data.

The generation pipeline starts with the AI producing a markdown-formatted hierarchical outline. This markdown strictly follows a system prompt that enforces a specific structure: concrete facts instead of generic labels, two to three depth levels, and consolidated enumerations. This structured output is then parsed and rendered as an interactive SVG mind map.

The mind maps support branch expansion and collapse, drag-and-drop reordering, and integration with web search summaries. Users can export their maps in multiple formats, all while the application stores data locally in the browser, prioritizing user privacy and avoiding server-side storage.

The stack is primarily client-side JavaScript with no backend dependencies. The SVG rendering is handcrafted, manipulating DOM SVG elements directly. OpenRouter acts as a bridge to LLM APIs, accessed via user-provided keys.

Technical strengths and design tradeoffs

The standout technical element is the custom SVG rendering engine. Most mind map tools opt for libraries to handle layout, zooming, panning, and interaction. Here, the codebase implements all these from scratch, which is both a strength and a maintenance tradeoff. It keeps dependencies minimal and gives full control over the rendering pipeline, but it also means more code to maintain and potentially less polish than battle-tested libraries.

The markdown-to-mindmap pipeline leverages prompt engineering to produce highly structured outputs, which is a clever way to bridge LLM text generation with graphical visualization. This approach reduces the complexity of parsing and rendering since the input follows a well-defined format.

The privacy model is worth noting. By storing all data locally in the browser and requiring users to bring their own API keys, Mind-Map-Wizard avoids common pitfalls around data leakage and server trust. This does mean the user must manage their API keys and that the app’s functionality depends on external LLM availability.

From a code quality perspective, the repository is well-organized for a client-side app. The absence of external dependencies reduces attack surface and complexity. However, the custom rendering engine might lack some features or optimizations found in larger libraries, which could impact scalability or user experience with very large mind maps.

Getting started with Mind-Map-Wizard

To try Mind-Map-Wizard locally, the README provides clear instructions:

# Clone the repository
 git clone https://github.com/linus-sch/Mind-Map-Wizard.git

# Change into the project directory
 cd Mind-Map-Wizard

# Start a local server (example with Python)
 python -m http.server 8000

# Open your browser at http://localhost:8000/index.html

This minimal setup means you can run the entire application client-side without any backend installs or heavy infrastructure.

Verdict

Mind-Map-Wizard is a thoughtful project that tackles AI-powered mind mapping with a fresh angle: a fully custom SVG renderer and a privacy-first approach. It’s a good fit for developers or power users looking to experiment with AI-generated structured visualization without relying on third-party services or libraries.

The tradeoff is clear: custom rendering means more maintenance and potentially missing some advanced interaction features common in mature visualization frameworks. Also, the reliance on a BYOK model for LLM access shifts some responsibility to the user.

Overall, if you want a light, dependency-free, client-side mind-mapping tool that integrates AI in a privacy-conscious way, Mind-Map-Wizard is worth exploring. It also offers insight into prompt engineering strategies for generating highly structured AI outputs tailored for visualization.


→ GitHub Repo: linus-sch/Mind-Map-Wizard ⭐ 290 · JavaScript