# skillforge-fullstack/skillforge-frontend architecture

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

- Interactive diagram: https://gitdiagram.com/skillforge-fullstack/skillforge-frontend
- Repository: https://github.com/skillforge-fullstack/skillforge-frontend

## Overview

SkillForge is a career-development platform for developers and recruiters. Users register or sign in, then enter role-specific areas: developers practice interviews, track progress, join forums, pursue certifications and browse jobs; recruiters discover candidates and manage hiring workflows. The sampled code confirms authentication, interview and statistics hooks, and recruiter marketplace data access. The tree also identifies voice interviews, messaging, scheduling and certification features, but their runtime wiring was not sampled, so those relationships are left unasserted.

Main entry points: [`lib/hooks/useAuth.ts`](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/hooks/useAuth.ts) (Authentication), [`app/login/page.tsx`](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/app/login/page.tsx) (Sign-in), [`app/register/page.tsx`](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/app/register/page.tsx) (Registration), [`lib/i18n/useTranslation.ts`](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/i18n/useTranslation.ts) (Translations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and identity"]
  node_login["Sign-in<br/>[page.tsx]"]
  node_register["Registration<br/>[page.tsx]"]
end

subgraph group_developer["Developer experience"]
  node_dev_dashboard["Developer dashboard"]
  node_interviews["Interview practice<br/>[page.tsx]"]
  node_voice["Voice interviews"]
  node_certifications["Certifications"]
  node_forum["Developer forum<br/>[page.tsx]"]
  node_progress["Progress and ranking<br/>[page.tsx]"]
end

subgraph group_recruiter["Recruiter workflows"]
  node_recruiter_dashboard["Recruiter dashboard"]
  node_marketplace["Candidate marketplace<br/>[page.tsx]"]
  node_candidate["Candidate profile<br/>[page.tsx]"]
  node_pipeline["Hiring pipeline"]
  node_messaging["Messaging"]
  node_scheduling["Interview scheduling"]
end

subgraph group_services["Client services"]
  node_auth_hook["Authentication<br/>[useAuth.ts]"]
  node_auth_api["Auth API<br/>[auth.ts]"]
  node_api_index["API exports<br/>[index.ts]"]
  node_interview_hook["Interview state<br/>[useInterview.ts]"]
  node_stats_hook["Statistics data<br/>[useStats.ts]"]
  node_stats_api["Statistics API<br/>[stats.ts]"]
  node_market_hook["Marketplace data<br/>[useMarketplace.ts]"]
  node_market_api["Marketplace API<br/>[marketplace.ts]"]
end

subgraph group_shared["Shared foundations"]
  node_auth_state["Auth state<br/>[authStore.ts]"]
  node_translation["Translations<br/>[useTranslation.ts]"]
  node_translation_data["Translation catalog<br/>[translations.ts]"]
end

node_user(("User"))

node_user -->|"signs in"| node_login
node_user -->|"registers"| node_register
node_login -->|"submits credentials"| node_auth_hook
node_register -->|"creates account"| node_auth_hook
node_auth_hook -->|"calls auth API"| node_api_index
node_auth_hook -->|"updates session"| node_auth_state
node_api_index -->|"exports"| node_auth_api
node_user -.->|"practices"| node_interviews
node_interviews -->|"loads interview state"| node_interview_hook
node_user -.->|"practices by voice"| node_voice
node_user -.->|"pursues certification"| node_certifications
node_user -->|"joins discussion"| node_forum
node_user -->|"reviews progress"| node_progress
node_progress -->|"loads statistics"| node_stats_hook
node_stats_hook -->|"fetches statistics"| node_stats_api
node_user -.->|"browses candidates"| node_marketplace
node_user -->|"reviews profile"| node_candidate
node_candidate -->|"loads marketplace data"| node_market_hook
node_market_hook -->|"fetches listings"| node_market_api
node_user -.->|"manages hiring"| node_pipeline
node_user -.->|"exchanges messages"| node_messaging
node_user -.->|"coordinates interviews"| node_scheduling
node_login -->|"translates labels"| node_translation
node_register -->|"translates labels"| node_translation
node_translation -->|"looks up strings"| node_translation_data

click node_login "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/app/login/page.tsx"
click node_register "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/app/register/page.tsx"
click node_auth_hook "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/hooks/useAuth.ts"
click node_auth_api "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/api/auth.ts"
click node_api_index "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/api/index.ts"
click node_auth_state "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/stores/authStore.ts"
click node_dev_dashboard "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/components/dashboard/dashboard-content.tsx"
click node_interviews "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/app/dashboard/interviews/session/page.tsx"
click node_interview_hook "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/hooks/useInterview.ts"
click node_voice "https://github.com/skillforge-fullstack/skillforge-frontend/tree/main/app/dashboard/interviews/voice"
click node_certifications "https://github.com/skillforge-fullstack/skillforge-frontend/tree/main/app/dashboard/certifications"
click node_forum "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/app/dashboard/forum/page.tsx"
click node_progress "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/app/dashboard/progress/page.tsx"
click node_stats_hook "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/hooks/useStats.ts"
click node_stats_api "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/api/stats.ts"
click node_recruiter_dashboard "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/components/recruiter/recruiter-dashboard-content.tsx"
click node_marketplace "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/app/recruiter/marketplace/page.tsx"
click node_candidate "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/app/recruiter/candidates/%5Bid%5D/page.tsx"
click node_market_hook "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/hooks/useMarketplace.ts"
click node_market_api "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/api/marketplace.ts"
click node_pipeline "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/components/recruiter/pipeline-content.tsx"
click node_messaging "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/components/messaging/messaging-content.tsx"
click node_scheduling "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/components/recruiter/scheduling-content.tsx"
click node_translation "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/i18n/useTranslation.ts"
click node_translation_data "https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/i18n/translations.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_login,node_register,node_user toneBlue
class node_dev_dashboard,node_interviews,node_voice,node_certifications,node_forum,node_progress toneAmber
class node_recruiter_dashboard,node_marketplace,node_candidate,node_pipeline,node_messaging,node_scheduling toneMint
class node_auth_hook,node_auth_api,node_api_index,node_interview_hook,node_stats_hook,node_stats_api,node_market_hook,node_market_api toneRose
class node_auth_state,node_translation,node_translation_data toneIndigo
```

## Components

### Entry and identity

- [Sign-in](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/app/login/page.tsx): `app/login/page.tsx`
- [Registration](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/app/register/page.tsx): `app/register/page.tsx`

### Developer experience

- [Developer dashboard](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/components/dashboard/dashboard-content.tsx): `components/dashboard/dashboard-content.tsx`
- [Interview practice](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/app/dashboard/interviews/session/page.tsx): `app/dashboard/interviews/session/page.tsx`
- [Voice interviews](https://github.com/skillforge-fullstack/skillforge-frontend/tree/main/app/dashboard/interviews/voice): `app/dashboard/interviews/voice`
- [Certifications](https://github.com/skillforge-fullstack/skillforge-frontend/tree/main/app/dashboard/certifications): `app/dashboard/certifications`
- [Developer forum](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/app/dashboard/forum/page.tsx): `app/dashboard/forum/page.tsx`
- [Progress and ranking](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/app/dashboard/progress/page.tsx): `app/dashboard/progress/page.tsx`

### Recruiter workflows

- [Recruiter dashboard](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/components/recruiter/recruiter-dashboard-content.tsx): `components/recruiter/recruiter-dashboard-content.tsx`
- [Candidate marketplace](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/app/recruiter/marketplace/page.tsx): `app/recruiter/marketplace/page.tsx`
- [Candidate profile](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/app/recruiter/candidates/%5Bid%5D/page.tsx): `app/recruiter/candidates/[id]/page.tsx`
- [Hiring pipeline](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/components/recruiter/pipeline-content.tsx): `components/recruiter/pipeline-content.tsx`
- [Messaging](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/components/messaging/messaging-content.tsx): `components/messaging/messaging-content.tsx`
- [Interview scheduling](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/components/recruiter/scheduling-content.tsx): `components/recruiter/scheduling-content.tsx`

### Client services

- [Authentication](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/hooks/useAuth.ts): `lib/hooks/useAuth.ts`
- [Auth API](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/api/auth.ts): `lib/api/auth.ts`
- [API exports](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/api/index.ts): `lib/api/index.ts`
- [Interview state](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/hooks/useInterview.ts): `lib/hooks/useInterview.ts`
- [Statistics data](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/hooks/useStats.ts): `lib/hooks/useStats.ts`
- [Statistics API](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/api/stats.ts): `lib/api/stats.ts`
- [Marketplace data](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/hooks/useMarketplace.ts): `lib/hooks/useMarketplace.ts`
- [Marketplace API](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/api/marketplace.ts): `lib/api/marketplace.ts`

### Shared foundations

- [Auth state](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/stores/authStore.ts): `lib/stores/authStore.ts`
- [Translations](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/i18n/useTranslation.ts): `lib/i18n/useTranslation.ts`
- [Translation catalog](https://github.com/skillforge-fullstack/skillforge-frontend/blob/main/lib/i18n/translations.ts): `lib/i18n/translations.ts`

### Other components

- **User**

## Connections

- User → Sign-in: signs in (evidence: `app/login/page.tsx`)
- User → Registration: registers (evidence: `app/register/page.tsx`)
- Sign-in → Authentication: submits credentials (evidence: `app/login/page.tsx`)
- Registration → Authentication: creates account (evidence: `app/register/page.tsx`)
- Authentication → API exports: calls auth API (evidence: `lib/hooks/useAuth.ts`)
- Authentication → Auth state: updates session (evidence: `lib/hooks/useAuth.ts`)
- API exports → Auth API: exports (evidence: `lib/api/index.ts`)
- User → Interview practice: practices
- Interview practice → Interview state: loads interview state (evidence: `app/dashboard/interviews/session/page.tsx`)
- User → Voice interviews: practices by voice
- User → Certifications: pursues certification
- User → Developer forum: joins discussion (evidence: `app/dashboard/forum/page.tsx`)
- User → Progress and ranking: reviews progress (evidence: `app/dashboard/progress/page.tsx`)
- Progress and ranking → Statistics data: loads statistics (evidence: `app/dashboard/progress/page.tsx`)
- Statistics data → Statistics API: fetches statistics (evidence: `lib/hooks/useStats.ts`)
- User → Candidate marketplace: browses candidates
- User → Candidate profile: reviews profile (evidence: `app/recruiter/candidates/[id]/page.tsx`)
- Candidate profile → Marketplace data: loads marketplace data (evidence: `app/recruiter/candidates/[id]/page.tsx`)
- Marketplace data → Marketplace API: fetches listings (evidence: `lib/hooks/useMarketplace.ts`)
- User → Hiring pipeline: manages hiring
- User → Messaging: exchanges messages
- User → Interview scheduling: coordinates interviews
- Sign-in → Translations: translates labels (evidence: `app/login/page.tsx`)
- Registration → Translations: translates labels (evidence: `app/register/page.tsx`)
- Translations → Translation catalog: looks up strings (evidence: `lib/i18n/useTranslation.ts`)
