# zubair-2121/ai-tools-hub architecture

> Architecture diagram of the GitHub repository zubair-2121/ai-tools-hub, 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/zubair-2121/ai-tools-hub
- Repository: https://github.com/zubair-2121/ai-tools-hub

## Overview

AI Tools Hub is a full-stack directory for discovering and learning about AI tools. Users browse and filter the catalog, inspect tool details, and can compare tools; the app also provides roadmaps, news, saved tools, and account features. The React app routes these experiences, while Express exposes authentication and tools APIs backed by MySQL. The README documents additional API capabilities; unsampled page and route implementations are represented only where the tree or documentation supports them.

Main entry points: [`frontend/src/App.js`](https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/App.js) (App router), [`frontend/src/pages/Home.js`](https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/pages/Home.js) (Browse tools), [`frontend/src/components/ToolCard.js`](https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/components/ToolCard.js) (Tool cards), [`backend/routes/auth.js`](https://github.com/zubair-2121/ai-tools-hub/blob/main/backend/routes/auth.js) (Auth API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Tool discovery"]
  node_home["Browse tools<br/>[Home.js]"]
  node_catalog["Tool catalog<br/>[toolsData.js]"]
  node_toolcard["Tool cards<br/>[ToolCard.js]"]
  node_details["Tool details<br/>[Modal.js]"]
  node_compare["Tool comparison<br/>[Compare.js]"]
  node_voice["Voice playback<br/>[useVoice.js]"]
end

subgraph group_learning["Learning features"]
  node_chatbot["AI chatbot<br/>[AIChatbot.js]"]
  node_roadmaps["Learning roadmaps<br/>[Roadmaps.js]"]
  node_news["AI news<br/>[News.js]"]
end

subgraph group_identity["Accounts and saved tools"]
  node_authui["Login and registration<br/>[Login.js]"]
  node_profile["User profile<br/>[Profile.js]"]
  node_saved["Saved tools<br/>[Saved.js]"]
  node_authstate["Authentication state<br/>[AuthContext.js]"]
  node_bookmarks["Bookmark state<br/>[BookmarkContext.js]"]
end

subgraph group_platform["App and API platform"]
  node_app["App router<br/>[App.js]"]
  node_theme["Theme state<br/>[ThemeContext.js]"]
  node_backend["Express server<br/>[server.js]"]
  node_authapi["Auth API<br/>[auth.js]"]
  node_toolsapi["Tools API<br/>[tools.js]"]
  node_jwt["JWT middleware<br/>[auth.js]"]
  node_dbpool["MySQL pool<br/>[db.js]"]
  node_database[("MySQL database<br/>[schema.sql]")]
end

node_visitor(("Visitor"))
node_elevenlabs["ElevenLabs API"]

node_visitor -->|"opens app"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_compare
node_app -->|"routes to"| node_roadmaps
node_app -->|"routes to"| node_news
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_saved
node_app -->|"provides state"| node_authstate
node_app -->|"provides state"| node_bookmarks
node_app -->|"provides state"| node_theme
node_home -->|"filters and reads"| node_catalog
node_home -->|"renders"| node_toolcard
node_home -->|"opens"| node_details
node_home -->|"renders"| node_chatbot
node_compare -->|"reads"| node_catalog
node_toolcard -->|"reads helper"| node_catalog
node_toolcard -->|"toggles saved"| node_bookmarks
node_toolcard -->|"requests speech"| node_voice
node_details -->|"reads helper"| node_catalog
node_details -->|"requests speech"| node_voice
node_voice -.->|"sends speech text"| node_elevenlabs
node_saved -->|"reads saved tools"| node_bookmarks
node_backend -->|"mounts routes"| node_authapi
node_backend -->|"mounts routes"| node_toolsapi
node_authapi -->|"queries"| node_dbpool
node_authapi -->|"protects routes"| node_jwt
node_toolsapi -->|"queries"| node_dbpool
node_toolsapi -->|"protects routes"| node_jwt
node_dbpool -->|"connects to"| node_database
node_authstate -->|"fetches current user"| node_authapi

click node_app "https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/App.js"
click node_home "https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/pages/Home.js"
click node_catalog "https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/data/toolsData.js"
click node_toolcard "https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/components/ToolCard.js"
click node_details "https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/components/Modal.js"
click node_compare "https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/pages/Compare/Compare.js"
click node_voice "https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/hooks/useVoice.js"
click node_chatbot "https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/components/AIChatbot.js"
click node_roadmaps "https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/pages/Roadmaps/Roadmaps.js"
click node_news "https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/pages/News/News.js"
click node_authui "https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/pages/Login.js"
click node_profile "https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/pages/Profile.js"
click node_saved "https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/pages/Saved/Saved.js"
click node_authstate "https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/context/AuthContext.js"
click node_bookmarks "https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/context/BookmarkContext.js"
click node_theme "https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/context/ThemeContext.js"
click node_backend "https://github.com/zubair-2121/ai-tools-hub/blob/main/backend/server.js"
click node_authapi "https://github.com/zubair-2121/ai-tools-hub/blob/main/backend/routes/auth.js"
click node_toolsapi "https://github.com/zubair-2121/ai-tools-hub/blob/main/backend/routes/tools.js"
click node_jwt "https://github.com/zubair-2121/ai-tools-hub/blob/main/backend/middleware/auth.js"
click node_dbpool "https://github.com/zubair-2121/ai-tools-hub/blob/main/backend/config/db.js"
click node_database "https://github.com/zubair-2121/ai-tools-hub/blob/main/database/schema.sql"

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_home,node_catalog,node_toolcard,node_details,node_compare,node_voice toneBlue
class node_chatbot,node_roadmaps,node_news toneAmber
class node_authui,node_profile,node_saved,node_authstate,node_bookmarks,node_elevenlabs toneMint
class node_app,node_theme,node_backend,node_authapi,node_toolsapi,node_jwt,node_dbpool,node_database toneRose
class node_visitor toneIndigo
```

## Components

### Tool discovery

- [Browse tools](https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/pages/Home.js): `frontend/src/pages/Home.js`
- [Tool catalog](https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/data/toolsData.js): `frontend/src/data/toolsData.js`
- [Tool cards](https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/components/ToolCard.js): `frontend/src/components/ToolCard.js`
- [Tool details](https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/components/Modal.js): `frontend/src/components/Modal.js`
- [Tool comparison](https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/pages/Compare/Compare.js): `frontend/src/pages/Compare/Compare.js`
- [Voice playback](https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/hooks/useVoice.js): `frontend/src/hooks/useVoice.js`

### Learning features

- [AI chatbot](https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/components/AIChatbot.js): `frontend/src/components/AIChatbot.js`
- [Learning roadmaps](https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/pages/Roadmaps/Roadmaps.js): `frontend/src/pages/Roadmaps/Roadmaps.js`
- [AI news](https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/pages/News/News.js): `frontend/src/pages/News/News.js`

### Accounts and saved tools

- [Login and registration](https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/pages/Login.js): `frontend/src/pages/Login.js`
- [User profile](https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/pages/Profile.js): `frontend/src/pages/Profile.js`
- [Saved tools](https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/pages/Saved/Saved.js): `frontend/src/pages/Saved/Saved.js`
- [Authentication state](https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/context/AuthContext.js): `frontend/src/context/AuthContext.js`
- [Bookmark state](https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/context/BookmarkContext.js): `frontend/src/context/BookmarkContext.js`

### App and API platform

- [App router](https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Theme state](https://github.com/zubair-2121/ai-tools-hub/blob/main/frontend/src/context/ThemeContext.js): `frontend/src/context/ThemeContext.js`
- [Express server](https://github.com/zubair-2121/ai-tools-hub/blob/main/backend/server.js): `backend/server.js`
- [Auth API](https://github.com/zubair-2121/ai-tools-hub/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [Tools API](https://github.com/zubair-2121/ai-tools-hub/blob/main/backend/routes/tools.js): `backend/routes/tools.js`
- [JWT middleware](https://github.com/zubair-2121/ai-tools-hub/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`
- [MySQL pool](https://github.com/zubair-2121/ai-tools-hub/blob/main/backend/config/db.js): `backend/config/db.js`
- [MySQL database](https://github.com/zubair-2121/ai-tools-hub/blob/main/database/schema.sql): `database/schema.sql`

### Other components

- **Visitor**
- **ElevenLabs API**

## Connections

- Visitor → App router: opens app (evidence: `frontend/src/App.js`)
- App router → Browse tools: routes to (evidence: `frontend/src/App.js`)
- App router → Tool comparison: routes to (evidence: `frontend/src/App.js`)
- App router → Learning roadmaps: routes to (evidence: `frontend/src/App.js`)
- App router → AI news: routes to (evidence: `frontend/src/App.js`)
- App router → Login and registration: routes to (evidence: `frontend/src/App.js`)
- App router → User profile: routes to (evidence: `frontend/src/App.js`)
- App router → Saved tools: routes to (evidence: `frontend/src/App.js`)
- App router → Authentication state: provides state (evidence: `frontend/src/App.js`)
- App router → Bookmark state: provides state (evidence: `frontend/src/App.js`)
- App router → Theme state: provides state (evidence: `frontend/src/App.js`)
- Browse tools → Tool catalog: filters and reads (evidence: `frontend/src/pages/Home.js`)
- Browse tools → Tool cards: renders (evidence: `frontend/src/pages/Home.js`)
- Browse tools → Tool details: opens (evidence: `frontend/src/pages/Home.js`)
- Browse tools → AI chatbot: renders (evidence: `frontend/src/pages/Home.js`)
- Tool comparison → Tool catalog: reads (evidence: `frontend/src/pages/Compare/Compare.js`)
- Tool cards → Tool catalog: reads helper (evidence: `frontend/src/components/ToolCard.js`)
- Tool cards → Bookmark state: toggles saved (evidence: `frontend/src/components/ToolCard.js`)
- Tool cards → Voice playback: requests speech (evidence: `frontend/src/components/ToolCard.js`)
- Tool details → Tool catalog: reads helper (evidence: `frontend/src/components/Modal.js`)
- Tool details → Voice playback: requests speech (evidence: `frontend/src/components/Modal.js`)
- Voice playback → ElevenLabs API: sends speech text (evidence: `frontend/src/hooks/useVoice.js`)
- Saved tools → Bookmark state: reads saved tools (evidence: `frontend/src/pages/Saved/Saved.js`)
- Express server → Auth API: mounts routes (evidence: `backend/server.js`)
- Express server → Tools API: mounts routes (evidence: `backend/server.js`)
- Auth API → MySQL pool: queries (evidence: `backend/routes/auth.js`)
- Auth API → JWT middleware: protects routes (evidence: `backend/routes/auth.js`)
- Tools API → MySQL pool: queries (evidence: `backend/routes/tools.js`)
- Tools API → JWT middleware: protects routes (evidence: `backend/routes/tools.js`)
- MySQL pool → MySQL database: connects to (evidence: `README.md`)
- Authentication state → Auth API: fetches current user (evidence: `frontend/src/context/AuthContext.js`)
