How micjm/weatherribbon works
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: App.tsx Application · cities.ts City catalog · dataService.ts City data loader · SeasonalRibbonChart.tsx Seasonal ribbon
Components 23
Navigation
- Application
src/App.tsx - Hash route hook
src/useHashRoute.ts - Route parser
src/router.ts - City index
src/CityIndex.tsx - City catalog
src/cities.ts - World city data
src/worldCities.ts
Climate data
- City data loader
src/dataService.ts - Offline climate fallback
src/fallbackClimate.ts - Climate utilities
src/climate.ts - Browser cache
Climate visualizations
- Climate chart
src/ClimateChart.tsx - Climate extremes
src/ClimateExtremes.tsx - Extremes logic
src/extremes.ts - Seasonal ribbon
src/SeasonalRibbonChart.tsx - Ribbon calculations
src/ribbon.ts - Seasonal utilities
src/seasonal.ts - Rainfall chart
src/RainfallChart.tsx - Wind chart
src/WindChart.tsx - Other climate charts
src
Air quality
- Air quality chart
src/AirQualityChart.tsx - AQI days chart
src/AqiCategoryDaysChart.tsx - Air quality logic
src/airQuality.ts
Other components
- Visitor
Connections 26
- Visitor → Application: browses
- Application → Hash route hook: tracks route
src/App.tsx - Hash route hook → Route parser: parses routes
src/useHashRoute.ts - Application → Route parser: resolves city
src/App.tsx - Route parser → City catalog: looks up slug
src/router.ts - Application → City index: renders index
src/App.tsx - City index → City catalog: uses catalog
src/CityIndex.tsx - City catalog → World city data: imports city data
src/cities.ts - Application → City data loader: loads city
src/App.tsx - City data loader → City catalog: matches city
src/dataService.ts - City data loader → Offline climate fallback: generates fallback
src/dataService.ts - City data loader → Browser cache: reads and writes
src/dataService.ts - Application → Climate chart: renders chart
src/App.tsx - Application → Climate extremes: renders extremes
src/App.tsx - Climate extremes → Extremes logic: uses calculations
src/ClimateExtremes.tsx - Application → Seasonal ribbon: renders ribbon
src/App.tsx - Seasonal ribbon → Ribbon calculations: computes ribbon
src/SeasonalRibbonChart.tsx - Seasonal ribbon → Seasonal utilities: uses calendar
src/SeasonalRibbonChart.tsx - Application → Rainfall chart: renders chart
src/App.tsx - Application → Wind chart: renders chart
src/App.tsx - Application → Other climate charts: renders charts
src/App.tsx - Application → Air quality chart: renders chart
src/App.tsx - Application → AQI days chart: renders chart
src/App.tsx - Air quality chart → Air quality logic: uses air-quality logic
src/AirQualityChart.tsx - AQI days chart → Air quality logic: uses air-quality logic
src/AqiCategoryDaysChart.tsx - Air quality logic → City catalog: uses city data
src/airQuality.ts