Architecture

Frontend Stack

• Next.js (App Router)
• React + TypeScript
• React Three Fiber + Three.js (3D)
• TailwindCSS + shadcn/ui

Key Components

• GraphVisualizer: 3D rendering, bloom, search highlighting, community isolator
• CorpusPanel: uploads, indexing, logs, archives
• ChatPanel: GraphRAG-backed chat with streamed steps, highlights
• Inspector: selection details, strongest relationships, community hierarchy

Backend Integration

• Next.js API routes under app/api/
• GraphRAG CLI invoked for indexing and query
• Local file storage for corpus, outputs, archives
• SSE streams for progress and chat

Data Flow

1. Upload PDFs → auto .txt extraction
2. Run graphrag index → JSONs in output/
3. Load graph JSONs → force layout → 3D render
4. Optional graphrag query for chat → highlight entities