How ethanramli/boardtutor works
Board Tutor is a desktop whiteboard paired with a terminal for Claude Code. The student opens and edits boards in the Excalidraw canvas; the app saves them locally and lets Claude inspect or modify the open board through an MCP server. The terminal runs a local shell where Claude Code can be started. The map includes board management and workspace setup documented in the README. Edges reflect shown calls or README statements; unsampled implementation details are not expanded.
Main entry points: main.tsx Desktop App · board_tools.rs Local MCP Server · Terminal.tsx Terminal Pane · Boards.tsx Boards Menu
Components 14
Whiteboard
- Desktop App
src/main.tsx - Excalidraw Canvas
- Board Serialization
src/board.ts
Boards and Workspace
- Boards Menu
src/Boards.tsx - Board Path Logic
src/tree.ts - Board and Image Storage
src-tauri/src/main.rs - Tutor Workspace Setup
src-tauri/src/main.rs
Claude Board Tools
- Local MCP Server
src-tauri/src/board_tools.rs - Tool Request Bridge
src/main.tsx - Board Tool Logic
src/boardTools.ts
Terminal
- Terminal Pane
src/Terminal.tsx - Shell Session
src-tauri/src/terminal.rs
Other components
- Student
- Claude Code
Connections 16
- Student → Desktop App: uses
README.md - Desktop App → Excalidraw Canvas: renders
src/main.tsx - Desktop App → Board Serialization: loads and saves
src/main.tsx - Desktop App → Boards Menu: renders
src/main.tsx - Boards Menu → Board Path Logic: uses
src/Boards.tsx - Desktop App → Board and Image Storage: invokes board commands
src/main.tsx - Desktop App → Tutor Workspace Setup: starts setup
README.md - Desktop App → Local MCP Server: starts server
- Claude Code → Local MCP Server: calls tools
src-tauri/src/board_tools.rs - Local MCP Server → Tool Request Bridge: dispatches request
src-tauri/src/board_tools.rs - Tool Request Bridge → Board Tool Logic: runs board actions
src/main.tsx - Board Tool Logic → Excalidraw Canvas: updates scene
src/boardTools.ts - Tool Request Bridge → Local MCP Server: returns result
src/main.tsx - Desktop App → Terminal Pane: opens terminal
src/main.tsx - Terminal Pane → Shell Session: starts and controls
src/Terminal.tsx - Shell Session → Terminal Pane: emits output
src-tauri/src/terminal.rs