# devhamzz/boycode-africa-tool-call-demo architecture

> Architecture diagram of the GitHub repository devhamzz/boycode-africa-tool-call-demo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/devhamzz/boycode-africa-tool-call-demo
- Repository: https://github.com/devhamzz/boycode-africa-tool-call-demo

## Overview

GenZpt AI is a DeepSeek-powered chat app with a React dashboard and an Express-compatible API. The user-facing workflow is to enter through the dashboard, open chat, and receive an AI response; the documented product also includes login, activity, settings, search, memory, and uploads. The UI routes and shared providers are visible in excerpts. Backend route-to-service relationships follow README-documented capabilities; unsampled call wiring is not asserted.

Main entry points: [`frontend/src/App.tsx`](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/App.tsx) (App Router), [`frontend/src/components/Layout.tsx`](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/components/Layout.tsx) (Dashboard Layout), [`frontend/src/pages/Dashboard.tsx`](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/pages/Dashboard.tsx) (Dashboard), [`frontend/src/pages/Chat.tsx`](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/pages/Chat.tsx) (Chat Page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Dashboard UI"]
  node_app["App Router<br/>[App.tsx]"]
  node_layout["Dashboard Layout<br/>[Layout.tsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.tsx]"]
  node_chatpage["Chat Page<br/>[Chat.tsx]"]
  node_activity["Activity Page<br/>[Activity.tsx]"]
  node_login["Login Page<br/>[Login.tsx]"]
  node_settings["Settings Page<br/>[Settings.tsx]"]
  node_themeui["Theme Switcher<br/>[ThemeSwitcher.tsx]"]
  node_background["Animated Background<br/>[DevHamzBg.tsx]"]
  node_logo["Brand Logo<br/>[Logo.tsx]"]
  node_transition["Page Transition<br/>[PageTransition.tsx]"]
end

subgraph group_state["Shared UI State"]
  node_chatstate["Chat State<br/>[ChatContext.tsx]"]
  node_themestate["Theme State<br/>[ThemeContext.tsx]"]
end

subgraph group_api["API Capabilities"]
  node_loginapi["Login API<br/>[login.ts]"]
  node_chatapi["Chat API<br/>[chat.ts]"]
  node_health["Health API<br/>[health.ts]"]
  node_memory["Memory API<br/>[memory.ts]"]
  node_search["Search API<br/>[search.ts]"]
  node_upload["Upload API<br/>[upload.ts]"]
end

subgraph group_services["External Services"]
  node_deepseek{{"DeepSeek"}}
  node_supabase[("Supabase<br/>[supabase.ts]")]
  node_storage[("Supabase Storage")]
  node_tavily{{"Web Search API"}}
end

node_user(("User"))

node_user -->|"opens"| node_app
node_app -->|"routes through"| node_layout
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_chatpage
node_app -->|"routes to"| node_activity
node_app -->|"routes to"| node_settings
node_app -->|"routes to"| node_login
node_layout -->|"renders"| node_themeui
node_layout -->|"renders"| node_background
node_layout -->|"renders"| node_logo
node_themeui -->|"updates"| node_themestate
node_dashboard -->|"reads"| node_chatstate
node_chatpage -.->|"uses"| node_chatstate
node_dashboard -->|"renders"| node_transition
node_chatpage -.->|"submits prompts"| node_chatapi
node_chatapi -.->|"requests reasoning"| node_deepseek
node_loginapi -.->|"authenticates"| node_supabase
node_memory -.->|"stores memory"| node_supabase
node_upload -.->|"stores files"| node_storage
node_search -.->|"searches web"| node_tavily

click node_app "https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/App.tsx"
click node_layout "https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/components/Layout.tsx"
click node_dashboard "https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/pages/Dashboard.tsx"
click node_chatpage "https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/pages/Chat.tsx"
click node_activity "https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/pages/Activity.tsx"
click node_login "https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/pages/Login.tsx"
click node_settings "https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/pages/Settings.tsx"
click node_themeui "https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/components/ThemeSwitcher.tsx"
click node_background "https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/components/DevHamzBg.tsx"
click node_logo "https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/components/Logo.tsx"
click node_transition "https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/components/PageTransition.tsx"
click node_chatstate "https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/context/ChatContext.tsx"
click node_themestate "https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/context/ThemeContext.tsx"
click node_loginapi "https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/api/auth/login.ts"
click node_chatapi "https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/api/chat.ts"
click node_health "https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/api/health.ts"
click node_memory "https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/api/memory.ts"
click node_search "https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/api/search.ts"
click node_upload "https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/api/upload.ts"
click node_supabase "https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/lib/supabase.ts"

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_app,node_layout,node_dashboard,node_chatpage,node_activity,node_login,node_settings,node_themeui,node_background,node_logo,node_transition,node_user toneBlue
class node_chatstate,node_themestate toneAmber
class node_loginapi,node_chatapi,node_health,node_memory,node_search,node_upload toneMint
class node_deepseek,node_supabase,node_storage,node_tavily toneRose
```

## Components

### Dashboard UI

- [App Router](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Dashboard Layout](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/components/Layout.tsx): `frontend/src/components/Layout.tsx`
- [Dashboard](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/pages/Dashboard.tsx): `frontend/src/pages/Dashboard.tsx`
- [Chat Page](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/pages/Chat.tsx): `frontend/src/pages/Chat.tsx`
- [Activity Page](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/pages/Activity.tsx): `frontend/src/pages/Activity.tsx`
- [Login Page](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/pages/Login.tsx): `frontend/src/pages/Login.tsx`
- [Settings Page](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/pages/Settings.tsx): `frontend/src/pages/Settings.tsx`
- [Theme Switcher](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/components/ThemeSwitcher.tsx): `frontend/src/components/ThemeSwitcher.tsx`
- [Animated Background](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/components/DevHamzBg.tsx): `frontend/src/components/DevHamzBg.tsx`
- [Brand Logo](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/components/Logo.tsx): `frontend/src/components/Logo.tsx`
- [Page Transition](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/components/PageTransition.tsx): `frontend/src/components/PageTransition.tsx`

### Shared UI State

- [Chat State](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/context/ChatContext.tsx): `frontend/src/context/ChatContext.tsx`
- [Theme State](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/frontend/src/context/ThemeContext.tsx): `frontend/src/context/ThemeContext.tsx`

### API Capabilities

- [Login API](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/api/auth/login.ts): `api/auth/login.ts`
- [Chat API](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/api/chat.ts): `api/chat.ts`
- [Health API](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/api/health.ts): `api/health.ts`
- [Memory API](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/api/memory.ts): `api/memory.ts`
- [Search API](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/api/search.ts): `api/search.ts`
- [Upload API](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/api/upload.ts): `api/upload.ts`

### External Services

- **DeepSeek**
- [Supabase](https://github.com/devhamzz/boycode-africa-tool-call-demo/blob/main/lib/supabase.ts): `lib/supabase.ts`
- **Supabase Storage**
- **Web Search API**

### Other components

- **User**

## Connections

- User → App Router: opens (evidence: `frontend/src/App.tsx`)
- App Router → Dashboard Layout: routes through (evidence: `frontend/src/App.tsx`)
- App Router → Dashboard: routes to (evidence: `frontend/src/App.tsx`)
- App Router → Chat Page: routes to (evidence: `frontend/src/App.tsx`)
- App Router → Activity Page: routes to (evidence: `frontend/src/App.tsx`)
- App Router → Settings Page: routes to (evidence: `frontend/src/App.tsx`)
- App Router → Login Page: routes to (evidence: `frontend/src/App.tsx`)
- Dashboard Layout → Theme Switcher: renders (evidence: `frontend/src/components/Layout.tsx`)
- Dashboard Layout → Animated Background: renders (evidence: `frontend/src/components/Layout.tsx`)
- Dashboard Layout → Brand Logo: renders (evidence: `frontend/src/components/Layout.tsx`)
- Theme Switcher → Theme State: updates (evidence: `frontend/src/components/ThemeSwitcher.tsx`)
- Dashboard → Chat State: reads (evidence: `frontend/src/pages/Dashboard.tsx`)
- Chat Page → Chat State: uses
- Dashboard → Page Transition: renders (evidence: `frontend/src/pages/Dashboard.tsx`)
- Chat Page → Chat API: submits prompts
- Chat API → DeepSeek: requests reasoning (evidence: `README.md`)
- Login API → Supabase: authenticates (evidence: `README.md`)
- Memory API → Supabase: stores memory (evidence: `README.md`)
- Upload API → Supabase Storage: stores files (evidence: `README.md`)
- Search API → Web Search API: searches web (evidence: `README.md`)
