# komalapriyan/skillsync architecture

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

- Interactive diagram: https://gitdiagram.com/komalapriyan/skillsync
- Repository: https://github.com/komalapriyan/skillsync

## Overview

The repository implements SkillSync AI: students register and search profiles, request peer matches, and manage connection requests and chat through a NitroStack MCP server. A separate React frontend presents home, registration, search, and matches pages, while the calculator-result widget is a distinct starter-template feature. The sampled frontend API module does not show a connection to the server, so no such edge is asserted; several backend resources and prompts are represented from the module wiring and source index, without inferring their runtime behavior.

Main entry points: [`src/app.module.ts`](https://github.com/komalapriyan/skillsync/blob/main/src/app.module.ts) (MCP application), [`frontend/src/App.tsx`](https://github.com/komalapriyan/skillsync/blob/main/frontend/src/App.tsx) (Web application), [`src/matching/matching.tools.ts`](https://github.com/komalapriyan/skillsync/blob/main/src/matching/matching.tools.ts) (Matching tools), [`src/students/students.service.ts`](https://github.com/komalapriyan/skillsync/blob/main/src/students/students.service.ts) (Student service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web frontend"]
  node_web_app["Web application<br/>[App.tsx]"]
  node_home_page["Home page<br/>[Home.tsx]"]
  node_register_page["Registration page<br/>[Register.tsx]"]
  node_search_page["Search page<br/>[Search.tsx]"]
  node_matches_page["Matches page<br/>[Matches.tsx]"]
  node_frontend_api["Frontend API<br/>[api.ts]"]
end

subgraph group_students["Student profiles"]
  node_server_app["MCP application<br/>[app.module.ts]"]
  node_student_tools["Student tools<br/>[students.tools.ts]"]
  node_student_resources["Student resources"]
  node_student_prompts["Student prompts"]
  node_student_service["Student service"]
  node_student_data[("Student data<br/>[students.data.ts]")]
end

subgraph group_matching["Peer matching"]
  node_matching_tools["Matching tools<br/>[matching.tools.ts]"]
  node_matching_resources["Matching resources"]
  node_matching_prompts["Matching prompts"]
  node_matching_service["Matching service"]
end

subgraph group_chat["Connections and chat"]
  node_chat_tools["Chat tools<br/>[chat.tools.ts]"]
  node_chat_resources["Chat resources<br/>[chat.resources.ts]"]
  node_chat_prompts["Chat prompts<br/>[chat.prompts.ts]"]
  node_chat_service["Chat service<br/>[chat.service.ts]"]
  node_chat_data[("Chat state<br/>[chat.data.ts]")]
end

subgraph group_widgets["Calculator widget"]
  node_calculator_widget["Calculator result<br/>[page.tsx]"]
end

node_student_user(("Student"))
node_mcp_client(("MCP client"))
node_health["System health<br/>[system.health.ts]"]

node_student_user -->|"uses"| node_web_app
node_web_app -->|"routes to"| node_home_page
node_web_app -->|"routes to"| node_register_page
node_web_app -->|"routes to"| node_search_page
node_web_app -->|"routes to"| node_matches_page
node_web_app -.-> node_frontend_api
node_mcp_client -.->|"invokes tools"| node_server_app
node_server_app -->|"registers"| node_student_tools
node_server_app -->|"registers"| node_student_resources
node_server_app -->|"registers"| node_student_prompts
node_student_tools -->|"calls"| node_student_service
node_student_service -->|"reads and writes"| node_student_data
node_server_app -->|"registers"| node_matching_tools
node_server_app -->|"registers"| node_matching_resources
node_server_app -->|"registers"| node_matching_prompts
node_matching_tools -->|"gets students"| node_student_service
node_matching_tools -->|"requests matches"| node_matching_service
node_matching_service -->|"uses student type"| node_student_data
node_server_app -->|"registers"| node_chat_tools
node_server_app -->|"registers"| node_chat_resources
node_server_app -->|"registers"| node_chat_prompts
node_chat_tools -->|"calls"| node_chat_service
node_chat_service -->|"reads and writes"| node_chat_data

click node_web_app "https://github.com/komalapriyan/skillsync/blob/main/frontend/src/App.tsx"
click node_home_page "https://github.com/komalapriyan/skillsync/blob/main/frontend/src/pages/Home.tsx"
click node_register_page "https://github.com/komalapriyan/skillsync/blob/main/frontend/src/pages/Register.tsx"
click node_search_page "https://github.com/komalapriyan/skillsync/blob/main/frontend/src/pages/Search.tsx"
click node_matches_page "https://github.com/komalapriyan/skillsync/blob/main/frontend/src/pages/Matches.tsx"
click node_frontend_api "https://github.com/komalapriyan/skillsync/blob/main/frontend/src/services/api.ts"
click node_server_app "https://github.com/komalapriyan/skillsync/blob/main/src/app.module.ts"
click node_student_tools "https://github.com/komalapriyan/skillsync/blob/main/src/students/students.tools.ts"
click node_student_resources "https://github.com/komalapriyan/skillsync/blob/main/src/students/students.resources.ts"
click node_student_prompts "https://github.com/komalapriyan/skillsync/blob/main/src/students/students.prompts.ts"
click node_student_service "https://github.com/komalapriyan/skillsync/blob/main/src/students/students.service.ts"
click node_student_data "https://github.com/komalapriyan/skillsync/blob/main/src/students/students.data.ts"
click node_matching_tools "https://github.com/komalapriyan/skillsync/blob/main/src/matching/matching.tools.ts"
click node_matching_resources "https://github.com/komalapriyan/skillsync/blob/main/src/matching/matching.resources.ts"
click node_matching_prompts "https://github.com/komalapriyan/skillsync/blob/main/src/matching/matching.prompts.ts"
click node_matching_service "https://github.com/komalapriyan/skillsync/blob/main/src/matching/matching.service.ts"
click node_chat_tools "https://github.com/komalapriyan/skillsync/blob/main/src/chat/chat.tools.ts"
click node_chat_resources "https://github.com/komalapriyan/skillsync/blob/main/src/chat/chat.resources.ts"
click node_chat_prompts "https://github.com/komalapriyan/skillsync/blob/main/src/chat/chat.prompts.ts"
click node_chat_service "https://github.com/komalapriyan/skillsync/blob/main/src/chat/chat.service.ts"
click node_chat_data "https://github.com/komalapriyan/skillsync/blob/main/src/chat/chat.data.ts"
click node_calculator_widget "https://github.com/komalapriyan/skillsync/blob/main/src/widgets/app/calculator-result/page.tsx"
click node_health "https://github.com/komalapriyan/skillsync/blob/main/src/health/system.health.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_web_app,node_home_page,node_register_page,node_search_page,node_matches_page,node_frontend_api,node_mcp_client toneBlue
class node_server_app,node_student_tools,node_student_resources,node_student_prompts,node_student_service,node_student_data toneAmber
class node_matching_tools,node_matching_resources,node_matching_prompts,node_matching_service toneMint
class node_chat_tools,node_chat_resources,node_chat_prompts,node_chat_service,node_chat_data toneRose
class node_calculator_widget,node_student_user toneIndigo
class node_health toneTeal
```

## Components

### Web frontend

- [Web application](https://github.com/komalapriyan/skillsync/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Home page](https://github.com/komalapriyan/skillsync/blob/main/frontend/src/pages/Home.tsx): `frontend/src/pages/Home.tsx`
- [Registration page](https://github.com/komalapriyan/skillsync/blob/main/frontend/src/pages/Register.tsx): `frontend/src/pages/Register.tsx`
- [Search page](https://github.com/komalapriyan/skillsync/blob/main/frontend/src/pages/Search.tsx): `frontend/src/pages/Search.tsx`
- [Matches page](https://github.com/komalapriyan/skillsync/blob/main/frontend/src/pages/Matches.tsx): `frontend/src/pages/Matches.tsx`
- [Frontend API](https://github.com/komalapriyan/skillsync/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`

### Student profiles

- [MCP application](https://github.com/komalapriyan/skillsync/blob/main/src/app.module.ts): `src/app.module.ts`
- [Student tools](https://github.com/komalapriyan/skillsync/blob/main/src/students/students.tools.ts): `src/students/students.tools.ts`
- [Student resources](https://github.com/komalapriyan/skillsync/blob/main/src/students/students.resources.ts): `src/students/students.resources.ts`
- [Student prompts](https://github.com/komalapriyan/skillsync/blob/main/src/students/students.prompts.ts): `src/students/students.prompts.ts`
- [Student service](https://github.com/komalapriyan/skillsync/blob/main/src/students/students.service.ts): `src/students/students.service.ts`
- [Student data](https://github.com/komalapriyan/skillsync/blob/main/src/students/students.data.ts): `src/students/students.data.ts`

### Peer matching

- [Matching tools](https://github.com/komalapriyan/skillsync/blob/main/src/matching/matching.tools.ts): `src/matching/matching.tools.ts`
- [Matching resources](https://github.com/komalapriyan/skillsync/blob/main/src/matching/matching.resources.ts): `src/matching/matching.resources.ts`
- [Matching prompts](https://github.com/komalapriyan/skillsync/blob/main/src/matching/matching.prompts.ts): `src/matching/matching.prompts.ts`
- [Matching service](https://github.com/komalapriyan/skillsync/blob/main/src/matching/matching.service.ts): `src/matching/matching.service.ts`

### Connections and chat

- [Chat tools](https://github.com/komalapriyan/skillsync/blob/main/src/chat/chat.tools.ts): `src/chat/chat.tools.ts`
- [Chat resources](https://github.com/komalapriyan/skillsync/blob/main/src/chat/chat.resources.ts): `src/chat/chat.resources.ts`
- [Chat prompts](https://github.com/komalapriyan/skillsync/blob/main/src/chat/chat.prompts.ts): `src/chat/chat.prompts.ts`
- [Chat service](https://github.com/komalapriyan/skillsync/blob/main/src/chat/chat.service.ts): `src/chat/chat.service.ts`
- [Chat state](https://github.com/komalapriyan/skillsync/blob/main/src/chat/chat.data.ts): `src/chat/chat.data.ts`

### Calculator widget

- [Calculator result](https://github.com/komalapriyan/skillsync/blob/main/src/widgets/app/calculator-result/page.tsx): `src/widgets/app/calculator-result/page.tsx`

### Other components

- **Student**
- **MCP client**
- [System health](https://github.com/komalapriyan/skillsync/blob/main/src/health/system.health.ts): `src/health/system.health.ts`

## Connections

- Student → Web application: uses (evidence: `frontend/src/App.tsx`)
- Web application → Home page: routes to (evidence: `frontend/src/App.tsx`)
- Web application → Registration page: routes to (evidence: `frontend/src/App.tsx`)
- Web application → Search page: routes to (evidence: `frontend/src/App.tsx`)
- Web application → Matches page: routes to (evidence: `frontend/src/App.tsx`)
- Web application → Frontend API
- MCP client → MCP application: invokes tools
- MCP application → Student tools: registers
- MCP application → Student resources: registers
- MCP application → Student prompts: registers
- Student tools → Student service: calls (evidence: `src/students/students.tools.ts`)
- Student service → Student data: reads and writes (evidence: `src/students/students.service.ts`)
- MCP application → Matching tools: registers (evidence: `src/app.module.ts`)
- MCP application → Matching resources: registers
- MCP application → Matching prompts: registers
- Matching tools → Student service: gets students (evidence: `src/matching/matching.tools.ts`)
- Matching tools → Matching service: requests matches (evidence: `src/matching/matching.tools.ts`)
- Matching service → Student data: uses student type (evidence: `src/matching/matching.service.ts`)
- MCP application → Chat tools: registers (evidence: `src/app.module.ts`)
- MCP application → Chat resources: registers
- MCP application → Chat prompts: registers
- Chat tools → Chat service: calls (evidence: `src/chat/chat.tools.ts`)
- Chat service → Chat state: reads and writes (evidence: `src/chat/chat.service.ts`)
