MindMapper is an open-source, local-first visual thinking and concept mapping engine. Engineered with HTML5 Canvas, superellipse squircle mathematics, dynamic curved synaptic Bezier routing with obstacle avoidance, and command-pattern history management under Apache 2.0.
Squircle Math
Superellipse continuous curvature with sub-ms point containment
Synaptic Routing
Dynamic Bezier curves with obstacle avoidance & directional arrowheads
100% Local-First
Zero telemetry, offline browser storage, and 2x Retina PNG export
Key Pain Point: Dual-Coding Acceleration: Pairing spatial visual geometry with semantic labels doubles concept retention and reduces mental fatigue.
Engineered MindMapper as a high-performance local-first platform featuring superellipse squircle nodes ((x/a)^n + (y/b)^n = 1), organic synaptic Bezier connectors with collision avoidance and dynamic tangents, freehand pen sketching, command-based atomic undo/redo, zero-telemetry browser persistence, and 2x Retina PNG export.
Implemented parametric superellipse squircle rendering using 64-step angular segment interpolation.
Derived instantaneous curve tangents (t=0 and t=1) to ensure directional arrowheads align seamlessly at node boundaries.
Engineered smart obstacle avoidance algorithms that detect line-node bounding box collisions and inject evasion waypoints.
This case study examines the architecture of MindMapper, an open-source visual thinking and mind mapping platform engineered by Epheos Tech. By combining hardware-accelerated squircle mathematics, dynamic curved synaptic Bezier routing, command-pattern undo/redo timelines, and sovereign local-first storage under Apache 2.0, MindMapper delivers distraction-free conceptual clarity with zero cloud lock-in.
Our research revealed critical insights that informed our strategy and implementation.
Implemented parametric superellipse squircle rendering using 64-step angular segment interpolation.
Derived instantaneous curve tangents (t=0 and t=1) to ensure directional arrowheads align seamlessly at node boundaries.
Engineered smart obstacle avoidance algorithms that detect line-node bounding box collisions and inject evasion waypoints.
Built a robust Command pattern stack (Create, Update, Drag, Delete, Clear) supporting atomic multi-node operations.
Integrated local-first storage adapter with 1.5-second debounce auto-saving for smooth 60fps interaction during rapid drawing.
Released standalone codebase as an independent, fully tested open-source repository under Apache 2.0.
MindMapper demonstrates how modern web technologies can deliver desktop-class canvas performance while respecting user privacy. By prioritizing local-first data ownership, mathematically rigorous geometry, and zero-barrier access, MindMapper establishes a new benchmark for visual thinking tools.
A clear roadmap for implementing these strategies and next steps.
Formulate parametric superellipse squircle formulas for hardware-accelerated canvas 2D rendering.
Implement curved Bezier synaptic routing with dynamic tangent angle calculation.
Develop collision-detection routing algorithms for automatic obstacle avoidance.
Design command-pattern undo/redo history architecture with bounded memory management.
Build zero-telemetry local storage adapter with debounce auto-saving.
Create high-DPI 2x Retina PNG exporter with transparent, light, and dark background modes.
Implement responsive navigation toolbar, contextual bottom inspector, and floating inline editors.
Package clean starter templates (System Architecture, Brainstorming, Welcome Guide).
Develop comprehensive Vitest unit test suite covering math, routing, history, and storage.
Containerize with multi-stage Dockerfile and release open-source under Apache 2.0.
Get expert guidance implementing these strategies
Let's work together to achieve remarkable results for your organization.
