Link Search Menu Expand Document
Bodhi Map

Getting Started

Bodhi Map is a static, offline web app with zero runtime dependencies. There is nothing to install to use it.

Just run it

Clone (or download) the repo and open the app:

git clone https://github.com/AI-First-Community/Bodhi.git
cd Bodhi
open index.html        # macOS — opens the landing page; click "Enter the map"
# or open app.html directly for the interactive graph

That’s it. No server, no internet connection, no build step. The graph, fonts, and libraries are all vendored locally so it works over file://.

Two entry points: index.html is the landing/intro page (the site front door); app.html is the interactive map itself. The landing’s Enter the map button opens the app, and the app’s brand link (top-left) returns to the landing.

First five minutes

  1. Look around. Nodes are concepts, color-coded by cluster; edges are typed relationships. Drag to pan, scroll to zoom.
  2. Click a node to open its detail panel — plain-language summary, deeper detail, when to use, a code snippet, its connections, and paper references.
  3. Search with f — type “attn” → Attention. Use ↑/↓/Enter to navigate results.
  4. Filter by level (1–5) or by cluster (click a swatch in the legend dock) to pare the map down to what you care about.
  5. Try the flows — the 🧭 Which technique? wizard recommends an adaptation strategy; ▶ Guided Path walks a real workflow end to end.

See the User Guide for everything in depth.

If you want to build / contribute

npm is used only as a task runner — there are still no dependencies to install.

npm run build      # rebuild js/data.js from knowledge/ and validate
npm run validate   # integrity check only (0 errors required)
npm start          # open index.html
npm run export     # regenerate the knowledge/ bundle from js/data.js (rarely needed)

Requirements: Node.js (any recent LTS) for the build/validate scripts. The app itself needs only a browser.

Next steps: