# 1nsharma/hiresaathi architecture

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

- Interactive diagram: https://gitdiagram.com/1nsharma/hiresaathi
- Repository: https://github.com/1nsharma/hiresaathi

## Overview

HireSaathi AI is a unified enterprise workspace spanning marketing, recruitment, support, automation, app building, and integrations. A user enters through the React app, which selects a module; marketing and integration modules have additional documented or source-visible agent and tool capabilities. The repository also contains an Express API for authentication, workspace management, and domain endpoints. The sampled frontend shows mocked Composio execution and local persistence; no frontend-to-backend API calls were evidenced, so the two are not connected here. Unsampled modules are represented at their exact page or route paths, with links omitted where implementation evidence is unavailable.

Main entry points: [`src/App.tsx`](https://github.com/1nsharma/hiresaathi/blob/main/src/App.tsx) (Page router), [`backend/src/server.ts`](https://github.com/1nsharma/hiresaathi/blob/main/backend/src/server.ts) (Express API), [`src/lib/toolStore.tsx`](https://github.com/1nsharma/hiresaathi/blob/main/src/lib/toolStore.tsx) (Tool connections), [`src/pages/ContentStudio.tsx`](https://github.com/1nsharma/hiresaathi/blob/main/src/pages/ContentStudio.tsx) (Content Studio)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Workspace UI"]
  node_app["Page router<br/>[App.tsx]"]
  node_sidebar["Navigation<br/>[Sidebar.tsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.tsx]"]
end

subgraph group_marketing["Marketing Suite"]
  node_brand["Brand IQ<br/>[BrandIQ.tsx]"]
  node_marketing_page["AI Marketing<br/>[Marketing.tsx]"]
  node_studio["Content Studio<br/>[ContentStudio.tsx]"]
  node_calendar["Calendar<br/>[Calendar.tsx]"]
  node_campaigns["Campaigns<br/>[Campaigns.tsx]"]
  node_approvals["Approvals<br/>[Approvals.tsx]"]
  node_assets["Asset Library<br/>[AssetLibrary.tsx]"]
  node_analytics["Analytics<br/>[Analytics.tsx]"]
end

subgraph group_business["Business Modules"]
  node_recruit["Recruitment<br/>[Recruit.tsx]"]
  node_support["AI Support<br/>[Support.tsx]"]
  node_automation["Automation<br/>[Automation.tsx]"]
  node_builder["App Builder<br/>[Builder.tsx]"]
end

subgraph group_integrations["Agents &amp; Tools"]
  node_mcp_page["MCP Connect<br/>[MCPConnect.tsx]"]
  node_tool_store["Tool connections<br/>[toolStore.tsx]"]
  node_composio["Composio tools<br/>[composio.ts]"]
  node_agent_runtime["Agent runtime<br/>[agentRuntime.ts]"]
  node_composio_service["Composio service"]
end

subgraph group_backend["Backend API"]
  node_api_server["Express API<br/>[server.ts]"]
  node_auth_routes["Authentication routes<br/>[auth.routes.ts]"]
  node_auth_controller["Authentication<br/>[auth.controller.ts]"]
  node_workspace_routes["Workspace routes"]
  node_workspace_controller["Workspace management"]
  node_brand_routes["Brand routes<br/>[brand.routes.ts]"]
  node_brand_controller["Brand analysis"]
  node_content_routes["Content routes<br/>[content.routes.ts]"]
  node_content_controller["Content API"]
  node_agent_routes["Agent routes<br/>[agent.routes.ts]"]
  node_agent_controller["Agent API"]
  node_agent_runtime_backend["Agent orchestration"]
  node_ai_service["AI services<br/>[ai.service.ts]"]
end

node_user(("Workspace user"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_sidebar
node_app -->|"selects page"| node_dashboard
node_app -->|"selects page"| node_brand
node_app -->|"selects page"| node_marketing_page
node_app -->|"selects page"| node_studio
node_app -->|"selects page"| node_calendar
node_app -->|"selects page"| node_campaigns
node_app -->|"selects page"| node_approvals
node_app -->|"selects page"| node_assets
node_app -->|"selects page"| node_analytics
node_app -->|"selects page"| node_recruit
node_app -->|"selects page"| node_support
node_app -->|"selects page"| node_automation
node_app -->|"selects page"| node_builder
node_app -->|"selects page"| node_mcp_page
node_studio -->|"uses"| node_agent_runtime
node_studio -->|"uses"| node_tool_store
node_marketing_page -->|"uses"| node_tool_store
node_mcp_page -->|"uses"| node_tool_store
node_tool_store -->|"connects tools"| node_composio
node_agent_runtime -->|"uses tools"| node_composio
node_api_server -->|"mounts"| node_auth_routes
node_api_server -->|"mounts"| node_workspace_routes
node_api_server -->|"mounts"| node_brand_routes
node_api_server -->|"mounts"| node_content_routes
node_api_server -->|"mounts"| node_agent_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_workspace_routes -->|"dispatches"| node_workspace_controller
node_brand_routes -->|"dispatches"| node_brand_controller
node_content_routes -->|"dispatches"| node_content_controller
node_agent_routes -->|"dispatches"| node_agent_controller
node_brand_controller -->|"analyzes with"| node_ai_service
node_agent_controller -->|"invokes"| node_agent_runtime_backend
node_agent_runtime_backend -->|"uses"| node_ai_service
node_agent_runtime_backend -->|"uses"| node_composio_service

click node_app "https://github.com/1nsharma/hiresaathi/blob/main/src/App.tsx"
click node_sidebar "https://github.com/1nsharma/hiresaathi/blob/main/src/components/Sidebar.tsx"
click node_dashboard "https://github.com/1nsharma/hiresaathi/blob/main/src/pages/Dashboard.tsx"
click node_brand "https://github.com/1nsharma/hiresaathi/blob/main/src/pages/BrandIQ.tsx"
click node_marketing_page "https://github.com/1nsharma/hiresaathi/blob/main/src/pages/Marketing.tsx"
click node_studio "https://github.com/1nsharma/hiresaathi/blob/main/src/pages/ContentStudio.tsx"
click node_calendar "https://github.com/1nsharma/hiresaathi/blob/main/src/pages/Calendar.tsx"
click node_campaigns "https://github.com/1nsharma/hiresaathi/blob/main/src/pages/Campaigns.tsx"
click node_approvals "https://github.com/1nsharma/hiresaathi/blob/main/src/pages/Approvals.tsx"
click node_assets "https://github.com/1nsharma/hiresaathi/blob/main/src/pages/AssetLibrary.tsx"
click node_analytics "https://github.com/1nsharma/hiresaathi/blob/main/src/pages/Analytics.tsx"
click node_recruit "https://github.com/1nsharma/hiresaathi/blob/main/src/pages/Recruit.tsx"
click node_support "https://github.com/1nsharma/hiresaathi/blob/main/src/pages/Support.tsx"
click node_automation "https://github.com/1nsharma/hiresaathi/blob/main/src/pages/Automation.tsx"
click node_builder "https://github.com/1nsharma/hiresaathi/blob/main/src/pages/Builder.tsx"
click node_mcp_page "https://github.com/1nsharma/hiresaathi/blob/main/src/pages/MCPConnect.tsx"
click node_tool_store "https://github.com/1nsharma/hiresaathi/blob/main/src/lib/toolStore.tsx"
click node_composio "https://github.com/1nsharma/hiresaathi/blob/main/src/lib/composio.ts"
click node_agent_runtime "https://github.com/1nsharma/hiresaathi/blob/main/src/lib/agentRuntime.ts"
click node_composio_service "https://github.com/1nsharma/hiresaathi/blob/main/backend/src/services/composio.service.ts"
click node_api_server "https://github.com/1nsharma/hiresaathi/blob/main/backend/src/server.ts"
click node_auth_routes "https://github.com/1nsharma/hiresaathi/blob/main/backend/src/routes/auth.routes.ts"
click node_auth_controller "https://github.com/1nsharma/hiresaathi/blob/main/backend/src/controllers/auth.controller.ts"
click node_workspace_routes "https://github.com/1nsharma/hiresaathi/blob/main/backend/src/routes/workspace.routes.ts"
click node_workspace_controller "https://github.com/1nsharma/hiresaathi/blob/main/backend/src/controllers/workspace.controller.ts"
click node_brand_routes "https://github.com/1nsharma/hiresaathi/blob/main/backend/src/routes/brand.routes.ts"
click node_brand_controller "https://github.com/1nsharma/hiresaathi/blob/main/backend/src/controllers/brand.controller.ts"
click node_content_routes "https://github.com/1nsharma/hiresaathi/blob/main/backend/src/routes/content.routes.ts"
click node_content_controller "https://github.com/1nsharma/hiresaathi/blob/main/backend/src/controllers/content.controller.ts"
click node_agent_routes "https://github.com/1nsharma/hiresaathi/blob/main/backend/src/routes/agent.routes.ts"
click node_agent_controller "https://github.com/1nsharma/hiresaathi/blob/main/backend/src/controllers/agent.controller.ts"
click node_agent_runtime_backend "https://github.com/1nsharma/hiresaathi/blob/main/backend/src/services/agentRuntime.service.ts"
click node_ai_service "https://github.com/1nsharma/hiresaathi/blob/main/backend/src/services/ai.service.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_sidebar,node_dashboard,node_user toneBlue
class node_brand,node_marketing_page,node_studio,node_calendar,node_campaigns,node_approvals,node_assets,node_analytics toneAmber
class node_recruit,node_support,node_automation,node_builder toneMint
class node_mcp_page,node_tool_store,node_composio,node_agent_runtime,node_composio_service toneRose
class node_api_server,node_auth_routes,node_auth_controller,node_workspace_routes,node_workspace_controller,node_brand_routes,node_brand_controller,node_content_routes,node_content_controller,node_agent_routes,node_agent_controller,node_agent_runtime_backend,node_ai_service toneIndigo
```

## Components

### Workspace UI

- [Page router](https://github.com/1nsharma/hiresaathi/blob/main/src/App.tsx): `src/App.tsx`
- [Navigation](https://github.com/1nsharma/hiresaathi/blob/main/src/components/Sidebar.tsx): `src/components/Sidebar.tsx`
- [Dashboard](https://github.com/1nsharma/hiresaathi/blob/main/src/pages/Dashboard.tsx): `src/pages/Dashboard.tsx`

### Marketing Suite

- [Brand IQ](https://github.com/1nsharma/hiresaathi/blob/main/src/pages/BrandIQ.tsx): `src/pages/BrandIQ.tsx`
- [AI Marketing](https://github.com/1nsharma/hiresaathi/blob/main/src/pages/Marketing.tsx): `src/pages/Marketing.tsx`
- [Content Studio](https://github.com/1nsharma/hiresaathi/blob/main/src/pages/ContentStudio.tsx): `src/pages/ContentStudio.tsx`
- [Calendar](https://github.com/1nsharma/hiresaathi/blob/main/src/pages/Calendar.tsx): `src/pages/Calendar.tsx`
- [Campaigns](https://github.com/1nsharma/hiresaathi/blob/main/src/pages/Campaigns.tsx): `src/pages/Campaigns.tsx`
- [Approvals](https://github.com/1nsharma/hiresaathi/blob/main/src/pages/Approvals.tsx): `src/pages/Approvals.tsx`
- [Asset Library](https://github.com/1nsharma/hiresaathi/blob/main/src/pages/AssetLibrary.tsx): `src/pages/AssetLibrary.tsx`
- [Analytics](https://github.com/1nsharma/hiresaathi/blob/main/src/pages/Analytics.tsx): `src/pages/Analytics.tsx`

### Business Modules

- [Recruitment](https://github.com/1nsharma/hiresaathi/blob/main/src/pages/Recruit.tsx): `src/pages/Recruit.tsx`
- [AI Support](https://github.com/1nsharma/hiresaathi/blob/main/src/pages/Support.tsx): `src/pages/Support.tsx`
- [Automation](https://github.com/1nsharma/hiresaathi/blob/main/src/pages/Automation.tsx): `src/pages/Automation.tsx`
- [App Builder](https://github.com/1nsharma/hiresaathi/blob/main/src/pages/Builder.tsx): `src/pages/Builder.tsx`

### Agents & Tools

- [MCP Connect](https://github.com/1nsharma/hiresaathi/blob/main/src/pages/MCPConnect.tsx): `src/pages/MCPConnect.tsx`
- [Tool connections](https://github.com/1nsharma/hiresaathi/blob/main/src/lib/toolStore.tsx): `src/lib/toolStore.tsx`
- [Composio tools](https://github.com/1nsharma/hiresaathi/blob/main/src/lib/composio.ts): `src/lib/composio.ts`
- [Agent runtime](https://github.com/1nsharma/hiresaathi/blob/main/src/lib/agentRuntime.ts): `src/lib/agentRuntime.ts`
- [Composio service](https://github.com/1nsharma/hiresaathi/blob/main/backend/src/services/composio.service.ts): `backend/src/services/composio.service.ts`

### Backend API

- [Express API](https://github.com/1nsharma/hiresaathi/blob/main/backend/src/server.ts): `backend/src/server.ts`
- [Authentication routes](https://github.com/1nsharma/hiresaathi/blob/main/backend/src/routes/auth.routes.ts): `backend/src/routes/auth.routes.ts`
- [Authentication](https://github.com/1nsharma/hiresaathi/blob/main/backend/src/controllers/auth.controller.ts): `backend/src/controllers/auth.controller.ts`
- [Workspace routes](https://github.com/1nsharma/hiresaathi/blob/main/backend/src/routes/workspace.routes.ts): `backend/src/routes/workspace.routes.ts`
- [Workspace management](https://github.com/1nsharma/hiresaathi/blob/main/backend/src/controllers/workspace.controller.ts): `backend/src/controllers/workspace.controller.ts`
- [Brand routes](https://github.com/1nsharma/hiresaathi/blob/main/backend/src/routes/brand.routes.ts): `backend/src/routes/brand.routes.ts`
- [Brand analysis](https://github.com/1nsharma/hiresaathi/blob/main/backend/src/controllers/brand.controller.ts): `backend/src/controllers/brand.controller.ts`
- [Content routes](https://github.com/1nsharma/hiresaathi/blob/main/backend/src/routes/content.routes.ts): `backend/src/routes/content.routes.ts`
- [Content API](https://github.com/1nsharma/hiresaathi/blob/main/backend/src/controllers/content.controller.ts): `backend/src/controllers/content.controller.ts`
- [Agent routes](https://github.com/1nsharma/hiresaathi/blob/main/backend/src/routes/agent.routes.ts): `backend/src/routes/agent.routes.ts`
- [Agent API](https://github.com/1nsharma/hiresaathi/blob/main/backend/src/controllers/agent.controller.ts): `backend/src/controllers/agent.controller.ts`
- [Agent orchestration](https://github.com/1nsharma/hiresaathi/blob/main/backend/src/services/agentRuntime.service.ts): `backend/src/services/agentRuntime.service.ts`
- [AI services](https://github.com/1nsharma/hiresaathi/blob/main/backend/src/services/ai.service.ts): `backend/src/services/ai.service.ts`

### Other components

- **Workspace user**

## Connections

- Workspace user → Page router: uses (evidence: `README.md`)
- Page router → Navigation: renders (evidence: `src/App.tsx`)
- Page router → Dashboard: selects page (evidence: `src/App.tsx`)
- Page router → Brand IQ: selects page (evidence: `src/App.tsx`)
- Page router → AI Marketing: selects page (evidence: `src/App.tsx`)
- Page router → Content Studio: selects page (evidence: `src/App.tsx`)
- Page router → Calendar: selects page (evidence: `src/App.tsx`)
- Page router → Campaigns: selects page (evidence: `src/App.tsx`)
- Page router → Approvals: selects page (evidence: `src/App.tsx`)
- Page router → Asset Library: selects page (evidence: `src/App.tsx`)
- Page router → Analytics: selects page (evidence: `src/App.tsx`)
- Page router → Recruitment: selects page (evidence: `src/App.tsx`)
- Page router → AI Support: selects page (evidence: `src/App.tsx`)
- Page router → Automation: selects page (evidence: `src/App.tsx`)
- Page router → App Builder: selects page (evidence: `src/App.tsx`)
- Page router → MCP Connect: selects page (evidence: `src/App.tsx`)
- Content Studio → Agent runtime: uses (evidence: `src/pages/ContentStudio.tsx`)
- Content Studio → Tool connections: uses (evidence: `src/pages/ContentStudio.tsx`)
- AI Marketing → Tool connections: uses (evidence: `src/pages/Marketing.tsx`)
- MCP Connect → Tool connections: uses (evidence: `src/pages/MCPConnect.tsx`)
- Tool connections → Composio tools: connects tools (evidence: `src/lib/toolStore.tsx`)
- Agent runtime → Composio tools: uses tools (evidence: `src/lib/agentRuntime.ts`)
- Express API → Authentication routes: mounts (evidence: `backend/src/server.ts`)
- Express API → Workspace routes: mounts (evidence: `backend/src/server.ts`)
- Express API → Brand routes: mounts (evidence: `backend/src/server.ts`)
- Express API → Content routes: mounts (evidence: `backend/src/server.ts`)
- Express API → Agent routes: mounts (evidence: `backend/src/server.ts`)
- Authentication routes → Authentication: dispatches (evidence: `backend/src/routes/auth.routes.ts`)
- Workspace routes → Workspace management: dispatches (evidence: `backend/src/routes/workspace.routes.ts`)
- Brand routes → Brand analysis: dispatches (evidence: `backend/src/routes/brand.routes.ts`)
- Content routes → Content API: dispatches (evidence: `backend/src/routes/content.routes.ts`)
- Agent routes → Agent API: dispatches (evidence: `backend/src/routes/agent.routes.ts`)
- Brand analysis → AI services: analyzes with (evidence: `backend/src/controllers/brand.controller.ts`)
- Agent API → Agent orchestration: invokes (evidence: `backend/src/controllers/agent.controller.ts`)
- Agent orchestration → AI services: uses (evidence: `backend/src/services/agentRuntime.service.ts`)
- Agent orchestration → Composio service: uses (evidence: `backend/src/services/agentRuntime.service.ts`)