How trustgraph-ai/trustgraph-ui works
TrustGraph UX is a React portal and component ecosystem for interacting with TrustGraph knowledge services. Users enter through the portal, choose workflows such as ingestion, graph exploration, or RAG, and receive visualized data or streamed answers. The map includes shared state and connection layers, plus ontology/query tooling and domain plugins. Sampled source confirms selected call paths; other major portal capabilities are included from the README and file tree, with uncertain implementation links omitted.
Main entry points: App.tsx Portal shell · SocketProvider.tsx Socket provider · IngestPage.tsx Document ingestion · GraphView.tsx Graph exploration
Components 21
Portal workflows
- Portal shell
packages/portal/src/App.tsx - Document ingestion
packages/portal/src/pages/IngestPage.tsx
Knowledge exploration
- Graph exploration
packages/portal/src/pages/GraphView.tsx - Graph RAG
packages/trustkit/src/hooks/useGraphRag.ts - Document RAG
packages/trustkit/src/hooks/useDocumentRag.ts - Explainability views
packages/trustkit/src/components/explain - Query workbenches
packages/trustkit/src/components/common/QueryWorkbench.tsx
Shared runtime
- Workflow state
packages/trustgraph-react-state/src/state - Socket provider
packages/trustgraph-react-provider/src/SocketProvider.tsx - TrustGraph client
packages/trustgraph-client/src - Shared UI toolkit
packages/trustkit/src/components - Ingestion state hooks
packages/trustgraph-react-state/src/state/chunked-upload.ts - Graph query state
packages/trustgraph-react-state/src/state/graph-query.ts
Data and configuration
- Ontology management
packages/trustkit/src/components/ontology - Schema management
packages/trustkit/src/components/schema
Domain plugins
- Retail assistant
packages/plugin-retail-brand/src/hooks/useRetailOrchestrator.ts - Legal explorer
packages/plugin-law/src/LawExplorer.tsx - Innovation explorer
- Other domain explorers
packages
Other components
- User
- TrustGraph services
Connections 26
- User → Portal shell: uses portal
- Portal shell → Document ingestion: routes to
- Portal shell → Graph exploration: routes to
- Portal shell → Graph RAG: routes workflows
- Portal shell → Document RAG: routes workflows
- Portal shell → Ontology management: routes workflows
- Portal shell → Schema management: routes workflows
- Portal shell → Retail assistant: dispatches plugin
- Portal shell → Legal explorer: dispatches plugin
- Portal shell → Innovation explorer: dispatches plugin
- Portal shell → Other domain explorers: dispatches plugins
- Document ingestion → Ingestion state hooks: uses upload state
- Document ingestion → Workflow state: reads workflow data
- Graph exploration → Graph query state: loads graph data
- Graph query state → Socket provider: uses socket
- Graph RAG → Workflow state: invokes inference
- Document RAG → Workflow state: invokes inference
- Graph RAG → Explainability views: emits explain events
- Document RAG → Explainability views: emits explain events
- Graph exploration → Shared UI toolkit: renders with
- Query workbenches → Shared UI toolkit: uses components
- Retail assistant → Socket provider: uses socket
- Legal explorer → Socket provider: queries via socket
- Innovation explorer → Socket provider: queries via socket
- Socket provider → TrustGraph client: provides connection
- TrustGraph client → TrustGraph services: calls services