# jermbo/cosmicworkout architecture

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

- Interactive diagram: https://gitdiagram.com/jermbo/cosmicworkout
- Repository: https://github.com/jermbo/cosmicworkout

## Overview

CosmicWorkOut is an offline-first, device-local strength and daily-life tracker. The main user journey is to enable trackers in Settings, record workouts or other daily measures, and review them on Overview and Insights; workout plans can be built from templates or around a target lift. The graph also preserves backup/restore and QR transfer, personalization, and the local data layer. Most route-to-store connections were not sampled, so those links are omitted; README statements support the broader product workflow.

Main entry points: [`src/lib/components/SessionOverlay.svelte`](https://github.com/jermbo/cosmicworkout/blob/main/src/lib/components/SessionOverlay.svelte) (Live session), [`src/lib/plans/wizard.svelte.ts`](https://github.com/jermbo/cosmicworkout/blob/main/src/lib/plans/wizard.svelte.ts) (Goal plan wizard), [`src/lib/db/database.ts`](https://github.com/jermbo/cosmicworkout/blob/main/src/lib/db/database.ts) (IndexedDB), [`src/routes/settings/+page.svelte`](https://github.com/jermbo/cosmicworkout/blob/main/src/routes/settings/%2Bpage.svelte) (Tracker settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_settings["Tracker settings<br/>[+page.svelte]"]
  node_overview["Overview<br/>[+page.svelte]"]
end

subgraph group_training["Strength training"]
  node_workout["Workout routes<br/>[+page.svelte]"]
  node_session["Live session"]
  node_setlogging["Set logging<br/>[LogSetSheet.svelte]"]
  node_exercise["Exercise card"]
  node_settile["Set tile<br/>[SetTile.svelte]"]
  node_completion["Session summary"]
  node_goalwizard["Goal plan wizard<br/>[wizard.svelte.ts]"]
  node_goalgen["Goal plan generation<br/>[generator.ts]"]
  node_goalbuild["Program builder<br/>[buildProgram.ts]"]
  node_planactions["Plan actions<br/>[actions.ts]"]
end

subgraph group_tracking["Daily tracking"]
  node_habits["Habits<br/>[+page.svelte]"]
  node_activity["Activity log<br/>[+page.svelte]"]
  node_baselines["Baselines<br/>[+page.svelte]"]
  node_health["Health metrics<br/>[+page.svelte]"]
end

subgraph group_data["Local data"]
  node_database[("IndexedDB<br/>[database.ts]")]
  node_debugseed["Debug data<br/>[debugSeed.ts]"]
  node_exerciseseed["Exercise catalog"]
  node_programseed["Strength programs"]
end

subgraph group_support["Insights and settings"]
  node_insights["Insights charts<br/>[+page.svelte]"]
  node_preferences["Personalization<br/>[+page.svelte]"]
  node_backup["Backup and restore<br/>[backup.ts]"]
  node_qr["QR transfer<br/>[frames.ts]"]
  node_feedback["Feedback patterns<br/>[patterns.ts]"]
end

node_user(("User"))

node_user -->|"configures"| node_settings
node_settings -->|"enables cards"| node_overview
node_settings -->|"enables charts"| node_insights
node_user -->|"starts training"| node_workout
node_workout -.->|"runs session"| node_session
node_session -->|"opens set entry"| node_setlogging
node_session -->|"renders exercises"| node_exercise
node_exercise -->|"renders sets"| node_settile
node_session -.->|"finishes session"| node_completion
node_completion -->|"checks goal"| node_goalgen
node_user -->|"creates goal plan"| node_goalwizard
node_goalwizard -->|"generates blocks"| node_goalgen
node_goalwizard -->|"builds program"| node_goalbuild
node_goalwizard -->|"activates plan"| node_planactions
node_user -->|"logs habits"| node_habits
node_user -->|"logs activity"| node_activity
node_user -->|"logs baselines"| node_baselines
node_user -->|"logs health"| node_health
node_user -->|"reviews trends"| node_insights
node_user -->|"exports or restores"| node_backup
node_user -->|"transfers backup"| node_qr
node_backup -.->|"backs up data"| node_database
node_database -->|"loads debug data"| node_debugseed
node_database -->|"seeds catalog"| node_exerciseseed
node_database -->|"seeds programs"| node_programseed
node_user -->|"personalizes"| node_preferences

click node_settings "https://github.com/jermbo/cosmicworkout/blob/main/src/routes/settings/%2Bpage.svelte"
click node_overview "https://github.com/jermbo/cosmicworkout/blob/main/src/routes/%2Bpage.svelte"
click node_workout "https://github.com/jermbo/cosmicworkout/blob/main/src/routes/workout/%2Bpage.svelte"
click node_session "https://github.com/jermbo/cosmicworkout/blob/main/src/lib/components/SessionOverlay.svelte"
click node_setlogging "https://github.com/jermbo/cosmicworkout/blob/main/src/lib/components/LogSetSheet.svelte"
click node_exercise "https://github.com/jermbo/cosmicworkout/blob/main/src/lib/components/ExerciseCard.svelte"
click node_settile "https://github.com/jermbo/cosmicworkout/blob/main/src/lib/components/SetTile.svelte"
click node_completion "https://github.com/jermbo/cosmicworkout/blob/main/src/lib/components/SessionComplete.svelte"
click node_goalwizard "https://github.com/jermbo/cosmicworkout/blob/main/src/lib/plans/wizard.svelte.ts"
click node_goalgen "https://github.com/jermbo/cosmicworkout/blob/main/src/lib/goalPlans/generator.ts"
click node_goalbuild "https://github.com/jermbo/cosmicworkout/blob/main/src/lib/goalPlans/buildProgram.ts"
click node_planactions "https://github.com/jermbo/cosmicworkout/blob/main/src/lib/plans/actions.ts"
click node_habits "https://github.com/jermbo/cosmicworkout/blob/main/src/routes/habits/%2Bpage.svelte"
click node_activity "https://github.com/jermbo/cosmicworkout/blob/main/src/routes/log/%2Bpage.svelte"
click node_baselines "https://github.com/jermbo/cosmicworkout/blob/main/src/routes/baselines/%2Bpage.svelte"
click node_health "https://github.com/jermbo/cosmicworkout/blob/main/src/routes/health/%2Bpage.svelte"
click node_insights "https://github.com/jermbo/cosmicworkout/blob/main/src/routes/insights/%2Bpage.svelte"
click node_preferences "https://github.com/jermbo/cosmicworkout/blob/main/src/routes/settings/personalization/%2Bpage.svelte"
click node_backup "https://github.com/jermbo/cosmicworkout/blob/main/src/lib/db/backup.ts"
click node_qr "https://github.com/jermbo/cosmicworkout/blob/main/src/lib/qrBackup/frames.ts"
click node_database "https://github.com/jermbo/cosmicworkout/blob/main/src/lib/db/database.ts"
click node_debugseed "https://github.com/jermbo/cosmicworkout/blob/main/src/lib/db/debugSeed.ts"
click node_exerciseseed "https://github.com/jermbo/cosmicworkout/blob/main/src/lib/db/seeds/strength-exercises.ts"
click node_programseed "https://github.com/jermbo/cosmicworkout/blob/main/src/lib/db/seeds/strength-programs.ts"
click node_feedback "https://github.com/jermbo/cosmicworkout/blob/main/src/lib/feedback/patterns.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_settings,node_overview,node_user toneBlue
class node_workout,node_session,node_setlogging,node_exercise,node_settile,node_completion,node_goalwizard,node_goalgen,node_goalbuild,node_planactions toneAmber
class node_habits,node_activity,node_baselines,node_health toneMint
class node_database,node_debugseed,node_exerciseseed,node_programseed toneRose
class node_insights,node_preferences,node_backup,node_qr,node_feedback toneIndigo
```

## Components

### App experience

- [Tracker settings](https://github.com/jermbo/cosmicworkout/blob/main/src/routes/settings/%2Bpage.svelte): `src/routes/settings/+page.svelte`
- [Overview](https://github.com/jermbo/cosmicworkout/blob/main/src/routes/%2Bpage.svelte): `src/routes/+page.svelte`

### Strength training

- [Workout routes](https://github.com/jermbo/cosmicworkout/blob/main/src/routes/workout/%2Bpage.svelte): `src/routes/workout/+page.svelte`
- [Live session](https://github.com/jermbo/cosmicworkout/blob/main/src/lib/components/SessionOverlay.svelte): `src/lib/components/SessionOverlay.svelte`
- [Set logging](https://github.com/jermbo/cosmicworkout/blob/main/src/lib/components/LogSetSheet.svelte): `src/lib/components/LogSetSheet.svelte`
- [Exercise card](https://github.com/jermbo/cosmicworkout/blob/main/src/lib/components/ExerciseCard.svelte): `src/lib/components/ExerciseCard.svelte`
- [Set tile](https://github.com/jermbo/cosmicworkout/blob/main/src/lib/components/SetTile.svelte): `src/lib/components/SetTile.svelte`
- [Session summary](https://github.com/jermbo/cosmicworkout/blob/main/src/lib/components/SessionComplete.svelte): `src/lib/components/SessionComplete.svelte`
- [Goal plan wizard](https://github.com/jermbo/cosmicworkout/blob/main/src/lib/plans/wizard.svelte.ts): `src/lib/plans/wizard.svelte.ts`
- [Goal plan generation](https://github.com/jermbo/cosmicworkout/blob/main/src/lib/goalPlans/generator.ts): `src/lib/goalPlans/generator.ts`
- [Program builder](https://github.com/jermbo/cosmicworkout/blob/main/src/lib/goalPlans/buildProgram.ts): `src/lib/goalPlans/buildProgram.ts`
- [Plan actions](https://github.com/jermbo/cosmicworkout/blob/main/src/lib/plans/actions.ts): `src/lib/plans/actions.ts`

### Daily tracking

- [Habits](https://github.com/jermbo/cosmicworkout/blob/main/src/routes/habits/%2Bpage.svelte): `src/routes/habits/+page.svelte`
- [Activity log](https://github.com/jermbo/cosmicworkout/blob/main/src/routes/log/%2Bpage.svelte): `src/routes/log/+page.svelte`
- [Baselines](https://github.com/jermbo/cosmicworkout/blob/main/src/routes/baselines/%2Bpage.svelte): `src/routes/baselines/+page.svelte`
- [Health metrics](https://github.com/jermbo/cosmicworkout/blob/main/src/routes/health/%2Bpage.svelte): `src/routes/health/+page.svelte`

### Local data

- [IndexedDB](https://github.com/jermbo/cosmicworkout/blob/main/src/lib/db/database.ts): `src/lib/db/database.ts`
- [Debug data](https://github.com/jermbo/cosmicworkout/blob/main/src/lib/db/debugSeed.ts): `src/lib/db/debugSeed.ts`
- [Exercise catalog](https://github.com/jermbo/cosmicworkout/blob/main/src/lib/db/seeds/strength-exercises.ts): `src/lib/db/seeds/strength-exercises.ts`
- [Strength programs](https://github.com/jermbo/cosmicworkout/blob/main/src/lib/db/seeds/strength-programs.ts): `src/lib/db/seeds/strength-programs.ts`

### Insights and settings

- [Insights charts](https://github.com/jermbo/cosmicworkout/blob/main/src/routes/insights/%2Bpage.svelte): `src/routes/insights/+page.svelte`
- [Personalization](https://github.com/jermbo/cosmicworkout/blob/main/src/routes/settings/personalization/%2Bpage.svelte): `src/routes/settings/personalization/+page.svelte`
- [Backup and restore](https://github.com/jermbo/cosmicworkout/blob/main/src/lib/db/backup.ts): `src/lib/db/backup.ts`
- [QR transfer](https://github.com/jermbo/cosmicworkout/blob/main/src/lib/qrBackup/frames.ts): `src/lib/qrBackup/frames.ts`
- [Feedback patterns](https://github.com/jermbo/cosmicworkout/blob/main/src/lib/feedback/patterns.ts): `src/lib/feedback/patterns.ts`

### Other components

- **User**

## Connections

- User → Tracker settings: configures
- Tracker settings → Overview: enables cards
- Tracker settings → Insights charts: enables charts
- User → Workout routes: starts training
- Workout routes → Live session: runs session
- Live session → Set logging: opens set entry (evidence: `src/lib/components/SessionOverlay.svelte`)
- Live session → Exercise card: renders exercises (evidence: `src/lib/components/SessionOverlay.svelte`)
- Exercise card → Set tile: renders sets (evidence: `src/lib/components/ExerciseCard.svelte`)
- Live session → Session summary: finishes session
- Session summary → Goal plan generation: checks goal (evidence: `src/lib/components/SessionComplete.svelte`)
- User → Goal plan wizard: creates goal plan
- Goal plan wizard → Goal plan generation: generates blocks (evidence: `src/lib/plans/wizard.svelte.ts`)
- Goal plan wizard → Program builder: builds program (evidence: `src/lib/plans/wizard.svelte.ts`)
- Goal plan wizard → Plan actions: activates plan (evidence: `src/lib/plans/wizard.svelte.ts`)
- User → Habits: logs habits
- User → Activity log: logs activity
- User → Baselines: logs baselines
- User → Health metrics: logs health
- User → Insights charts: reviews trends
- User → Backup and restore: exports or restores
- User → QR transfer: transfers backup
- Backup and restore → IndexedDB: backs up data
- IndexedDB → Debug data: loads debug data (evidence: `src/lib/db/database.ts`)
- IndexedDB → Exercise catalog: seeds catalog
- IndexedDB → Strength programs: seeds programs
- User → Personalization: personalizes
