# karambaboy123/orbit architecture

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

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

## Overview

Orbit is a browser-only PWA for turning assignments, documents, and ideas into AI-ready prompts and checklists, then tracking work and personal growth. The principal flow is navigation to a creation tool, generation or structuring of content, and management of the resulting tasks; separate branches cover notes, weekly reviews, and portfolio development/export. State is held in browser storage, with backup and appearance controls. The graph follows documented capabilities and shown routing/calls; several feature internals are unsampled, so their connections are limited to documented relationships.

Main entry points: [`js/main.js`](https://github.com/karambaboy123/orbit/blob/main/js/main.js) (View router), [`js/views/portfolio-view.js`](https://github.com/karambaboy123/orbit/blob/main/js/views/portfolio-view.js) (Portfolio and goals), [`js/state.js`](https://github.com/karambaboy123/orbit/blob/main/js/state.js) (Browser app state), [`js/views/review.js`](https://github.com/karambaboy123/orbit/blob/main/js/views/review.js) (Weekly review)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Workflow creation"]
  node_newtask["New assignment<br/>[new-task.js]"]
  node_prompt["Prompt generator<br/>[prompt-gen.js]"]
  node_fileai["File to AI<br/>[file-to-ai.js]"]
  node_aicore["AI processing<br/>[ai.js]"]
  node_checklist["AI checklist<br/>[ai-checklist.js]"]
  node_launcher["AI launcher<br/>[launcher.js]"]
end

subgraph group_tracking["Work tracking"]
  node_analysis["Task analysis<br/>[analysis.js]"]
  node_dashboard["Dashboard<br/>[dash.js]"]
  node_notes["Notes<br/>[notes.js]"]
  node_review["Weekly review<br/>[review.js]"]
end

subgraph group_growth["Portfolio and growth"]
  node_portfolio["Portfolio and goals<br/>[portfolio-view.js]"]
  node_growth_analysis["Growth analysis"]
  node_goal_detail["Goal work<br/>[goal-detail.js]"]
  node_charts["Growth charts"]
end

subgraph group_platform["App platform"]
  node_app["Orbit app<br/>[index.html]"]
  node_router["View router<br/>[main.js]"]
  node_state[("Browser app state<br/>[state.js]")]
  node_backup["Backup and restore<br/>[backup.js]"]
  node_export["Export and import<br/>[ai.js]"]
  node_settings["Settings<br/>[settings.js]"]
  node_theme["Theme controls<br/>[theme.js]"]
  node_icons["Icon and font styles<br/>[icons.js]"]
  node_offline[("Offline cache<br/>[sw.js]")]
end

node_user(("Student or maker"))
node_ai_sites(("External AI sites"))

node_user -->|"opens"| node_app
node_app -->|"starts"| node_router
node_user -->|"enters assignment"| node_newtask
node_user -->|"describes goal"| node_prompt
node_user -->|"provides document"| node_fileai
node_router -->|"renders"| node_newtask
node_router -->|"renders"| node_prompt
node_router -->|"renders"| node_fileai
node_router -->|"renders"| node_checklist
node_router -->|"renders"| node_launcher
node_router -->|"renders"| node_analysis
node_router -->|"renders"| node_dashboard
node_router -->|"renders"| node_notes
node_router -->|"renders"| node_review
node_router -->|"renders"| node_portfolio
node_router -->|"renders"| node_goal_detail
node_user -.->|"requests generation"| node_aicore
node_aicore -->|"routes result"| node_analysis
node_user -->|"pastes AI output"| node_checklist
node_user -->|"chooses destination"| node_launcher
node_launcher -->|"opens site"| node_ai_sites
node_user -->|"manages goals"| node_portfolio
node_portfolio -->|"requests assessment"| node_growth_analysis
node_portfolio -.->|"opens goal"| node_goal_detail
node_portfolio -->|"shows growth charts"| node_charts
node_review -->|"saves planning"| node_notes
node_review -->|"saves planning"| node_analysis
node_aicore -->|"saves task"| node_state
node_checklist -.->|"saves checks"| node_state
node_state -.->|"supplies task data"| node_dashboard
node_state -->|"supplies review data"| node_review
node_user -->|"requests backup"| node_backup
node_backup -->|"restores data"| node_state
node_user -->|"exports or imports"| node_export
node_user -->|"customizes app"| node_settings
node_settings -.->|"sets appearance"| node_theme
node_settings -.->|"sets icon style"| node_icons
node_app -->|"caches app files"| node_offline

click node_app "https://github.com/karambaboy123/orbit/blob/main/index.html"
click node_router "https://github.com/karambaboy123/orbit/blob/main/js/main.js"
click node_newtask "https://github.com/karambaboy123/orbit/blob/main/js/views/new-task.js"
click node_prompt "https://github.com/karambaboy123/orbit/blob/main/js/views/prompt-gen.js"
click node_fileai "https://github.com/karambaboy123/orbit/blob/main/js/views/file-to-ai.js"
click node_aicore "https://github.com/karambaboy123/orbit/blob/main/js/ai.js"
click node_checklist "https://github.com/karambaboy123/orbit/blob/main/js/views/ai-checklist.js"
click node_launcher "https://github.com/karambaboy123/orbit/blob/main/js/views/launcher.js"
click node_analysis "https://github.com/karambaboy123/orbit/blob/main/js/views/analysis.js"
click node_dashboard "https://github.com/karambaboy123/orbit/blob/main/js/views/dash.js"
click node_notes "https://github.com/karambaboy123/orbit/blob/main/js/views/notes.js"
click node_review "https://github.com/karambaboy123/orbit/blob/main/js/views/review.js"
click node_portfolio "https://github.com/karambaboy123/orbit/blob/main/js/views/portfolio-view.js"
click node_growth_analysis "https://github.com/karambaboy123/orbit/blob/main/js/views/portfolio-analyse.js"
click node_goal_detail "https://github.com/karambaboy123/orbit/blob/main/js/views/goal-detail.js"
click node_charts "https://github.com/karambaboy123/orbit/blob/main/js/views/portfolio-charts.js"
click node_state "https://github.com/karambaboy123/orbit/blob/main/js/state.js"
click node_backup "https://github.com/karambaboy123/orbit/blob/main/js/backup.js"
click node_export "https://github.com/karambaboy123/orbit/blob/main/js/ai.js"
click node_settings "https://github.com/karambaboy123/orbit/blob/main/js/views/settings.js"
click node_theme "https://github.com/karambaboy123/orbit/blob/main/js/theme.js"
click node_icons "https://github.com/karambaboy123/orbit/blob/main/js/icons.js"
click node_offline "https://github.com/karambaboy123/orbit/blob/main/sw.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_newtask,node_prompt,node_fileai,node_aicore,node_checklist,node_launcher toneBlue
class node_analysis,node_dashboard,node_notes,node_review toneAmber
class node_portfolio,node_growth_analysis,node_goal_detail,node_charts toneMint
class node_app,node_router,node_state,node_backup,node_export,node_settings,node_theme,node_icons,node_offline toneRose
class node_user,node_ai_sites toneIndigo
```

## Components

### Workflow creation

- [New assignment](https://github.com/karambaboy123/orbit/blob/main/js/views/new-task.js): `js/views/new-task.js`
- [Prompt generator](https://github.com/karambaboy123/orbit/blob/main/js/views/prompt-gen.js): `js/views/prompt-gen.js`
- [File to AI](https://github.com/karambaboy123/orbit/blob/main/js/views/file-to-ai.js): `js/views/file-to-ai.js`
- [AI processing](https://github.com/karambaboy123/orbit/blob/main/js/ai.js): `js/ai.js`
- [AI checklist](https://github.com/karambaboy123/orbit/blob/main/js/views/ai-checklist.js): `js/views/ai-checklist.js`
- [AI launcher](https://github.com/karambaboy123/orbit/blob/main/js/views/launcher.js): `js/views/launcher.js`

### Work tracking

- [Task analysis](https://github.com/karambaboy123/orbit/blob/main/js/views/analysis.js): `js/views/analysis.js`
- [Dashboard](https://github.com/karambaboy123/orbit/blob/main/js/views/dash.js): `js/views/dash.js`
- [Notes](https://github.com/karambaboy123/orbit/blob/main/js/views/notes.js): `js/views/notes.js`
- [Weekly review](https://github.com/karambaboy123/orbit/blob/main/js/views/review.js): `js/views/review.js`

### Portfolio and growth

- [Portfolio and goals](https://github.com/karambaboy123/orbit/blob/main/js/views/portfolio-view.js): `js/views/portfolio-view.js`
- [Growth analysis](https://github.com/karambaboy123/orbit/blob/main/js/views/portfolio-analyse.js): `js/views/portfolio-analyse.js`
- [Goal work](https://github.com/karambaboy123/orbit/blob/main/js/views/goal-detail.js): `js/views/goal-detail.js`
- [Growth charts](https://github.com/karambaboy123/orbit/blob/main/js/views/portfolio-charts.js): `js/views/portfolio-charts.js`

### App platform

- [Orbit app](https://github.com/karambaboy123/orbit/blob/main/index.html): `index.html`
- [View router](https://github.com/karambaboy123/orbit/blob/main/js/main.js): `js/main.js`
- [Browser app state](https://github.com/karambaboy123/orbit/blob/main/js/state.js): `js/state.js`
- [Backup and restore](https://github.com/karambaboy123/orbit/blob/main/js/backup.js): `js/backup.js`
- [Export and import](https://github.com/karambaboy123/orbit/blob/main/js/ai.js): `js/ai.js`
- [Settings](https://github.com/karambaboy123/orbit/blob/main/js/views/settings.js): `js/views/settings.js`
- [Theme controls](https://github.com/karambaboy123/orbit/blob/main/js/theme.js): `js/theme.js`
- [Icon and font styles](https://github.com/karambaboy123/orbit/blob/main/js/icons.js): `js/icons.js`
- [Offline cache](https://github.com/karambaboy123/orbit/blob/main/sw.js): `sw.js`

### Other components

- **Student or maker**
- **External AI sites**

## Connections

- Student or maker → Orbit app: opens (evidence: `README.md`)
- Orbit app → View router: starts (evidence: `js/main.js`)
- Student or maker → New assignment: enters assignment (evidence: `README.md`)
- Student or maker → Prompt generator: describes goal (evidence: `README.md`)
- Student or maker → File to AI: provides document (evidence: `README.md`)
- View router → New assignment: renders (evidence: `js/main.js`)
- View router → Prompt generator: renders (evidence: `js/main.js`)
- View router → File to AI: renders (evidence: `js/main.js`)
- View router → AI checklist: renders (evidence: `js/main.js`)
- View router → AI launcher: renders (evidence: `js/main.js`)
- View router → Task analysis: renders (evidence: `js/main.js`)
- View router → Dashboard: renders (evidence: `js/main.js`)
- View router → Notes: renders (evidence: `js/main.js`)
- View router → Weekly review: renders (evidence: `js/main.js`)
- View router → Portfolio and goals: renders (evidence: `js/main.js`)
- View router → Goal work: renders (evidence: `js/main.js`)
- Student or maker → AI processing: requests generation
- AI processing → Task analysis: routes result (evidence: `js/ai.js`)
- Student or maker → AI checklist: pastes AI output (evidence: `README.md`)
- Student or maker → AI launcher: chooses destination (evidence: `README.md`)
- AI launcher → External AI sites: opens site (evidence: `README.md`)
- Student or maker → Portfolio and goals: manages goals (evidence: `README.md`)
- Portfolio and goals → Growth analysis: requests assessment (evidence: `README.md`)
- Portfolio and goals → Goal work: opens goal
- Portfolio and goals → Growth charts: shows growth charts (evidence: `README.md`)
- Weekly review → Notes: saves planning (evidence: `js/views/review.js`)
- Weekly review → Task analysis: saves planning (evidence: `js/views/review.js`)
- AI processing → Browser app state: saves task (evidence: `js/ai.js`)
- AI checklist → Browser app state: saves checks
- Browser app state → Dashboard: supplies task data
- Browser app state → Weekly review: supplies review data (evidence: `js/views/review.js`)
- Student or maker → Backup and restore: requests backup (evidence: `README.md`)
- Backup and restore → Browser app state: restores data (evidence: `js/backup.js`)
- Student or maker → Export and import: exports or imports (evidence: `js/ai.js`)
- Student or maker → Settings: customizes app (evidence: `README.md`)
- Settings → Theme controls: sets appearance
- Settings → Icon and font styles: sets icon style
- Orbit app → Offline cache: caches app files (evidence: `sw.js`)
