# siddu77720/skillorbit architecture

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

- Interactive diagram: https://gitdiagram.com/siddu77720/skillorbit
- Repository: https://github.com/siddu77720/skillorbit

## Overview

SkillOrbit is a career-navigation platform: users sign in, add profile and skill evidence, then explore job matches and career-development tools. The React app mounts these features around shared persisted Zustand state; components call the AI client or local job/skill utilities where the source index documents those dependencies. The README also identifies the 3D Galaxy Map, Dream Job Mode, Skill Score, AI Assistant, dashboard, and project recommendations. Some component internals were not excerpted, so links for those features are limited to documented capabilities and indexed references.

Main entry points: [`src/App.jsx`](https://github.com/siddu77720/skillorbit/blob/main/src/App.jsx) (App shell), [`src/store/useStore.js`](https://github.com/siddu77720/skillorbit/blob/main/src/store/useStore.js) (User state), [`src/utils/groqClient.js`](https://github.com/siddu77720/skillorbit/blob/main/src/utils/groqClient.js) (AI client), [`src/components/Dashboard.jsx`](https://github.com/siddu77720/skillorbit/blob/main/src/components/Dashboard.jsx) (Progress dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App and access"]
  node_app["App shell<br/>[App.jsx]"]
  node_login["Login<br/>[Login.jsx]"]
  node_navbar["Navigation<br/>[Navbar.jsx]"]
  node_hero["Welcome<br/>[Hero.jsx]"]
end

subgraph group_profile["Profile and skills"]
  node_profile_input["Profile input<br/>[ProfileInput.jsx]"]
  node_resume_upload["Resume builder<br/>[ResumeUpload.jsx]"]
  node_skill_input["Skill input<br/>[SkillInput.jsx]"]
  node_assessment["Skill assessment<br/>[Assessment.jsx]"]
end

subgraph group_matching["Job matching"]
  node_dashboard["Progress dashboard<br/>[Dashboard.jsx]"]
  node_galaxy["Galaxy job map<br/>[GalaxyMap.jsx]"]
  node_job_data["Job listings<br/>[jobData.js]"]
  node_skill_matcher["Skill matcher<br/>[skillMatcher.js]"]
  node_history["Job history<br/>[History.jsx]"]
end

subgraph group_career["Career development"]
  node_dream_job["Dream job roadmap<br/>[DreamJobMode.jsx]"]
  node_skill_score["Skill score<br/>[SkillScore.jsx]"]
  node_projects["Project recommendations"]
  node_career_path["Career path<br/>[CareerPath.jsx]"]
  node_assistant["AI assistant<br/>[AIAssistant.jsx]"]
  node_skill_links["Skill resources<br/>[skillLinks.js]"]
end

subgraph group_services["Shared services"]
  node_store[("User state<br/>[useStore.js]")]
  node_groq["AI client<br/>[groqClient.js]"]
end

node_user(("User"))
node_groq_api{{"Groq API"}}

node_user -->|"uses"| node_app
node_app -->|"shows when logged out"| node_login
node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_hero
node_app -->|"renders"| node_profile_input
node_app -->|"renders"| node_skill_input
node_app -->|"renders"| node_dashboard
node_app -->|"renders"| node_galaxy
node_app -->|"renders"| node_dream_job
node_app -->|"renders"| node_assessment
node_app -->|"renders"| node_projects
node_app -->|"renders"| node_resume_upload
node_app -->|"renders"| node_career_path
node_app -->|"renders"| node_history
node_app -->|"renders"| node_assistant
node_app -->|"checks login state"| node_store
node_login -->|"updates login state"| node_store
node_navbar -->|"reads and updates profile"| node_store
node_profile_input -->|"updates profile data"| node_store
node_profile_input -->|"requests profile analysis"| node_groq
node_skill_input -->|"updates skills"| node_store
node_resume_upload -->|"reads profile and skills"| node_store
node_resume_upload -->|"generates resume content"| node_groq
node_assessment -->|"reads and records score"| node_store
node_assessment -->|"generates questions"| node_groq
node_dashboard -->|"reads progress"| node_store
node_dashboard -->|"gets job listings"| node_job_data
node_dashboard -->|"calculates matches"| node_skill_matcher
node_galaxy -->|"reads skills and records jobs"| node_store
node_galaxy -->|"gets job listings"| node_job_data
node_galaxy -->|"compares job skills"| node_skill_matcher
node_history -->|"reads job history"| node_store
node_dream_job -->|"reads and saves roadmap"| node_store
node_dream_job -->|"generates roadmap"| node_groq
node_dream_job -->|"uses learning resources"| node_skill_links
node_skill_score -->|"reads skills"| node_store
node_skill_score -->|"gets job listings"| node_job_data
node_skill_score -->|"calculates skill score"| node_skill_matcher
node_projects -->|"reads skills"| node_store
node_projects -->|"requests recommendations"| node_groq
node_career_path -->|"reads skills"| node_store
node_assistant -->|"reads assistant context"| node_store
node_assistant -->|"sends chat requests"| node_groq
node_groq -->|"sends prompts"| node_groq_api

click node_app "https://github.com/siddu77720/skillorbit/blob/main/src/App.jsx"
click node_login "https://github.com/siddu77720/skillorbit/blob/main/src/components/Login.jsx"
click node_navbar "https://github.com/siddu77720/skillorbit/blob/main/src/components/Navbar.jsx"
click node_hero "https://github.com/siddu77720/skillorbit/blob/main/src/components/Hero.jsx"
click node_profile_input "https://github.com/siddu77720/skillorbit/blob/main/src/components/ProfileInput.jsx"
click node_resume_upload "https://github.com/siddu77720/skillorbit/blob/main/src/components/ResumeUpload.jsx"
click node_skill_input "https://github.com/siddu77720/skillorbit/blob/main/src/components/SkillInput.jsx"
click node_assessment "https://github.com/siddu77720/skillorbit/blob/main/src/components/Assessment.jsx"
click node_store "https://github.com/siddu77720/skillorbit/blob/main/src/store/useStore.js"
click node_dashboard "https://github.com/siddu77720/skillorbit/blob/main/src/components/Dashboard.jsx"
click node_galaxy "https://github.com/siddu77720/skillorbit/blob/main/src/components/GalaxyMap.jsx"
click node_job_data "https://github.com/siddu77720/skillorbit/blob/main/src/utils/jobData.js"
click node_skill_matcher "https://github.com/siddu77720/skillorbit/blob/main/src/utils/skillMatcher.js"
click node_history "https://github.com/siddu77720/skillorbit/blob/main/src/components/History.jsx"
click node_dream_job "https://github.com/siddu77720/skillorbit/blob/main/src/components/DreamJobMode.jsx"
click node_skill_score "https://github.com/siddu77720/skillorbit/blob/main/src/components/SkillScore.jsx"
click node_projects "https://github.com/siddu77720/skillorbit/blob/main/src/components/ProjectRecommendations.jsx"
click node_career_path "https://github.com/siddu77720/skillorbit/blob/main/src/components/CareerPath.jsx"
click node_assistant "https://github.com/siddu77720/skillorbit/blob/main/src/components/AIAssistant.jsx"
click node_skill_links "https://github.com/siddu77720/skillorbit/blob/main/src/utils/skillLinks.js"
click node_groq "https://github.com/siddu77720/skillorbit/blob/main/src/utils/groqClient.js"

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_login,node_navbar,node_hero,node_user toneBlue
class node_profile_input,node_resume_upload,node_skill_input,node_assessment toneAmber
class node_dashboard,node_galaxy,node_job_data,node_skill_matcher,node_history,node_groq_api toneMint
class node_dream_job,node_skill_score,node_projects,node_career_path,node_assistant,node_skill_links toneRose
class node_store,node_groq toneIndigo
```

## Components

### App and access

- [App shell](https://github.com/siddu77720/skillorbit/blob/main/src/App.jsx): `src/App.jsx`
- [Login](https://github.com/siddu77720/skillorbit/blob/main/src/components/Login.jsx): `src/components/Login.jsx`
- [Navigation](https://github.com/siddu77720/skillorbit/blob/main/src/components/Navbar.jsx): `src/components/Navbar.jsx`
- [Welcome](https://github.com/siddu77720/skillorbit/blob/main/src/components/Hero.jsx): `src/components/Hero.jsx`

### Profile and skills

- [Profile input](https://github.com/siddu77720/skillorbit/blob/main/src/components/ProfileInput.jsx): `src/components/ProfileInput.jsx`
- [Resume builder](https://github.com/siddu77720/skillorbit/blob/main/src/components/ResumeUpload.jsx): `src/components/ResumeUpload.jsx`
- [Skill input](https://github.com/siddu77720/skillorbit/blob/main/src/components/SkillInput.jsx): `src/components/SkillInput.jsx`
- [Skill assessment](https://github.com/siddu77720/skillorbit/blob/main/src/components/Assessment.jsx): `src/components/Assessment.jsx`

### Job matching

- [Progress dashboard](https://github.com/siddu77720/skillorbit/blob/main/src/components/Dashboard.jsx): `src/components/Dashboard.jsx`
- [Galaxy job map](https://github.com/siddu77720/skillorbit/blob/main/src/components/GalaxyMap.jsx): `src/components/GalaxyMap.jsx`
- [Job listings](https://github.com/siddu77720/skillorbit/blob/main/src/utils/jobData.js): `src/utils/jobData.js`
- [Skill matcher](https://github.com/siddu77720/skillorbit/blob/main/src/utils/skillMatcher.js): `src/utils/skillMatcher.js`
- [Job history](https://github.com/siddu77720/skillorbit/blob/main/src/components/History.jsx): `src/components/History.jsx`

### Career development

- [Dream job roadmap](https://github.com/siddu77720/skillorbit/blob/main/src/components/DreamJobMode.jsx): `src/components/DreamJobMode.jsx`
- [Skill score](https://github.com/siddu77720/skillorbit/blob/main/src/components/SkillScore.jsx): `src/components/SkillScore.jsx`
- [Project recommendations](https://github.com/siddu77720/skillorbit/blob/main/src/components/ProjectRecommendations.jsx): `src/components/ProjectRecommendations.jsx`
- [Career path](https://github.com/siddu77720/skillorbit/blob/main/src/components/CareerPath.jsx): `src/components/CareerPath.jsx`
- [AI assistant](https://github.com/siddu77720/skillorbit/blob/main/src/components/AIAssistant.jsx): `src/components/AIAssistant.jsx`
- [Skill resources](https://github.com/siddu77720/skillorbit/blob/main/src/utils/skillLinks.js): `src/utils/skillLinks.js`

### Shared services

- [User state](https://github.com/siddu77720/skillorbit/blob/main/src/store/useStore.js): `src/store/useStore.js`
- [AI client](https://github.com/siddu77720/skillorbit/blob/main/src/utils/groqClient.js): `src/utils/groqClient.js`

### Other components

- **User**
- **Groq API**

## Connections

- User → App shell: uses (evidence: `src/App.jsx`)
- App shell → Login: shows when logged out (evidence: `src/App.jsx`)
- App shell → Navigation: renders (evidence: `src/App.jsx`)
- App shell → Welcome: renders (evidence: `src/App.jsx`)
- App shell → Profile input: renders (evidence: `src/App.jsx`)
- App shell → Skill input: renders (evidence: `src/App.jsx`)
- App shell → Progress dashboard: renders (evidence: `src/App.jsx`)
- App shell → Galaxy job map: renders (evidence: `src/App.jsx`)
- App shell → Dream job roadmap: renders (evidence: `src/App.jsx`)
- App shell → Skill assessment: renders (evidence: `src/App.jsx`)
- App shell → Project recommendations: renders (evidence: `src/App.jsx`)
- App shell → Resume builder: renders (evidence: `src/App.jsx`)
- App shell → Career path: renders (evidence: `src/App.jsx`)
- App shell → Job history: renders (evidence: `src/App.jsx`)
- App shell → AI assistant: renders (evidence: `src/App.jsx`)
- App shell → User state: checks login state (evidence: `src/App.jsx`)
- Login → User state: updates login state (evidence: `src/components/Login.jsx`)
- Navigation → User state: reads and updates profile (evidence: `src/components/Navbar.jsx`)
- Profile input → User state: updates profile data (evidence: `src/components/ProfileInput.jsx`)
- Profile input → AI client: requests profile analysis (evidence: `src/components/ProfileInput.jsx`)
- Skill input → User state: updates skills (evidence: `src/components/SkillInput.jsx`)
- Resume builder → User state: reads profile and skills (evidence: `src/components/ResumeUpload.jsx`)
- Resume builder → AI client: generates resume content (evidence: `src/components/ResumeUpload.jsx`)
- Skill assessment → User state: reads and records score (evidence: `src/components/Assessment.jsx`)
- Skill assessment → AI client: generates questions (evidence: `src/components/Assessment.jsx`)
- Progress dashboard → User state: reads progress (evidence: `src/components/Dashboard.jsx`)
- Progress dashboard → Job listings: gets job listings (evidence: `src/components/Dashboard.jsx`)
- Progress dashboard → Skill matcher: calculates matches (evidence: `src/components/Dashboard.jsx`)
- Galaxy job map → User state: reads skills and records jobs (evidence: `src/components/GalaxyMap.jsx`)
- Galaxy job map → Job listings: gets job listings (evidence: `src/components/GalaxyMap.jsx`)
- Galaxy job map → Skill matcher: compares job skills (evidence: `src/components/GalaxyMap.jsx`)
- Job history → User state: reads job history (evidence: `src/components/History.jsx`)
- Dream job roadmap → User state: reads and saves roadmap (evidence: `src/components/DreamJobMode.jsx`)
- Dream job roadmap → AI client: generates roadmap (evidence: `src/components/DreamJobMode.jsx`)
- Dream job roadmap → Skill resources: uses learning resources (evidence: `src/components/DreamJobMode.jsx`)
- Skill score → User state: reads skills (evidence: `src/components/SkillScore.jsx`)
- Skill score → Job listings: gets job listings (evidence: `src/components/SkillScore.jsx`)
- Skill score → Skill matcher: calculates skill score (evidence: `src/components/SkillScore.jsx`)
- Project recommendations → User state: reads skills (evidence: `src/components/ProjectRecommendations.jsx`)
- Project recommendations → AI client: requests recommendations (evidence: `src/components/ProjectRecommendations.jsx`)
- Career path → User state: reads skills (evidence: `src/components/CareerPath.jsx`)
- AI assistant → User state: reads assistant context (evidence: `src/components/AIAssistant.jsx`)
- AI assistant → AI client: sends chat requests (evidence: `src/components/AIAssistant.jsx`)
- AI client → Groq API: sends prompts (evidence: `src/utils/groqClient.js`)
