# maheenniazi/orbit-web architecture

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

- Interactive diagram: https://gitdiagram.com/maheenniazi/orbit-web
- Repository: https://github.com/maheenniazi/orbit-web

## Overview

orbit is a local-first student workspace: students import course material, organize schedules and notes, plan study, and use focused AI and career tools. The browser app routes between these features and persists data in browser storage; optional local-server mode adds provider-backed AI, richer job search, and page reading. The graph includes documented major capabilities, but some are represented by their enclosing feature module because their detailed implementation was not sampled. Relationships follow excerpts, indexed imports, or README statements; unsampled wiring is omitted.

Main entry points: [`public/js/app.js`](https://github.com/maheenniazi/orbit-web/blob/main/public/js/app.js) (App router), [`public/js/ai.js`](https://github.com/maheenniazi/orbit-web/blob/main/public/js/ai.js) (AI client), [`public/js/store.js`](https://github.com/maheenniazi/orbit-web/blob/main/public/js/store.js) (Local state), [`server.js`](https://github.com/maheenniazi/orbit-web/blob/main/server.js) (Local server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Student workspace"]
  node_app["App router<br/>[app.js]"]
  node_dashboard["Dashboard<br/>[dashboard.js]"]
  node_calendar["Calendar<br/>[calendar.js]"]
  node_spotify["Spotify player<br/>[spotify.js]"]
end

subgraph group_study["Study planning"]
  node_syllabus["Syllabus import<br/>[syllabus.js]"]
  node_file_reader["File reader<br/>[fileread.js]"]
  node_focus["Focus and study plans<br/>[focus.js]"]
  node_exam_prep["Exam prep<br/>[examprep.js]"]
  node_notes["Notes<br/>[notes.js]"]
end

subgraph group_intelligence["AI and content"]
  node_chat["Study assistant<br/>[chat.js]"]
  node_ai_client["AI client<br/>[ai.js]"]
  node_byoai["Browser AI providers<br/>[byoai.js]"]
  node_model_picker["Model picker<br/>[modelpicker.js]"]
end

subgraph group_career_degree["Career and degree"]
  node_degree["Degree planner<br/>[degree.js]"]
  node_degree_engine["Degree calculations<br/>[degree-engine.js]"]
  node_careers["Career workspace<br/>[careers.js]"]
  node_web_jobs["Browser job search<br/>[webjobs.js]"]
  node_jobs["Full job search<br/>[jobs.js]"]
end

subgraph group_runtime["Runtime services"]
  node_store[("Local state<br/>[store.js]")]
  node_ui["UI helpers<br/>[ui.js]"]
  node_util["Shared utilities<br/>[util.js]"]
  node_server["Local server<br/>[server.js]"]
  node_provider_runtime["AI provider runtime<br/>[ai-providers.js]"]
  node_websearch["Web search<br/>[websearch.js]"]
  node_pages["Page reader<br/>[pages.js]"]
end

node_student(("Student"))
node_ai_services{{"AI services"}}
node_job_sources{{"Job sources"}}
node_spotify_service{{"Spotify"}}
node_browser_storage[("Browser storage")]

node_student -->|"uses"| node_app
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_calendar
node_app -->|"routes to"| node_syllabus
node_app -->|"routes to"| node_notes
node_app -->|"routes to"| node_chat
node_app -->|"routes to"| node_focus
node_app -->|"routes to"| node_degree
node_app -->|"routes to"| node_careers
node_dashboard -->|"reads"| node_store
node_calendar -->|"reads and updates"| node_store
node_syllabus -->|"reads files with"| node_file_reader
node_syllabus -->|"updates events"| node_store
node_focus -->|"reads"| node_store
node_focus -->|"requests prep"| node_exam_prep
node_focus -->|"renders player"| node_spotify
node_notes -->|"requests prep"| node_exam_prep
node_notes -->|"reads files with"| node_file_reader
node_chat -->|"sends prompts"| node_ai_client
node_chat -->|"reads context"| node_store
node_exam_prep -->|"requests generation"| node_ai_client
node_ai_client -->|"calls in browser mode"| node_byoai
node_ai_client -->|"posts in server mode"| node_server
node_ai_client -->|"connects to"| node_ai_services
node_degree -->|"uses calculations"| node_degree_engine
node_degree -->|"requests parsing"| node_ai_client
node_careers -->|"searches in browser mode"| node_web_jobs
node_careers -->|"requests sources locally"| node_server
node_spotify -.->|"connects optionally"| node_spotify_service
node_server -->|"uses"| node_provider_runtime
node_server -->|"uses"| node_jobs
node_server -->|"uses"| node_pages
node_jobs -->|"uses"| node_websearch
node_jobs -->|"searches"| node_job_sources
node_store -->|"persists state"| node_browser_storage

click node_app "https://github.com/maheenniazi/orbit-web/blob/main/public/js/app.js"
click node_dashboard "https://github.com/maheenniazi/orbit-web/blob/main/public/js/dashboard.js"
click node_calendar "https://github.com/maheenniazi/orbit-web/blob/main/public/js/calendar.js"
click node_store "https://github.com/maheenniazi/orbit-web/blob/main/public/js/store.js"
click node_ui "https://github.com/maheenniazi/orbit-web/blob/main/public/js/ui.js"
click node_util "https://github.com/maheenniazi/orbit-web/blob/main/public/js/util.js"
click node_syllabus "https://github.com/maheenniazi/orbit-web/blob/main/public/js/syllabus.js"
click node_file_reader "https://github.com/maheenniazi/orbit-web/blob/main/public/js/fileread.js"
click node_focus "https://github.com/maheenniazi/orbit-web/blob/main/public/js/focus.js"
click node_exam_prep "https://github.com/maheenniazi/orbit-web/blob/main/public/js/examprep.js"
click node_notes "https://github.com/maheenniazi/orbit-web/blob/main/public/js/notes.js"
click node_chat "https://github.com/maheenniazi/orbit-web/blob/main/public/js/chat.js"
click node_ai_client "https://github.com/maheenniazi/orbit-web/blob/main/public/js/ai.js"
click node_byoai "https://github.com/maheenniazi/orbit-web/blob/main/public/js/byoai.js"
click node_model_picker "https://github.com/maheenniazi/orbit-web/blob/main/public/js/modelpicker.js"
click node_degree "https://github.com/maheenniazi/orbit-web/blob/main/public/js/degree.js"
click node_degree_engine "https://github.com/maheenniazi/orbit-web/blob/main/public/js/degree-engine.js"
click node_careers "https://github.com/maheenniazi/orbit-web/blob/main/public/js/careers.js"
click node_web_jobs "https://github.com/maheenniazi/orbit-web/blob/main/public/js/webjobs.js"
click node_spotify "https://github.com/maheenniazi/orbit-web/blob/main/public/js/spotify.js"
click node_server "https://github.com/maheenniazi/orbit-web/blob/main/server.js"
click node_provider_runtime "https://github.com/maheenniazi/orbit-web/blob/main/ai-providers.js"
click node_jobs "https://github.com/maheenniazi/orbit-web/blob/main/jobs.js"
click node_websearch "https://github.com/maheenniazi/orbit-web/blob/main/websearch.js"
click node_pages "https://github.com/maheenniazi/orbit-web/blob/main/pages.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_dashboard,node_calendar,node_spotify toneBlue
class node_syllabus,node_file_reader,node_focus,node_exam_prep,node_notes,node_browser_storage toneAmber
class node_chat,node_ai_client,node_byoai,node_model_picker toneMint
class node_degree,node_degree_engine,node_careers,node_web_jobs,node_jobs toneRose
class node_store,node_ui,node_util,node_server,node_provider_runtime,node_websearch,node_pages,node_student,node_ai_services,node_job_sources,node_spotify_service toneIndigo
```

## Components

### Student workspace

- [App router](https://github.com/maheenniazi/orbit-web/blob/main/public/js/app.js): `public/js/app.js`
- [Dashboard](https://github.com/maheenniazi/orbit-web/blob/main/public/js/dashboard.js): `public/js/dashboard.js`
- [Calendar](https://github.com/maheenniazi/orbit-web/blob/main/public/js/calendar.js): `public/js/calendar.js`
- [Spotify player](https://github.com/maheenniazi/orbit-web/blob/main/public/js/spotify.js): `public/js/spotify.js`

### Study planning

- [Syllabus import](https://github.com/maheenniazi/orbit-web/blob/main/public/js/syllabus.js): `public/js/syllabus.js`
- [File reader](https://github.com/maheenniazi/orbit-web/blob/main/public/js/fileread.js): `public/js/fileread.js`
- [Focus and study plans](https://github.com/maheenniazi/orbit-web/blob/main/public/js/focus.js): `public/js/focus.js`
- [Exam prep](https://github.com/maheenniazi/orbit-web/blob/main/public/js/examprep.js): `public/js/examprep.js`
- [Notes](https://github.com/maheenniazi/orbit-web/blob/main/public/js/notes.js): `public/js/notes.js`

### AI and content

- [Study assistant](https://github.com/maheenniazi/orbit-web/blob/main/public/js/chat.js): `public/js/chat.js`
- [AI client](https://github.com/maheenniazi/orbit-web/blob/main/public/js/ai.js): `public/js/ai.js`
- [Browser AI providers](https://github.com/maheenniazi/orbit-web/blob/main/public/js/byoai.js): `public/js/byoai.js`
- [Model picker](https://github.com/maheenniazi/orbit-web/blob/main/public/js/modelpicker.js): `public/js/modelpicker.js`

### Career and degree

- [Degree planner](https://github.com/maheenniazi/orbit-web/blob/main/public/js/degree.js): `public/js/degree.js`
- [Degree calculations](https://github.com/maheenniazi/orbit-web/blob/main/public/js/degree-engine.js): `public/js/degree-engine.js`
- [Career workspace](https://github.com/maheenniazi/orbit-web/blob/main/public/js/careers.js): `public/js/careers.js`
- [Browser job search](https://github.com/maheenniazi/orbit-web/blob/main/public/js/webjobs.js): `public/js/webjobs.js`
- [Full job search](https://github.com/maheenniazi/orbit-web/blob/main/jobs.js): `jobs.js`

### Runtime services

- [Local state](https://github.com/maheenniazi/orbit-web/blob/main/public/js/store.js): `public/js/store.js`
- [UI helpers](https://github.com/maheenniazi/orbit-web/blob/main/public/js/ui.js): `public/js/ui.js`
- [Shared utilities](https://github.com/maheenniazi/orbit-web/blob/main/public/js/util.js): `public/js/util.js`
- [Local server](https://github.com/maheenniazi/orbit-web/blob/main/server.js): `server.js`
- [AI provider runtime](https://github.com/maheenniazi/orbit-web/blob/main/ai-providers.js): `ai-providers.js`
- [Web search](https://github.com/maheenniazi/orbit-web/blob/main/websearch.js): `websearch.js`
- [Page reader](https://github.com/maheenniazi/orbit-web/blob/main/pages.js): `pages.js`

### Other components

- **Student**
- **AI services**
- **Job sources**
- **Spotify**
- **Browser storage**

## Connections

- Student → App router: uses (evidence: `README.md`)
- App router → Dashboard: routes to (evidence: `public/js/app.js`)
- App router → Calendar: routes to (evidence: `public/js/app.js`)
- App router → Syllabus import: routes to (evidence: `public/js/app.js`)
- App router → Notes: routes to (evidence: `public/js/app.js`)
- App router → Study assistant: routes to (evidence: `public/js/app.js`)
- App router → Focus and study plans: routes to (evidence: `public/js/app.js`)
- App router → Degree planner: routes to (evidence: `public/js/app.js`)
- App router → Career workspace: routes to (evidence: `public/js/app.js`)
- Dashboard → Local state: reads (evidence: `public/js/dashboard.js`)
- Calendar → Local state: reads and updates (evidence: `public/js/calendar.js`)
- Syllabus import → File reader: reads files with (evidence: `public/js/syllabus.js`)
- Syllabus import → Local state: updates events (evidence: `public/js/syllabus.js`)
- Focus and study plans → Local state: reads (evidence: `public/js/focus.js`)
- Focus and study plans → Exam prep: requests prep (evidence: `public/js/focus.js`)
- Focus and study plans → Spotify player: renders player (evidence: `public/js/focus.js`)
- Notes → Exam prep: requests prep (evidence: `public/js/notes.js`)
- Notes → File reader: reads files with (evidence: `public/js/notes.js`)
- Study assistant → AI client: sends prompts (evidence: `public/js/chat.js`)
- Study assistant → Local state: reads context (evidence: `public/js/chat.js`)
- Exam prep → AI client: requests generation (evidence: `public/js/examprep.js`)
- AI client → Browser AI providers: calls in browser mode (evidence: `public/js/ai.js`)
- AI client → Local server: posts in server mode (evidence: `public/js/ai.js`)
- AI client → AI services: connects to (evidence: `README.md`)
- Degree planner → Degree calculations: uses calculations (evidence: `public/js/degree.js`)
- Degree planner → AI client: requests parsing (evidence: `public/js/degree.js`)
- Career workspace → Browser job search: searches in browser mode (evidence: `public/js/careers.js`)
- Career workspace → Local server: requests sources locally (evidence: `public/js/careers.js`)
- Spotify player → Spotify: connects optionally (evidence: `README.md`)
- Local server → AI provider runtime: uses (evidence: `server.js`)
- Local server → Full job search: uses (evidence: `server.js`)
- Local server → Page reader: uses (evidence: `server.js`)
- Full job search → Web search: uses (evidence: `jobs.js`)
- Full job search → Job sources: searches (evidence: `README.md`)
- Local state → Browser storage: persists state (evidence: `public/js/store.js`)
