Turn your Obsidian vault into an interactive solar system.
Your folders become planets. Your notes become territories on those planets.
Navigate your knowledge like exploring space.
Mind Map Planet is an Electron desktop application that reads your Obsidian vault and visualizes its entire folder/note structure as a solar system.
In most note-taking apps, your files are buried in an endless tree. Mind Map Planet replaces that with a spatial, planet-based metaphor:
| Vault Structure | Visual Representation |
|---|---|
| Top-level folders | Planets orbiting in a solar system |
| Sub-folders & notes inside a folder | Territories on the planet's surface (Voronoi cells) |
| Deeper nesting | Drill-down into any territory to reveal its own subdivisions |
Click a planet → land on its surface → explore its Voronoi regions → click any note to open it directly in Obsidian.
Each planet represents a top-level folder. Planet size reflects the number of notes inside.
Beautiful constellation and space backgrounds to immerse yourself.
Select and interact with planets instantly.
Seamlessly navigate your note universe.
Easily switch between different Obsidian vaults with a modern interface.
Create new planets (folders) or notes and choose where they belong — all without leaving the app.
Customize each planet's look and style to personalize your solar system.
Configure your language, background theme, and vault preferences easily.
An in-app guide walks you through every feature, including detailed keyboard shortcuts.
- 🪐 Solar System Overview — Top-level folders rendered as glowing, animated planets in space.
- 🌍 Planet Surface View — Drill into any planet to see its contents as Voronoi-subdivided territories.
- ⚡ Instant Vault Scanning — Point to any Obsidian vault; the app recursively scans all
.mdfiles and folders. - 🔗 One-click Obsidian Integration — Click any note to open it directly in Obsidian via the
obsidian://URI. - ✏️ Quick Note & Planet Creation — Create new notes and planets from inside the application.
- 🎨 Appearance Customization — Change background themes and individual planet appearances.
- 🗺️ Interactive Navigation — Use breadcrumb navigation or drag & drop tools to organize your vault visually.
- 🌐 i18n Support — Multi-language UI support.
- 💾 Persistent Settings — Vault path and preferences are safely saved using
electron-store. - ⌨️ Keyboard Shortcuts — Navigate, search, and manage settings efficiently using built-in hotkeys.
- Node.js v18+ (LTS recommended)
- npm v9+ (or yarn / pnpm)
You can verify your Node.js and npm versions by running:
node -v # Should be v18.0.0 or higher
npm -v # Should be v9.0.0 or higher-
Clone the repository:
git clone https://github.com/carus10/Mind-Map-Planet-.git cd Mind-Map-Planet- -
Install dependencies:
npm install
To start the application in development mode with hot-module replacement (HMR), run:
npm run devCode changes will be reflected immediately in the running app.
To build the application for production, you can use the following commands:
# Build the application only
npm run build
# Build the application AND generate a Windows installer (.exe)
npm run dist:win
# Build the application AND generate platform-specific installers based on your OS if configured
npm run distThe compiled binaries and installers will be generated in the release/ directory based on the electron-builder configuration in package.json.
# Run all tests
npm test
# Run tests in watch mode
npm run test:watch| Layer | Technology | Purpose |
|---|---|---|
| Runtime | Electron 31 | Cross-platform desktop shell |
| Bundler | electron-vite 2 | Electron + Vite integration |
| UI | React 18 | Component-based user interface |
| Language | TypeScript 5.5 | Type-safe development |
| State | Zustand 4 | Lightweight global state management |
| Geo Rendering | D3-geo, D3-delaunay, D3-polygon | Geographic projections, Voronoi tessellation |
| Storage | electron-store | Persistent app settings |
Contributions are welcome! Here's how you can help:
- Fork this repository.
- Create a feature branch:
git checkout -b feature/amazing-feature. - Commit your changes:
git commit -m "feat: add amazing feature". - Push to the branch:
git push origin feature/amazing-feature. - Open a Pull Request.
This project is licensed under the MIT License. See the LICENSE file for details.
Mind Map Planet — Explore your knowledge like a universe. 🪐
Built by @carus10 Contact: taskancihan78@gmail.com
⭐ Star this repo if you find it useful!