# ramcharan555/skillbridge-ai architecture

> Architecture diagram of the GitHub repository ramcharan555/skillbridge-ai, 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/ramcharan555/skillbridge-ai
- Repository: https://github.com/ramcharan555/skillbridge-ai

## Overview

SkillBridge AI is a student–provider task marketplace with role-based workspaces and admin oversight. The main workflow is account access, task discovery or posting, explainable matching and applications, then task completion, payment release, and reviews. Additional product areas include messaging, skill exchange and gap analysis, portfolios, notifications, disputes, and moderation. The sampled sources show the shared workspace and state provider, seed data, and a match API; other feature connections are documented in the README but their detailed implementation was not sampled.

Main entry points: [`components/workspace.tsx`](https://github.com/ramcharan555/skillbridge-ai/blob/main/components/workspace.tsx) (Feature workspace), [`components/shell.tsx`](https://github.com/ramcharan555/skillbridge-ai/blob/main/components/shell.tsx) (Role workspace shell), [`components/providers.tsx`](https://github.com/ramcharan555/skillbridge-ai/blob/main/components/providers.tsx) (Application state), [`app/admin/page.tsx`](https://github.com/ramcharan555/skillbridge-ai/blob/main/app/admin/page.tsx) (Admin moderation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and UI"]
  node_home["Opportunity landing<br/>[page.tsx]"]
  node_account["Sign-in and registration<br/>[page.tsx]"]
  node_shell["Role workspace shell<br/>[shell.tsx]"]
  node_ui["UI components<br/>[ui.tsx]"]
end

subgraph group_market["Marketplace workflow"]
  node_workspace["Feature workspace<br/>[workspace.tsx]"]
  node_tasks["Task marketplace<br/>[page.tsx]"]
  node_task_detail["Task detail and apply<br/>[page.tsx]"]
  node_task_create["Task publishing<br/>[page.tsx]"]
  node_applications["Applications and lifecycle<br/>[page.tsx]"]
  node_dashboards["Role dashboards<br/>[page.tsx]"]
  node_provider_dash["Provider dashboard<br/>[page.tsx]"]
  node_match_api["Match endpoint<br/>[route.ts]"]
end

subgraph group_community["Skills and community"]
  node_skills["Skill exchange and gap<br/>[page.tsx]"]
  node_portfolio["Portfolio and reviews<br/>[page.tsx]"]
  node_messages["Messaging<br/>[page.tsx]"]
end

subgraph group_trust["Payments and trust"]
  node_wallet["Wallet and escrow<br/>[page.tsx]"]
  node_notifications["Notifications<br/>[page.tsx]"]
  node_disputes["Dispute center<br/>[page.tsx]"]
  node_admin_tools["Admin moderation<br/>[page.tsx]"]
  node_admin_control["Super-admin<br/>[page.tsx]"]
end

subgraph group_platform["State and matching"]
  node_matching["Explainable match scoring<br/>[ai.ts]"]
  node_state["Application state<br/>[providers.tsx]"]
  node_seed["Demo seed data<br/>[seed.ts]"]
  node_supabase[("Supabase configuration<br/>[supabase.ts]")]
  node_storage_mode["Storage mode selector<br/>[repository.ts]"]
  node_types["Domain model<br/>[types.ts]"]
end

node_visitor(("Student / provider"))
node_admin(("Admin"))

node_visitor -->|"visits"| node_home
node_visitor -->|"signs in"| node_account
node_admin -.->|"oversees"| node_admin_tools
node_home -->|"renders"| node_ui
node_account -->|"authenticates"| node_state
node_shell -->|"reads session"| node_state
node_shell -.->|"renders routes"| node_workspace
node_workspace -->|"renders"| node_ui
node_workspace -->|"reads and updates"| node_state
node_workspace -->|"scores candidates"| node_matching
node_tasks -->|"uses shell"| node_shell
node_task_detail -->|"uses shell"| node_shell
node_task_create -->|"uses shell"| node_shell
node_applications -->|"uses shell"| node_shell
node_dashboards -->|"uses shell"| node_shell
node_provider_dash -->|"uses shell"| node_shell
node_match_api -->|"calculates score"| node_matching
node_state -->|"initializes from"| node_seed
node_state -->|"uses model"| node_types
node_storage_mode -->|"checks configuration"| node_supabase
node_skills -.->|"feature view via"| node_workspace
node_portfolio -.->|"feature view via"| node_workspace
node_messages -.->|"feature view via"| node_workspace
node_wallet -.->|"feature view via"| node_workspace
node_notifications -.->|"feature view via"| node_workspace
node_disputes -.->|"feature view via"| node_workspace
node_admin_tools -.->|"feature view via"| node_workspace
node_admin_control -.->|"administers"| node_admin_tools

click node_home "https://github.com/ramcharan555/skillbridge-ai/blob/main/app/page.tsx"
click node_account "https://github.com/ramcharan555/skillbridge-ai/blob/main/app/login/page.tsx"
click node_shell "https://github.com/ramcharan555/skillbridge-ai/blob/main/components/shell.tsx"
click node_ui "https://github.com/ramcharan555/skillbridge-ai/blob/main/components/ui.tsx"
click node_workspace "https://github.com/ramcharan555/skillbridge-ai/blob/main/components/workspace.tsx"
click node_tasks "https://github.com/ramcharan555/skillbridge-ai/blob/main/app/tasks/page.tsx"
click node_task_detail "https://github.com/ramcharan555/skillbridge-ai/blob/main/app/tasks/%5Bid%5D/page.tsx"
click node_task_create "https://github.com/ramcharan555/skillbridge-ai/blob/main/app/tasks/new/page.tsx"
click node_applications "https://github.com/ramcharan555/skillbridge-ai/blob/main/app/applications/page.tsx"
click node_dashboards "https://github.com/ramcharan555/skillbridge-ai/blob/main/app/dashboard/student/page.tsx"
click node_provider_dash "https://github.com/ramcharan555/skillbridge-ai/blob/main/app/dashboard/provider/page.tsx"
click node_match_api "https://github.com/ramcharan555/skillbridge-ai/blob/main/app/api/match/route.ts"
click node_matching "https://github.com/ramcharan555/skillbridge-ai/blob/main/lib/ai.ts"
click node_state "https://github.com/ramcharan555/skillbridge-ai/blob/main/components/providers.tsx"
click node_seed "https://github.com/ramcharan555/skillbridge-ai/blob/main/data/seed.ts"
click node_supabase "https://github.com/ramcharan555/skillbridge-ai/blob/main/lib/supabase.ts"
click node_storage_mode "https://github.com/ramcharan555/skillbridge-ai/blob/main/lib/repository.ts"
click node_types "https://github.com/ramcharan555/skillbridge-ai/blob/main/data/types.ts"
click node_skills "https://github.com/ramcharan555/skillbridge-ai/blob/main/app/skill-exchange/page.tsx"
click node_portfolio "https://github.com/ramcharan555/skillbridge-ai/blob/main/app/portfolio/page.tsx"
click node_messages "https://github.com/ramcharan555/skillbridge-ai/blob/main/app/messages/page.tsx"
click node_wallet "https://github.com/ramcharan555/skillbridge-ai/blob/main/app/wallet/page.tsx"
click node_notifications "https://github.com/ramcharan555/skillbridge-ai/blob/main/app/notifications/page.tsx"
click node_disputes "https://github.com/ramcharan555/skillbridge-ai/blob/main/app/disputes/page.tsx"
click node_admin_tools "https://github.com/ramcharan555/skillbridge-ai/blob/main/app/admin/page.tsx"
click node_admin_control "https://github.com/ramcharan555/skillbridge-ai/blob/main/app/super-admin/page.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_home,node_account,node_shell,node_ui toneBlue
class node_workspace,node_tasks,node_task_detail,node_task_create,node_applications,node_dashboards,node_provider_dash,node_match_api toneAmber
class node_skills,node_portfolio,node_messages toneMint
class node_wallet,node_notifications,node_disputes,node_admin_tools,node_admin_control toneRose
class node_matching,node_state,node_seed,node_supabase,node_storage_mode,node_types,node_visitor,node_admin toneIndigo
```

## Components

### Access and UI

- [Opportunity landing](https://github.com/ramcharan555/skillbridge-ai/blob/main/app/page.tsx): `app/page.tsx`
- [Sign-in and registration](https://github.com/ramcharan555/skillbridge-ai/blob/main/app/login/page.tsx): `app/login/page.tsx`
- [Role workspace shell](https://github.com/ramcharan555/skillbridge-ai/blob/main/components/shell.tsx): `components/shell.tsx`
- [UI components](https://github.com/ramcharan555/skillbridge-ai/blob/main/components/ui.tsx): `components/ui.tsx`

### Marketplace workflow

- [Feature workspace](https://github.com/ramcharan555/skillbridge-ai/blob/main/components/workspace.tsx): `components/workspace.tsx`
- [Task marketplace](https://github.com/ramcharan555/skillbridge-ai/blob/main/app/tasks/page.tsx): `app/tasks/page.tsx`
- [Task detail and apply](https://github.com/ramcharan555/skillbridge-ai/blob/main/app/tasks/%5Bid%5D/page.tsx): `app/tasks/[id]/page.tsx`
- [Task publishing](https://github.com/ramcharan555/skillbridge-ai/blob/main/app/tasks/new/page.tsx): `app/tasks/new/page.tsx`
- [Applications and lifecycle](https://github.com/ramcharan555/skillbridge-ai/blob/main/app/applications/page.tsx): `app/applications/page.tsx`
- [Role dashboards](https://github.com/ramcharan555/skillbridge-ai/blob/main/app/dashboard/student/page.tsx): `app/dashboard/student/page.tsx`
- [Provider dashboard](https://github.com/ramcharan555/skillbridge-ai/blob/main/app/dashboard/provider/page.tsx): `app/dashboard/provider/page.tsx`
- [Match endpoint](https://github.com/ramcharan555/skillbridge-ai/blob/main/app/api/match/route.ts): `app/api/match/route.ts`

### Skills and community

- [Skill exchange and gap](https://github.com/ramcharan555/skillbridge-ai/blob/main/app/skill-exchange/page.tsx): `app/skill-exchange/page.tsx`
- [Portfolio and reviews](https://github.com/ramcharan555/skillbridge-ai/blob/main/app/portfolio/page.tsx): `app/portfolio/page.tsx`
- [Messaging](https://github.com/ramcharan555/skillbridge-ai/blob/main/app/messages/page.tsx): `app/messages/page.tsx`

### Payments and trust

- [Wallet and escrow](https://github.com/ramcharan555/skillbridge-ai/blob/main/app/wallet/page.tsx): `app/wallet/page.tsx`
- [Notifications](https://github.com/ramcharan555/skillbridge-ai/blob/main/app/notifications/page.tsx): `app/notifications/page.tsx`
- [Dispute center](https://github.com/ramcharan555/skillbridge-ai/blob/main/app/disputes/page.tsx): `app/disputes/page.tsx`
- [Admin moderation](https://github.com/ramcharan555/skillbridge-ai/blob/main/app/admin/page.tsx): `app/admin/page.tsx`
- [Super-admin](https://github.com/ramcharan555/skillbridge-ai/blob/main/app/super-admin/page.tsx): `app/super-admin/page.tsx`

### State and matching

- [Explainable match scoring](https://github.com/ramcharan555/skillbridge-ai/blob/main/lib/ai.ts): `lib/ai.ts`
- [Application state](https://github.com/ramcharan555/skillbridge-ai/blob/main/components/providers.tsx): `components/providers.tsx`
- [Demo seed data](https://github.com/ramcharan555/skillbridge-ai/blob/main/data/seed.ts): `data/seed.ts`
- [Supabase configuration](https://github.com/ramcharan555/skillbridge-ai/blob/main/lib/supabase.ts): `lib/supabase.ts`
- [Storage mode selector](https://github.com/ramcharan555/skillbridge-ai/blob/main/lib/repository.ts): `lib/repository.ts`
- [Domain model](https://github.com/ramcharan555/skillbridge-ai/blob/main/data/types.ts): `data/types.ts`

### Other components

- **Student / provider**
- **Admin**

## Connections

- Student / provider → Opportunity landing: visits (evidence: `app/page.tsx`)
- Student / provider → Sign-in and registration: signs in (evidence: `app/login/page.tsx`)
- Admin → Admin moderation: oversees (evidence: `README.md`)
- Opportunity landing → UI components: renders (evidence: `app/page.tsx`)
- Sign-in and registration → Application state: authenticates (evidence: `app/login/page.tsx`)
- Role workspace shell → Application state: reads session (evidence: `components/shell.tsx`)
- Role workspace shell → Feature workspace: renders routes
- Feature workspace → UI components: renders (evidence: `components/workspace.tsx`)
- Feature workspace → Application state: reads and updates (evidence: `components/workspace.tsx`)
- Feature workspace → Explainable match scoring: scores candidates (evidence: `components/workspace.tsx`)
- Task marketplace → Role workspace shell: uses shell (evidence: `app/tasks/page.tsx`)
- Task detail and apply → Role workspace shell: uses shell (evidence: `app/tasks/[id]/page.tsx`)
- Task publishing → Role workspace shell: uses shell (evidence: `app/tasks/new/page.tsx`)
- Applications and lifecycle → Role workspace shell: uses shell (evidence: `app/applications/page.tsx`)
- Role dashboards → Role workspace shell: uses shell (evidence: `app/dashboard/student/page.tsx`)
- Provider dashboard → Role workspace shell: uses shell (evidence: `app/dashboard/provider/page.tsx`)
- Match endpoint → Explainable match scoring: calculates score (evidence: `app/api/match/route.ts`)
- Application state → Demo seed data: initializes from (evidence: `components/providers.tsx`)
- Application state → Domain model: uses model (evidence: `components/providers.tsx`)
- Storage mode selector → Supabase configuration: checks configuration (evidence: `lib/repository.ts`)
- Skill exchange and gap → Feature workspace: feature view via (evidence: `app/skill-exchange/page.tsx`)
- Portfolio and reviews → Feature workspace: feature view via (evidence: `app/portfolio/page.tsx`)
- Messaging → Feature workspace: feature view via (evidence: `app/messages/page.tsx`)
- Wallet and escrow → Feature workspace: feature view via (evidence: `app/wallet/page.tsx`)
- Notifications → Feature workspace: feature view via (evidence: `app/notifications/page.tsx`)
- Dispute center → Feature workspace: feature view via (evidence: `app/disputes/page.tsx`)
- Admin moderation → Feature workspace: feature view via (evidence: `app/admin/page.tsx`)
- Super-admin → Admin moderation: administers
