How falkordb/falkordb-browser works
FalkorDB Browser is a web UI for connecting to FalkorDB, querying and exploring graphs, and administering graph data and server access. The main workflow is: a user connects to a database, writes Cypher, submits it through the query API, and explores results in the graph canvas or table. Separate branches cover graph management and imports, optional AI assistance, and administration. The README documents these product capabilities; source excerpts are partial, so the graph avoids asserting unshown internal routing details.
Main entry points: run-query.ts Query execution · EditorComponent.tsx Cypher editor · route.ts CSV import API · page.tsx Settings
Components 25
Connection and access
- Connections
app/components/ConnectionManager.tsx - Session and auth
app/api/auth/[...nextauth]/options.ts - Connection API
app/api/connections/route.ts
Query and exploration
- Cypher editor
app/components/EditorComponent.tsx - Query execution
app/api/run-query.ts - Graph canvas
app/graph/GraphView.tsx - Table view
app/graph/TableView.tsx - Query history
app/graph/QueryHistoryPanel.tsx - Plans and metadata
app/graph/MetadataView.tsx
Graph management
- Graph operations
app/api/graph/[graph]/route.ts - Graph management UI
app/components/CreateGraph.tsx - Element editing API
app/api/graph/[graph]/[element]/route.ts - CSV import UI
app/components/graph/UploadGraph.tsx - CSV import API
app/api/graph/[graph]/load-csv/route.ts - Temporary CSV storage
app/lib/csv-storage.ts
AI assistance
- AI chat and tools
app/graph/Chat.tsx - AI chat API
app/api/chat/route.tsx - AI model discovery
app/api/chat/models/route.ts
Administration
- Settings
app/settings/page.tsx - Users and roles API
app/api/user/route.ts - Access tokens
app/settings/tokens/PersonalAccessTokens.tsx - UDF management
app/udf/page.tsx - UDF API
app/api/udf/route.ts
Other components
- User
- FalkorDB
Connections 26
- User → Connections: connects to
README.md - Connections → Connection API: manages connections
app/components/ConnectionManager.tsx - Connection API → Session and auth: uses session
app/api/connections/route.ts - User → Cypher editor: writes Cypher
README.md - Cypher editor → Query execution: submits query
README.md - Query execution → FalkorDB: runs Cypher
README.md - Query execution → Graph canvas: returns results
README.md - Query execution → Table view: returns results
README.md - Cypher editor → Query history: reviews history
README.md - Query execution → Plans and metadata: provides plan output
README.md - User → Graph canvas: explores and edits
README.md - Graph canvas → Element editing API: edits elements
README.md - User → Graph management UI: manages graphs
README.md - Graph management UI → Graph operations: creates and manages
- User → CSV import UI: imports CSV
README.md - CSV import UI → CSV import API: uploads data
- CSV import API → Temporary CSV storage: stores temporary CSV
- CSV import API → FalkorDB: loads graph data
README.md - User → AI chat and tools: requests assistance
README.md - AI chat and tools → AI chat API: sends prompts
- AI chat API → AI model discovery: uses model options
- User → Settings: administers access
README.md - Settings → Users and roles API: manages users
- Settings → Access tokens: manages tokens
README.md - User → UDF management: manages functions
- UDF management → UDF API: manages functions