# umarabdullaf/cloud-career-os architecture

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

- Interactive diagram: https://gitdiagram.com/umarabdullaf/cloud-career-os
- Repository: https://github.com/umarabdullaf/cloud-career-os

## Overview

Cloud Career OS is a local-first career-development dashboard. A student uses the dashboard to review learning progress, then records curriculum evidence, competencies, job applications, internship outcomes, and LinkedIn drafts; the app keeps progress in browser storage and supports backup export/import. The UI is mounted through `main.tsx`, while `App.tsx` provides shared state and selects feature views. The README documents local storage and backup behavior; some feature implementations are represented from the source index rather than fully sampled.

Main entry points: [`src/context/AppContext.tsx`](https://github.com/umarabdullaf/cloud-career-os/blob/main/src/context/AppContext.tsx) (App state and actions), [`src/App.tsx`](https://github.com/umarabdullaf/cloud-career-os/blob/main/src/App.tsx) (App and routing), [`src/components/Dashboard.tsx`](https://github.com/umarabdullaf/cloud-career-os/blob/main/src/components/Dashboard.tsx) (Progress dashboard), [`src/main.tsx`](https://github.com/umarabdullaf/cloud-career-os/blob/main/src/main.tsx) (React mount)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Application shell"]
  node_mount["React mount<br/>[main.tsx]"]
  node_app["App and routing<br/>[App.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
end

subgraph group_learning["Learning progress"]
  node_dashboard["Progress dashboard<br/>[Dashboard.tsx]"]
  node_curriculum["Curriculum and evidence<br/>[CurriculumView.tsx]"]
  node_competency["Competency matrix"]
  node_curriculumdata["Curriculum plan<br/>[curriculumData.ts]"]
  node_competencydata["Initial competencies<br/>[competencyData.ts]"]
end

subgraph group_career["Career tracking"]
  node_jobs["Job tracker<br/>[JobTracker.tsx]"]
  node_jobdata["Starter opportunities<br/>[initialJobsData.ts]"]
  node_internship["Internship return hub"]
  node_linkedin["LinkedIn planner"]
  node_backup["Data backup"]
end

subgraph group_state["Shared state and data"]
  node_context["App state and actions<br/>[AppContext.tsx]"]
  node_types["Domain types<br/>[types.ts]"]
  node_storage[("Browser local storage")]
end

node_student(("Student"))

node_student -->|"opens app"| node_mount
node_mount -->|"mounts"| node_app
node_app -->|"provides state"| node_context
node_app -->|"renders"| node_navbar
node_app -->|"selects view"| node_dashboard
node_app -->|"selects view"| node_curriculum
node_app -->|"selects view"| node_jobs
node_app -->|"selects view"| node_internship
node_app -->|"selects view"| node_competency
node_app -->|"selects view"| node_linkedin
node_app -->|"renders modal"| node_backup
node_dashboard -->|"requests navigation"| node_app
node_dashboard -->|"reads and updates"| node_context
node_curriculum -->|"updates progress"| node_context
node_competency -->|"updates ratings"| node_context
node_jobs -->|"manages opportunities"| node_context
node_internship -->|"manages journal"| node_context
node_linkedin -->|"uses shared state"| node_context
node_backup -->|"imports and exports"| node_context
node_context -->|"loads defaults"| node_curriculumdata
node_context -->|"loads defaults"| node_competencydata
node_context -->|"loads defaults"| node_jobdata
node_context -->|"persists progress"| node_storage
node_context -->|"uses domain shapes"| node_types

click node_mount "https://github.com/umarabdullaf/cloud-career-os/blob/main/src/main.tsx"
click node_app "https://github.com/umarabdullaf/cloud-career-os/blob/main/src/App.tsx"
click node_navbar "https://github.com/umarabdullaf/cloud-career-os/blob/main/src/components/Navbar.tsx"
click node_dashboard "https://github.com/umarabdullaf/cloud-career-os/blob/main/src/components/Dashboard.tsx"
click node_curriculum "https://github.com/umarabdullaf/cloud-career-os/blob/main/src/components/CurriculumView.tsx"
click node_competency "https://github.com/umarabdullaf/cloud-career-os/blob/main/src/components/CompetencyMatrix.tsx"
click node_curriculumdata "https://github.com/umarabdullaf/cloud-career-os/blob/main/src/data/curriculumData.ts"
click node_competencydata "https://github.com/umarabdullaf/cloud-career-os/blob/main/src/data/competencyData.ts"
click node_jobs "https://github.com/umarabdullaf/cloud-career-os/blob/main/src/components/JobTracker.tsx"
click node_jobdata "https://github.com/umarabdullaf/cloud-career-os/blob/main/src/data/initialJobsData.ts"
click node_internship "https://github.com/umarabdullaf/cloud-career-os/blob/main/src/components/InternshipReturnHub.tsx"
click node_linkedin "https://github.com/umarabdullaf/cloud-career-os/blob/main/src/components/LinkedInPlanner.tsx"
click node_backup "https://github.com/umarabdullaf/cloud-career-os/blob/main/src/components/DataBackupModal.tsx"
click node_context "https://github.com/umarabdullaf/cloud-career-os/blob/main/src/context/AppContext.tsx"
click node_types "https://github.com/umarabdullaf/cloud-career-os/blob/main/src/types.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_mount,node_app,node_navbar toneBlue
class node_dashboard,node_curriculum,node_competency,node_curriculumdata,node_competencydata toneAmber
class node_jobs,node_jobdata,node_internship,node_linkedin,node_backup toneMint
class node_context,node_types,node_storage toneRose
class node_student toneIndigo
```

## Components

### Application shell

- [React mount](https://github.com/umarabdullaf/cloud-career-os/blob/main/src/main.tsx): `src/main.tsx`
- [App and routing](https://github.com/umarabdullaf/cloud-career-os/blob/main/src/App.tsx): `src/App.tsx`
- [Navigation](https://github.com/umarabdullaf/cloud-career-os/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`

### Learning progress

- [Progress dashboard](https://github.com/umarabdullaf/cloud-career-os/blob/main/src/components/Dashboard.tsx): `src/components/Dashboard.tsx`
- [Curriculum and evidence](https://github.com/umarabdullaf/cloud-career-os/blob/main/src/components/CurriculumView.tsx): `src/components/CurriculumView.tsx`
- [Competency matrix](https://github.com/umarabdullaf/cloud-career-os/blob/main/src/components/CompetencyMatrix.tsx): `src/components/CompetencyMatrix.tsx`
- [Curriculum plan](https://github.com/umarabdullaf/cloud-career-os/blob/main/src/data/curriculumData.ts): `src/data/curriculumData.ts`
- [Initial competencies](https://github.com/umarabdullaf/cloud-career-os/blob/main/src/data/competencyData.ts): `src/data/competencyData.ts`

### Career tracking

- [Job tracker](https://github.com/umarabdullaf/cloud-career-os/blob/main/src/components/JobTracker.tsx): `src/components/JobTracker.tsx`
- [Starter opportunities](https://github.com/umarabdullaf/cloud-career-os/blob/main/src/data/initialJobsData.ts): `src/data/initialJobsData.ts`
- [Internship return hub](https://github.com/umarabdullaf/cloud-career-os/blob/main/src/components/InternshipReturnHub.tsx): `src/components/InternshipReturnHub.tsx`
- [LinkedIn planner](https://github.com/umarabdullaf/cloud-career-os/blob/main/src/components/LinkedInPlanner.tsx): `src/components/LinkedInPlanner.tsx`
- [Data backup](https://github.com/umarabdullaf/cloud-career-os/blob/main/src/components/DataBackupModal.tsx): `src/components/DataBackupModal.tsx`

### Shared state and data

- [App state and actions](https://github.com/umarabdullaf/cloud-career-os/blob/main/src/context/AppContext.tsx): `src/context/AppContext.tsx`
- [Domain types](https://github.com/umarabdullaf/cloud-career-os/blob/main/src/types.ts): `src/types.ts`
- **Browser local storage**

### Other components

- **Student**

## Connections

- Student → React mount: opens app (evidence: `src/main.tsx`)
- React mount → App and routing: mounts (evidence: `src/main.tsx`)
- App and routing → App state and actions: provides state (evidence: `src/App.tsx`)
- App and routing → Navigation: renders (evidence: `src/App.tsx`)
- App and routing → Progress dashboard: selects view (evidence: `src/App.tsx`)
- App and routing → Curriculum and evidence: selects view (evidence: `src/App.tsx`)
- App and routing → Job tracker: selects view (evidence: `src/App.tsx`)
- App and routing → Internship return hub: selects view (evidence: `src/App.tsx`)
- App and routing → Competency matrix: selects view (evidence: `src/App.tsx`)
- App and routing → LinkedIn planner: selects view (evidence: `src/App.tsx`)
- App and routing → Data backup: renders modal (evidence: `src/App.tsx`)
- Progress dashboard → App and routing: requests navigation (evidence: `src/components/Dashboard.tsx`)
- Progress dashboard → App state and actions: reads and updates (evidence: `src/components/Dashboard.tsx`)
- Curriculum and evidence → App state and actions: updates progress (evidence: `src/components/CurriculumView.tsx`)
- Competency matrix → App state and actions: updates ratings (evidence: `src/components/CompetencyMatrix.tsx`)
- Job tracker → App state and actions: manages opportunities (evidence: `src/components/JobTracker.tsx`)
- Internship return hub → App state and actions: manages journal (evidence: `src/components/InternshipReturnHub.tsx`)
- LinkedIn planner → App state and actions: uses shared state (evidence: `src/App.tsx`)
- Data backup → App state and actions: imports and exports (evidence: `src/components/DataBackupModal.tsx`)
- App state and actions → Curriculum plan: loads defaults (evidence: `src/context/AppContext.tsx`)
- App state and actions → Initial competencies: loads defaults (evidence: `src/context/AppContext.tsx`)
- App state and actions → Starter opportunities: loads defaults (evidence: `src/context/AppContext.tsx`)
- App state and actions → Browser local storage: persists progress (evidence: `README.md`)
- App state and actions → Domain types: uses domain shapes (evidence: `src/context/AppContext.tsx`)
