# micjm/weatherribbon architecture

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

- Interactive diagram: https://gitdiagram.com/micjm/weatherribbon
- Repository: https://github.com/micjm/weatherribbon

## Overview

Weatherfork is a browser-based city climate explorer. A visitor browses or searches the city index, opens a city route, and the app loads that city’s climate data before presenting climate, seasonal, air-quality, wind, daylight, and hourly visualizations. Routing, city metadata, and data loading form the internal support layer. The README is only the default Vite template and documents no product capabilities; feature coverage comes from the app source index. Data files and most chart implementations were not excerpted, so their internal connections are omitted.

Main entry points: [`src/App.tsx`](https://github.com/micjm/weatherribbon/blob/main/src/App.tsx) (Application), [`src/cities.ts`](https://github.com/micjm/weatherribbon/blob/main/src/cities.ts) (City catalog), [`src/dataService.ts`](https://github.com/micjm/weatherribbon/blob/main/src/dataService.ts) (City data loader), [`src/SeasonalRibbonChart.tsx`](https://github.com/micjm/weatherribbon/blob/main/src/SeasonalRibbonChart.tsx) (Seasonal ribbon)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["Navigation"]
  node_app["Application<br/>[App.tsx]"]
  node_hashroute["Hash route hook<br/>[useHashRoute.ts]"]
  node_router["Route parser<br/>[router.ts]"]
  node_cityindex["City index<br/>[CityIndex.tsx]"]
  node_cities["City catalog<br/>[cities.ts]"]
  node_worldcities["World city data<br/>[worldCities.ts]"]
end

subgraph group_climate["Climate data"]
  node_dataservice["City data loader<br/>[dataService.ts]"]
  node_fallback["Offline climate fallback<br/>[fallbackClimate.ts]"]
  node_climatecore["Climate utilities<br/>[climate.ts]"]
  node_storage[("Browser cache")]
end

subgraph group_visualizations["Climate visualizations"]
  node_climatechart["Climate chart<br/>[ClimateChart.tsx]"]
  node_extremes["Climate extremes"]
  node_extremecalc["Extremes logic<br/>[extremes.ts]"]
  node_ribbonchart["Seasonal ribbon"]
  node_ribbon["Ribbon calculations<br/>[ribbon.ts]"]
  node_seasonal["Seasonal utilities<br/>[seasonal.ts]"]
  node_rainfall["Rainfall chart<br/>[RainfallChart.tsx]"]
  node_wind["Wind chart<br/>[WindChart.tsx]"]
  node_othercharts["Other climate charts"]
end

subgraph group_air["Air quality"]
  node_airchart["Air quality chart"]
  node_aqidays["AQI days chart"]
  node_airdata["Air quality logic<br/>[airQuality.ts]"]
end

node_visitor(("Visitor"))

node_visitor -->|"browses"| node_app
node_app -->|"tracks route"| node_hashroute
node_hashroute -->|"parses routes"| node_router
node_app -->|"resolves city"| node_router
node_router -->|"looks up slug"| node_cities
node_app -->|"renders index"| node_cityindex
node_cityindex -->|"uses catalog"| node_cities
node_cities -->|"imports city data"| node_worldcities
node_app -->|"loads city"| node_dataservice
node_dataservice -->|"matches city"| node_cities
node_dataservice -->|"generates fallback"| node_fallback
node_dataservice -->|"reads and writes"| node_storage
node_app -->|"renders chart"| node_climatechart
node_app -->|"renders extremes"| node_extremes
node_extremes -->|"uses calculations"| node_extremecalc
node_app -->|"renders ribbon"| node_ribbonchart
node_ribbonchart -->|"computes ribbon"| node_ribbon
node_ribbonchart -->|"uses calendar"| node_seasonal
node_app -->|"renders chart"| node_rainfall
node_app -->|"renders chart"| node_wind
node_app -->|"renders charts"| node_othercharts
node_app -->|"renders chart"| node_airchart
node_app -->|"renders chart"| node_aqidays
node_airchart -->|"uses air-quality logic"| node_airdata
node_aqidays -->|"uses air-quality logic"| node_airdata
node_airdata -->|"uses city data"| node_cities

click node_app "https://github.com/micjm/weatherribbon/blob/main/src/App.tsx"
click node_hashroute "https://github.com/micjm/weatherribbon/blob/main/src/useHashRoute.ts"
click node_router "https://github.com/micjm/weatherribbon/blob/main/src/router.ts"
click node_cityindex "https://github.com/micjm/weatherribbon/blob/main/src/CityIndex.tsx"
click node_cities "https://github.com/micjm/weatherribbon/blob/main/src/cities.ts"
click node_worldcities "https://github.com/micjm/weatherribbon/blob/main/src/worldCities.ts"
click node_dataservice "https://github.com/micjm/weatherribbon/blob/main/src/dataService.ts"
click node_fallback "https://github.com/micjm/weatherribbon/blob/main/src/fallbackClimate.ts"
click node_climatecore "https://github.com/micjm/weatherribbon/blob/main/src/climate.ts"
click node_climatechart "https://github.com/micjm/weatherribbon/blob/main/src/ClimateChart.tsx"
click node_extremes "https://github.com/micjm/weatherribbon/blob/main/src/ClimateExtremes.tsx"
click node_extremecalc "https://github.com/micjm/weatherribbon/blob/main/src/extremes.ts"
click node_ribbonchart "https://github.com/micjm/weatherribbon/blob/main/src/SeasonalRibbonChart.tsx"
click node_ribbon "https://github.com/micjm/weatherribbon/blob/main/src/ribbon.ts"
click node_seasonal "https://github.com/micjm/weatherribbon/blob/main/src/seasonal.ts"
click node_rainfall "https://github.com/micjm/weatherribbon/blob/main/src/RainfallChart.tsx"
click node_wind "https://github.com/micjm/weatherribbon/blob/main/src/WindChart.tsx"
click node_othercharts "https://github.com/micjm/weatherribbon/tree/main/src"
click node_airchart "https://github.com/micjm/weatherribbon/blob/main/src/AirQualityChart.tsx"
click node_aqidays "https://github.com/micjm/weatherribbon/blob/main/src/AqiCategoryDaysChart.tsx"
click node_airdata "https://github.com/micjm/weatherribbon/blob/main/src/airQuality.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_app,node_hashroute,node_router,node_cityindex,node_cities,node_worldcities toneBlue
class node_dataservice,node_fallback,node_climatecore,node_storage toneAmber
class node_climatechart,node_extremes,node_extremecalc,node_ribbonchart,node_ribbon,node_seasonal,node_rainfall,node_wind,node_othercharts toneMint
class node_airchart,node_aqidays,node_airdata toneRose
class node_visitor toneIndigo
```

## Components

### Navigation

- [Application](https://github.com/micjm/weatherribbon/blob/main/src/App.tsx): `src/App.tsx`
- [Hash route hook](https://github.com/micjm/weatherribbon/blob/main/src/useHashRoute.ts): `src/useHashRoute.ts`
- [Route parser](https://github.com/micjm/weatherribbon/blob/main/src/router.ts): `src/router.ts`
- [City index](https://github.com/micjm/weatherribbon/blob/main/src/CityIndex.tsx): `src/CityIndex.tsx`
- [City catalog](https://github.com/micjm/weatherribbon/blob/main/src/cities.ts): `src/cities.ts`
- [World city data](https://github.com/micjm/weatherribbon/blob/main/src/worldCities.ts): `src/worldCities.ts`

### Climate data

- [City data loader](https://github.com/micjm/weatherribbon/blob/main/src/dataService.ts): `src/dataService.ts`
- [Offline climate fallback](https://github.com/micjm/weatherribbon/blob/main/src/fallbackClimate.ts): `src/fallbackClimate.ts`
- [Climate utilities](https://github.com/micjm/weatherribbon/blob/main/src/climate.ts): `src/climate.ts`
- **Browser cache**

### Climate visualizations

- [Climate chart](https://github.com/micjm/weatherribbon/blob/main/src/ClimateChart.tsx): `src/ClimateChart.tsx`
- [Climate extremes](https://github.com/micjm/weatherribbon/blob/main/src/ClimateExtremes.tsx): `src/ClimateExtremes.tsx`
- [Extremes logic](https://github.com/micjm/weatherribbon/blob/main/src/extremes.ts): `src/extremes.ts`
- [Seasonal ribbon](https://github.com/micjm/weatherribbon/blob/main/src/SeasonalRibbonChart.tsx): `src/SeasonalRibbonChart.tsx`
- [Ribbon calculations](https://github.com/micjm/weatherribbon/blob/main/src/ribbon.ts): `src/ribbon.ts`
- [Seasonal utilities](https://github.com/micjm/weatherribbon/blob/main/src/seasonal.ts): `src/seasonal.ts`
- [Rainfall chart](https://github.com/micjm/weatherribbon/blob/main/src/RainfallChart.tsx): `src/RainfallChart.tsx`
- [Wind chart](https://github.com/micjm/weatherribbon/blob/main/src/WindChart.tsx): `src/WindChart.tsx`
- [Other climate charts](https://github.com/micjm/weatherribbon/tree/main/src): `src`

### Air quality

- [Air quality chart](https://github.com/micjm/weatherribbon/blob/main/src/AirQualityChart.tsx): `src/AirQualityChart.tsx`
- [AQI days chart](https://github.com/micjm/weatherribbon/blob/main/src/AqiCategoryDaysChart.tsx): `src/AqiCategoryDaysChart.tsx`
- [Air quality logic](https://github.com/micjm/weatherribbon/blob/main/src/airQuality.ts): `src/airQuality.ts`

### Other components

- **Visitor**

## Connections

- Visitor → Application: browses
- Application → Hash route hook: tracks route (evidence: `src/App.tsx`)
- Hash route hook → Route parser: parses routes (evidence: `src/useHashRoute.ts`)
- Application → Route parser: resolves city (evidence: `src/App.tsx`)
- Route parser → City catalog: looks up slug (evidence: `src/router.ts`)
- Application → City index: renders index (evidence: `src/App.tsx`)
- City index → City catalog: uses catalog (evidence: `src/CityIndex.tsx`)
- City catalog → World city data: imports city data (evidence: `src/cities.ts`)
- Application → City data loader: loads city (evidence: `src/App.tsx`)
- City data loader → City catalog: matches city (evidence: `src/dataService.ts`)
- City data loader → Offline climate fallback: generates fallback (evidence: `src/dataService.ts`)
- City data loader → Browser cache: reads and writes (evidence: `src/dataService.ts`)
- Application → Climate chart: renders chart (evidence: `src/App.tsx`)
- Application → Climate extremes: renders extremes (evidence: `src/App.tsx`)
- Climate extremes → Extremes logic: uses calculations (evidence: `src/ClimateExtremes.tsx`)
- Application → Seasonal ribbon: renders ribbon (evidence: `src/App.tsx`)
- Seasonal ribbon → Ribbon calculations: computes ribbon (evidence: `src/SeasonalRibbonChart.tsx`)
- Seasonal ribbon → Seasonal utilities: uses calendar (evidence: `src/SeasonalRibbonChart.tsx`)
- Application → Rainfall chart: renders chart (evidence: `src/App.tsx`)
- Application → Wind chart: renders chart (evidence: `src/App.tsx`)
- Application → Other climate charts: renders charts (evidence: `src/App.tsx`)
- Application → Air quality chart: renders chart (evidence: `src/App.tsx`)
- Application → AQI days chart: renders chart (evidence: `src/App.tsx`)
- Air quality chart → Air quality logic: uses air-quality logic (evidence: `src/AirQualityChart.tsx`)
- AQI days chart → Air quality logic: uses air-quality logic (evidence: `src/AqiCategoryDaysChart.tsx`)
- Air quality logic → City catalog: uses city data (evidence: `src/airQuality.ts`)
