# nkabessa/calendar-pt architecture

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

- Interactive diagram: https://gitdiagram.com/nkabessa/calendar-pt
- Repository: https://github.com/nkabessa/calendar-pt

## Overview

Calendar Hack turns a selected runner training plan and race date into an editable calendar, with unit and week-start preferences and CSV/iCal exports. The main runtime path loads a plan, builds its dated race plan, presents it as a calendar, and routes edits and exports through the app controller. Plan selection, date-grid construction, workout rendering, and export formats are distinct domain responsibilities. The source excerpts establish the main controller and export/rendering behavior; some UI and plan-loading links rely on SOURCE INDEX references rather than inspected implementations.

Main entry points: [`src/App.tsx`](https://github.com/nkabessa/calendar-pt/blob/master/src/App.tsx) (Plan app controller), [`src/components/CalendarGrid.tsx`](https://github.com/nkabessa/calendar-pt/blob/master/src/components/CalendarGrid.tsx) (Calendar grid), [`src/main.tsx`](https://github.com/nkabessa/calendar-pt/blob/master/src/main.tsx) (React entry and routes), [`src/ch/rendering.ts`](https://github.com/nkabessa/calendar-pt/blob/master/src/ch/rendering.ts) (Workout text and distances)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Application runtime"]
  node_entry["React entry and routes<br/>[main.tsx]"]
  node_app["Plan app controller<br/>[App.tsx]"]
  node_about["About content<br/>[About.tsx]"]
  node_navigation["Toolbar and footer<br/>[Index.tsx]"]
end

subgraph group_plans["Plan and calendar domain"]
  node_planrepo["Plan repository<br/>[planrepo.ts]"]
  node_planlist["Available plans<br/>[planList.ts]"]
  node_config["Plan configuration<br/>[config.ts]"]
  node_builder["Race-plan builder<br/>[planbuilder.ts]"]
  node_datecalc["Plan date calculation<br/>[datecalc.ts]"]
  node_dategrid["Dated workout grid<br/>[dategrid.ts]"]
  node_history["Undo history<br/>[history.ts]"]
end

subgraph group_presentation["Calendar experience"]
  node_calendar["Calendar grid<br/>[CalendarGrid.tsx]"]
  node_daycell["Day cell and overlay<br/>[DayCell.tsx]"]
  node_workout["Workout card<br/>[WorkoutCard.tsx]"]
  node_weeksummary["Week summary<br/>[WeekSummary.tsx]"]
  node_weekday["Weekday header"]
  node_controls["Plan and date controls<br/>[PlanAndDate.tsx]"]
  node_unitcontrols["Unit controls<br/>[UnitsButtons.tsx]"]
  node_weekcontrols["Week-start control"]
end

subgraph group_exports["Export services"]
  node_rendering["Workout text and distances<br/>[rendering.ts]"]
  node_ical["iCal generation<br/>[icalservice.ts]"]
  node_csv["CSV generation<br/>[csvService.ts]"]
  node_download["File download<br/>[downloadservice.ts]"]
end

node_runner(("Runner"))
node_browser(("Browser"))

node_runner -->|"opens app"| node_entry
node_entry -->|"routes to"| node_app
node_entry -->|"renders shell"| node_navigation
node_entry -->|"routes to"| node_about
node_app -->|"loads plans"| node_planrepo
node_planrepo -->|"uses plan list"| node_planlist
node_planrepo -->|"uses configuration"| node_config
node_app -->|"checks plan status"| node_config
node_app -->|"builds race plan"| node_builder
node_builder -->|"calculates dates"| node_datecalc
node_builder -->|"creates date grid"| node_dategrid
node_app -->|"tracks undo state"| node_history
node_app -->|"renders controls"| node_controls
node_app -->|"renders controls"| node_unitcontrols
node_app -->|"renders controls"| node_weekcontrols
node_app -->|"renders race plan"| node_calendar
node_calendar -->|"reads weeks"| node_dategrid
node_calendar -->|"renders days"| node_daycell
node_calendar -->|"renders summaries"| node_weeksummary
node_calendar -->|"renders headers"| node_weekday
node_daycell -->|"renders workout"| node_workout
node_workout -->|"formats workout"| node_rendering
node_weeksummary -->|"formats distances"| node_rendering
node_weekday -->|"requests day swaps"| node_app
node_calendar -->|"requests date swaps"| node_app
node_app -->|"generates iCal"| node_ical
node_app -->|"generates CSV"| node_csv
node_ical -->|"formats events"| node_rendering
node_csv -->|"formats rows"| node_rendering
node_app -->|"downloads export"| node_download
node_download -->|"creates file download"| node_browser

click node_entry "https://github.com/nkabessa/calendar-pt/blob/master/src/main.tsx"
click node_app "https://github.com/nkabessa/calendar-pt/blob/master/src/App.tsx"
click node_about "https://github.com/nkabessa/calendar-pt/blob/master/src/About.tsx"
click node_planrepo "https://github.com/nkabessa/calendar-pt/blob/master/src/ch/planrepo.ts"
click node_planlist "https://github.com/nkabessa/calendar-pt/blob/master/src/ch/planList.ts"
click node_config "https://github.com/nkabessa/calendar-pt/blob/master/src/ch/config.ts"
click node_builder "https://github.com/nkabessa/calendar-pt/blob/master/src/ch/planbuilder.ts"
click node_datecalc "https://github.com/nkabessa/calendar-pt/blob/master/src/ch/datecalc.ts"
click node_dategrid "https://github.com/nkabessa/calendar-pt/blob/master/src/ch/dategrid.ts"
click node_history "https://github.com/nkabessa/calendar-pt/blob/master/src/defy/history.ts"
click node_calendar "https://github.com/nkabessa/calendar-pt/blob/master/src/components/CalendarGrid.tsx"
click node_daycell "https://github.com/nkabessa/calendar-pt/blob/master/src/components/DayCell.tsx"
click node_workout "https://github.com/nkabessa/calendar-pt/blob/master/src/components/WorkoutCard.tsx"
click node_weeksummary "https://github.com/nkabessa/calendar-pt/blob/master/src/components/WeekSummary.tsx"
click node_weekday "https://github.com/nkabessa/calendar-pt/blob/master/src/components/DayOfWeekHeader.tsx"
click node_controls "https://github.com/nkabessa/calendar-pt/blob/master/src/components/PlanAndDate.tsx"
click node_unitcontrols "https://github.com/nkabessa/calendar-pt/blob/master/src/components/UnitsButtons.tsx"
click node_weekcontrols "https://github.com/nkabessa/calendar-pt/blob/master/src/components/WeekStartsOnPicker.tsx"
click node_rendering "https://github.com/nkabessa/calendar-pt/blob/master/src/ch/rendering.ts"
click node_ical "https://github.com/nkabessa/calendar-pt/blob/master/src/ch/icalservice.ts"
click node_csv "https://github.com/nkabessa/calendar-pt/blob/master/src/ch/csvService.ts"
click node_download "https://github.com/nkabessa/calendar-pt/blob/master/src/ch/downloadservice.ts"
click node_navigation "https://github.com/nkabessa/calendar-pt/blob/master/src/Index.tsx"

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_entry,node_app,node_about,node_navigation,node_browser toneBlue
class node_planrepo,node_planlist,node_config,node_builder,node_datecalc,node_dategrid,node_history toneAmber
class node_calendar,node_daycell,node_workout,node_weeksummary,node_weekday,node_controls,node_unitcontrols,node_weekcontrols toneMint
class node_rendering,node_ical,node_csv,node_download toneRose
class node_runner toneIndigo
```

## Components

### Application runtime

- [React entry and routes](https://github.com/nkabessa/calendar-pt/blob/master/src/main.tsx): `src/main.tsx`
- [Plan app controller](https://github.com/nkabessa/calendar-pt/blob/master/src/App.tsx): `src/App.tsx`
- [About content](https://github.com/nkabessa/calendar-pt/blob/master/src/About.tsx): `src/About.tsx`
- [Toolbar and footer](https://github.com/nkabessa/calendar-pt/blob/master/src/Index.tsx): `src/Index.tsx`

### Plan and calendar domain

- [Plan repository](https://github.com/nkabessa/calendar-pt/blob/master/src/ch/planrepo.ts): `src/ch/planrepo.ts`
- [Available plans](https://github.com/nkabessa/calendar-pt/blob/master/src/ch/planList.ts): `src/ch/planList.ts`
- [Plan configuration](https://github.com/nkabessa/calendar-pt/blob/master/src/ch/config.ts): `src/ch/config.ts`
- [Race-plan builder](https://github.com/nkabessa/calendar-pt/blob/master/src/ch/planbuilder.ts): `src/ch/planbuilder.ts`
- [Plan date calculation](https://github.com/nkabessa/calendar-pt/blob/master/src/ch/datecalc.ts): `src/ch/datecalc.ts`
- [Dated workout grid](https://github.com/nkabessa/calendar-pt/blob/master/src/ch/dategrid.ts): `src/ch/dategrid.ts`
- [Undo history](https://github.com/nkabessa/calendar-pt/blob/master/src/defy/history.ts): `src/defy/history.ts`

### Calendar experience

- [Calendar grid](https://github.com/nkabessa/calendar-pt/blob/master/src/components/CalendarGrid.tsx): `src/components/CalendarGrid.tsx`
- [Day cell and overlay](https://github.com/nkabessa/calendar-pt/blob/master/src/components/DayCell.tsx): `src/components/DayCell.tsx`
- [Workout card](https://github.com/nkabessa/calendar-pt/blob/master/src/components/WorkoutCard.tsx): `src/components/WorkoutCard.tsx`
- [Week summary](https://github.com/nkabessa/calendar-pt/blob/master/src/components/WeekSummary.tsx): `src/components/WeekSummary.tsx`
- [Weekday header](https://github.com/nkabessa/calendar-pt/blob/master/src/components/DayOfWeekHeader.tsx): `src/components/DayOfWeekHeader.tsx`
- [Plan and date controls](https://github.com/nkabessa/calendar-pt/blob/master/src/components/PlanAndDate.tsx): `src/components/PlanAndDate.tsx`
- [Unit controls](https://github.com/nkabessa/calendar-pt/blob/master/src/components/UnitsButtons.tsx): `src/components/UnitsButtons.tsx`
- [Week-start control](https://github.com/nkabessa/calendar-pt/blob/master/src/components/WeekStartsOnPicker.tsx): `src/components/WeekStartsOnPicker.tsx`

### Export services

- [Workout text and distances](https://github.com/nkabessa/calendar-pt/blob/master/src/ch/rendering.ts): `src/ch/rendering.ts`
- [iCal generation](https://github.com/nkabessa/calendar-pt/blob/master/src/ch/icalservice.ts): `src/ch/icalservice.ts`
- [CSV generation](https://github.com/nkabessa/calendar-pt/blob/master/src/ch/csvService.ts): `src/ch/csvService.ts`
- [File download](https://github.com/nkabessa/calendar-pt/blob/master/src/ch/downloadservice.ts): `src/ch/downloadservice.ts`

### Other components

- **Runner**
- **Browser**

## Connections

- Runner → React entry and routes: opens app (evidence: `src/main.tsx`)
- React entry and routes → Plan app controller: routes to (evidence: `src/main.tsx`)
- React entry and routes → Toolbar and footer: renders shell (evidence: `src/main.tsx`)
- React entry and routes → About content: routes to (evidence: `src/main.tsx`)
- Plan app controller → Plan repository: loads plans (evidence: `src/App.tsx`)
- Plan repository → Available plans: uses plan list (evidence: `src/ch/planrepo.ts`)
- Plan repository → Plan configuration: uses configuration (evidence: `src/ch/planrepo.ts`)
- Plan app controller → Plan configuration: checks plan status (evidence: `src/App.tsx`)
- Plan app controller → Race-plan builder: builds race plan (evidence: `src/App.tsx`)
- Race-plan builder → Plan date calculation: calculates dates (evidence: `src/ch/planbuilder.ts`)
- Race-plan builder → Dated workout grid: creates date grid (evidence: `src/ch/planbuilder.ts`)
- Plan app controller → Undo history: tracks undo state (evidence: `src/App.tsx`)
- Plan app controller → Plan and date controls: renders controls (evidence: `src/App.tsx`)
- Plan app controller → Unit controls: renders controls (evidence: `src/App.tsx`)
- Plan app controller → Week-start control: renders controls (evidence: `src/App.tsx`)
- Plan app controller → Calendar grid: renders race plan (evidence: `src/App.tsx`)
- Calendar grid → Dated workout grid: reads weeks (evidence: `src/components/CalendarGrid.tsx`)
- Calendar grid → Day cell and overlay: renders days (evidence: `src/components/CalendarGrid.tsx`)
- Calendar grid → Week summary: renders summaries (evidence: `src/components/CalendarGrid.tsx`)
- Calendar grid → Weekday header: renders headers (evidence: `src/components/CalendarGrid.tsx`)
- Day cell and overlay → Workout card: renders workout (evidence: `src/components/DayCell.tsx`)
- Workout card → Workout text and distances: formats workout (evidence: `src/components/WorkoutCard.tsx`)
- Week summary → Workout text and distances: formats distances (evidence: `src/components/WeekSummary.tsx`)
- Weekday header → Plan app controller: requests day swaps (evidence: `src/App.tsx`)
- Calendar grid → Plan app controller: requests date swaps (evidence: `src/App.tsx`)
- Plan app controller → iCal generation: generates iCal (evidence: `src/App.tsx`)
- Plan app controller → CSV generation: generates CSV (evidence: `src/App.tsx`)
- iCal generation → Workout text and distances: formats events (evidence: `src/ch/icalservice.ts`)
- CSV generation → Workout text and distances: formats rows (evidence: `src/ch/csvService.ts`)
- Plan app controller → File download: downloads export (evidence: `src/App.tsx`)
- File download → Browser: creates file download (evidence: `src/ch/downloadservice.ts`)
