# kaviin2008/nexusai architecture

> Architecture diagram of the GitHub repository kaviin2008/nexusai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kaviin2008/nexusai
- Repository: https://github.com/kaviin2008/nexusai

## Overview

NexusAI is a Next.js interface for an AI-workspace product, centered on a chat workspace with conversation history and contextual memory/knowledge panels. It also exposes a model-and-usage analytics dashboard and a sign-in/sign-up screen. The sampled authentication flow uses demo credentials and explicitly marks backend calls as integration points; the excerpts show no live chat, persistence, or analytics service wiring. Edges below follow visible page composition and imports, so they describe UI composition rather than unverified backend behavior.

Main entry points: [`src/components/ui/AppIcon.tsx`](https://github.com/kaviin2008/nexusai/blob/main/src/components/ui/AppIcon.tsx) (Icon Component), [`src/app/analytics-dashboard/components/AnalyticsDashboardContent.tsx`](https://github.com/kaviin2008/nexusai/blob/main/src/app/analytics-dashboard/components/AnalyticsDashboardContent.tsx) (Dashboard Content), [`src/app/page.tsx`](https://github.com/kaviin2008/nexusai/blob/main/src/app/page.tsx) (Chat Page), [`src/components/AppLayout.tsx`](https://github.com/kaviin2008/nexusai/blob/main/src/components/AppLayout.tsx) (App Layout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Chat Workspace"]
  node_chat_page["Chat Page<br/>[page.tsx]"]
  node_conversation_sidebar["Conversation Sidebar"]
  node_chat_thread["Chat Thread<br/>[ChatThread.tsx]"]
  node_context_panel["Context Panel<br/>[ContextPanel.tsx]"]
  node_model_selector["Model Selector<br/>[ModelSelector.tsx]"]
end

subgraph group_analytics["Analytics"]
  node_analytics_page["Analytics Page<br/>[page.tsx]"]
  node_analytics_content["Dashboard Content"]
  node_activity_feed["Activity Feed<br/>[ActivityFeed.tsx]"]
  node_latency_chart["Latency Chart<br/>[LatencyChart.tsx]"]
  node_model_cost_chart["Model Cost Chart<br/>[ModelCostChart.tsx]"]
  node_model_health["Model Health Table"]
  node_token_usage["Token Usage Chart"]
  node_top_conversations["Top Conversations"]
end

subgraph group_account["Account Access"]
  node_auth_page["Authentication Page<br/>[page.tsx]"]
  node_auth_screen["Sign-in / Sign-up<br/>[AuthScreen.tsx]"]
end

subgraph group_shell["Application Shell"]
  node_app_layout["App Layout<br/>[AppLayout.tsx]"]
  node_sidebar["Navigation Sidebar<br/>[Sidebar.tsx]"]
  node_topbar["Top Bar<br/>[Topbar.tsx]"]
end

subgraph group_ui["Shared UI"]
  node_app_icon["Icon Component<br/>[AppIcon.tsx]"]
  node_app_image["Image Component<br/>[AppImage.tsx]"]
  node_app_logo["Logo Component<br/>[AppLogo.tsx]"]
end

node_visitor(("Workspace User"))

node_chat_page -->|"wraps in"| node_app_layout
node_chat_page -->|"renders"| node_conversation_sidebar
node_chat_page -->|"renders"| node_chat_thread
node_chat_page -->|"renders"| node_context_panel
node_analytics_page -->|"wraps in"| node_app_layout
node_analytics_page -->|"renders"| node_analytics_content
node_analytics_content -->|"renders"| node_activity_feed
node_analytics_content -->|"renders"| node_latency_chart
node_analytics_content -->|"renders"| node_model_cost_chart
node_analytics_content -->|"renders"| node_model_health
node_analytics_content -->|"renders"| node_token_usage
node_analytics_content -->|"renders"| node_top_conversations
node_auth_page -->|"renders"| node_auth_screen
node_app_layout -->|"renders"| node_sidebar
node_app_layout -->|"renders"| node_topbar
node_sidebar -->|"renders"| node_app_logo
node_sidebar -->|"uses icons"| node_app_icon
node_topbar -->|"uses icons"| node_app_icon
node_app_logo -->|"renders"| node_app_icon
node_app_logo -->|"renders"| node_app_image
node_conversation_sidebar -->|"uses icons"| node_app_icon
node_chat_thread -->|"uses icons"| node_app_icon
node_context_panel -->|"uses icons"| node_app_icon
node_analytics_content -->|"uses icons"| node_app_icon
node_activity_feed -->|"uses icons"| node_app_icon
node_model_health -->|"uses icons"| node_app_icon
node_top_conversations -->|"uses icons"| node_app_icon
node_auth_screen -->|"renders"| node_app_logo
node_auth_screen -->|"uses icons"| node_app_icon

click node_chat_page "https://github.com/kaviin2008/nexusai/blob/main/src/app/page.tsx"
click node_conversation_sidebar "https://github.com/kaviin2008/nexusai/blob/main/src/app/components/ConversationSidebar.tsx"
click node_chat_thread "https://github.com/kaviin2008/nexusai/blob/main/src/app/components/ChatThread.tsx"
click node_context_panel "https://github.com/kaviin2008/nexusai/blob/main/src/app/components/ContextPanel.tsx"
click node_model_selector "https://github.com/kaviin2008/nexusai/blob/main/src/app/components/ModelSelector.tsx"
click node_analytics_page "https://github.com/kaviin2008/nexusai/blob/main/src/app/analytics-dashboard/page.tsx"
click node_analytics_content "https://github.com/kaviin2008/nexusai/blob/main/src/app/analytics-dashboard/components/AnalyticsDashboardContent.tsx"
click node_activity_feed "https://github.com/kaviin2008/nexusai/blob/main/src/app/analytics-dashboard/components/ActivityFeed.tsx"
click node_latency_chart "https://github.com/kaviin2008/nexusai/blob/main/src/app/analytics-dashboard/components/LatencyChart.tsx"
click node_model_cost_chart "https://github.com/kaviin2008/nexusai/blob/main/src/app/analytics-dashboard/components/ModelCostChart.tsx"
click node_model_health "https://github.com/kaviin2008/nexusai/blob/main/src/app/analytics-dashboard/components/ModelHealthTable.tsx"
click node_token_usage "https://github.com/kaviin2008/nexusai/blob/main/src/app/analytics-dashboard/components/TokenUsageChart.tsx"
click node_top_conversations "https://github.com/kaviin2008/nexusai/blob/main/src/app/analytics-dashboard/components/TopConversationsTable.tsx"
click node_auth_page "https://github.com/kaviin2008/nexusai/blob/main/src/app/sign-up-login-screen/page.tsx"
click node_auth_screen "https://github.com/kaviin2008/nexusai/blob/main/src/app/sign-up-login-screen/components/AuthScreen.tsx"
click node_app_layout "https://github.com/kaviin2008/nexusai/blob/main/src/components/AppLayout.tsx"
click node_sidebar "https://github.com/kaviin2008/nexusai/blob/main/src/components/Sidebar.tsx"
click node_topbar "https://github.com/kaviin2008/nexusai/blob/main/src/components/Topbar.tsx"
click node_app_icon "https://github.com/kaviin2008/nexusai/blob/main/src/components/ui/AppIcon.tsx"
click node_app_image "https://github.com/kaviin2008/nexusai/blob/main/src/components/ui/AppImage.tsx"
click node_app_logo "https://github.com/kaviin2008/nexusai/blob/main/src/components/ui/AppLogo.tsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_chat_page,node_conversation_sidebar,node_chat_thread,node_context_panel,node_model_selector,node_visitor toneBlue
class node_analytics_page,node_analytics_content,node_activity_feed,node_latency_chart,node_model_cost_chart,node_model_health,node_token_usage,node_top_conversations toneAmber
class node_auth_page,node_auth_screen toneMint
class node_app_layout,node_sidebar,node_topbar toneRose
class node_app_icon,node_app_image,node_app_logo toneIndigo
```

## Components

### Chat Workspace

- [Chat Page](https://github.com/kaviin2008/nexusai/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Conversation Sidebar](https://github.com/kaviin2008/nexusai/blob/main/src/app/components/ConversationSidebar.tsx): `src/app/components/ConversationSidebar.tsx`
- [Chat Thread](https://github.com/kaviin2008/nexusai/blob/main/src/app/components/ChatThread.tsx): `src/app/components/ChatThread.tsx`
- [Context Panel](https://github.com/kaviin2008/nexusai/blob/main/src/app/components/ContextPanel.tsx): `src/app/components/ContextPanel.tsx`
- [Model Selector](https://github.com/kaviin2008/nexusai/blob/main/src/app/components/ModelSelector.tsx): `src/app/components/ModelSelector.tsx`

### Analytics

- [Analytics Page](https://github.com/kaviin2008/nexusai/blob/main/src/app/analytics-dashboard/page.tsx): `src/app/analytics-dashboard/page.tsx`
- [Dashboard Content](https://github.com/kaviin2008/nexusai/blob/main/src/app/analytics-dashboard/components/AnalyticsDashboardContent.tsx): `src/app/analytics-dashboard/components/AnalyticsDashboardContent.tsx`
- [Activity Feed](https://github.com/kaviin2008/nexusai/blob/main/src/app/analytics-dashboard/components/ActivityFeed.tsx): `src/app/analytics-dashboard/components/ActivityFeed.tsx`
- [Latency Chart](https://github.com/kaviin2008/nexusai/blob/main/src/app/analytics-dashboard/components/LatencyChart.tsx): `src/app/analytics-dashboard/components/LatencyChart.tsx`
- [Model Cost Chart](https://github.com/kaviin2008/nexusai/blob/main/src/app/analytics-dashboard/components/ModelCostChart.tsx): `src/app/analytics-dashboard/components/ModelCostChart.tsx`
- [Model Health Table](https://github.com/kaviin2008/nexusai/blob/main/src/app/analytics-dashboard/components/ModelHealthTable.tsx): `src/app/analytics-dashboard/components/ModelHealthTable.tsx`
- [Token Usage Chart](https://github.com/kaviin2008/nexusai/blob/main/src/app/analytics-dashboard/components/TokenUsageChart.tsx): `src/app/analytics-dashboard/components/TokenUsageChart.tsx`
- [Top Conversations](https://github.com/kaviin2008/nexusai/blob/main/src/app/analytics-dashboard/components/TopConversationsTable.tsx): `src/app/analytics-dashboard/components/TopConversationsTable.tsx`

### Account Access

- [Authentication Page](https://github.com/kaviin2008/nexusai/blob/main/src/app/sign-up-login-screen/page.tsx): `src/app/sign-up-login-screen/page.tsx`
- [Sign-in / Sign-up](https://github.com/kaviin2008/nexusai/blob/main/src/app/sign-up-login-screen/components/AuthScreen.tsx): `src/app/sign-up-login-screen/components/AuthScreen.tsx`

### Application Shell

- [App Layout](https://github.com/kaviin2008/nexusai/blob/main/src/components/AppLayout.tsx): `src/components/AppLayout.tsx`
- [Navigation Sidebar](https://github.com/kaviin2008/nexusai/blob/main/src/components/Sidebar.tsx): `src/components/Sidebar.tsx`
- [Top Bar](https://github.com/kaviin2008/nexusai/blob/main/src/components/Topbar.tsx): `src/components/Topbar.tsx`

### Shared UI

- [Icon Component](https://github.com/kaviin2008/nexusai/blob/main/src/components/ui/AppIcon.tsx): `src/components/ui/AppIcon.tsx`
- [Image Component](https://github.com/kaviin2008/nexusai/blob/main/src/components/ui/AppImage.tsx): `src/components/ui/AppImage.tsx`
- [Logo Component](https://github.com/kaviin2008/nexusai/blob/main/src/components/ui/AppLogo.tsx): `src/components/ui/AppLogo.tsx`

### Other components

- **Workspace User**

## Connections

- Chat Page → App Layout: wraps in (evidence: `src/app/page.tsx`)
- Chat Page → Conversation Sidebar: renders (evidence: `src/app/page.tsx`)
- Chat Page → Chat Thread: renders (evidence: `src/app/page.tsx`)
- Chat Page → Context Panel: renders (evidence: `src/app/page.tsx`)
- Analytics Page → App Layout: wraps in (evidence: `src/app/analytics-dashboard/page.tsx`)
- Analytics Page → Dashboard Content: renders (evidence: `src/app/analytics-dashboard/page.tsx`)
- Dashboard Content → Activity Feed: renders (evidence: `src/app/analytics-dashboard/components/AnalyticsDashboardContent.tsx`)
- Dashboard Content → Latency Chart: renders (evidence: `src/app/analytics-dashboard/components/AnalyticsDashboardContent.tsx`)
- Dashboard Content → Model Cost Chart: renders (evidence: `src/app/analytics-dashboard/components/AnalyticsDashboardContent.tsx`)
- Dashboard Content → Model Health Table: renders (evidence: `src/app/analytics-dashboard/components/AnalyticsDashboardContent.tsx`)
- Dashboard Content → Token Usage Chart: renders (evidence: `src/app/analytics-dashboard/components/AnalyticsDashboardContent.tsx`)
- Dashboard Content → Top Conversations: renders (evidence: `src/app/analytics-dashboard/components/AnalyticsDashboardContent.tsx`)
- Authentication Page → Sign-in / Sign-up: renders (evidence: `src/app/sign-up-login-screen/page.tsx`)
- App Layout → Navigation Sidebar: renders (evidence: `src/components/AppLayout.tsx`)
- App Layout → Top Bar: renders (evidence: `src/components/AppLayout.tsx`)
- Navigation Sidebar → Logo Component: renders (evidence: `src/components/Sidebar.tsx`)
- Navigation Sidebar → Icon Component: uses icons (evidence: `src/components/Sidebar.tsx`)
- Top Bar → Icon Component: uses icons (evidence: `src/components/Topbar.tsx`)
- Logo Component → Icon Component: renders (evidence: `src/components/ui/AppLogo.tsx`)
- Logo Component → Image Component: renders (evidence: `src/components/ui/AppLogo.tsx`)
- Conversation Sidebar → Icon Component: uses icons (evidence: `src/app/components/ConversationSidebar.tsx`)
- Chat Thread → Icon Component: uses icons (evidence: `src/app/components/ChatThread.tsx`)
- Context Panel → Icon Component: uses icons (evidence: `src/app/components/ContextPanel.tsx`)
- Dashboard Content → Icon Component: uses icons (evidence: `src/app/analytics-dashboard/components/AnalyticsDashboardContent.tsx`)
- Activity Feed → Icon Component: uses icons (evidence: `src/app/analytics-dashboard/components/ActivityFeed.tsx`)
- Model Health Table → Icon Component: uses icons (evidence: `src/app/analytics-dashboard/components/ModelHealthTable.tsx`)
- Top Conversations → Icon Component: uses icons (evidence: `src/app/analytics-dashboard/components/TopConversationsTable.tsx`)
- Sign-in / Sign-up → Logo Component: renders (evidence: `src/app/sign-up-login-screen/components/AuthScreen.tsx`)
- Sign-in / Sign-up → Icon Component: uses icons (evidence: `src/app/sign-up-login-screen/components/AuthScreen.tsx`)
