How silentkeyboard1/justweather works
JustWeather is a local-weather app: users view weather for their current location, search for cities, inspect a city’s weather, and manage favorites; the home screen supports swiping among locations. A separate Android widget resolves a selected or current city and refreshes weather on schedule or on demand. The graph includes the main app, city/location and favorites stages, weather presentation, and widget lifecycle. Some route and API details come from the SOURCE INDEX or README rather than sampled implementations, so uncertain connections are omitted.
Main entry points: search.tsx Search screen · resolveWidgetCity.ts Widget city resolver · WidgetCityContext.tsx Widget city context · index.tsx Home screen
Components 29
App experience
- Home screen
src/app/index.tsx - Search screen
src/app/search.tsx
Cities and favorites
- City model
src/features/city-search/model/city.ts - City search API
src/features/city-search/api/searchCities.ts - Search form
src/features/city-search/components/CitySearchForm.tsx - Search results
src/features/city-search/components/CitySearchResults.tsx - Favorites context
src/features/favorites/context/FavoritesContext.tsx - Favorites storage
src/features/favorites/storage/favoriteCitiesStorage.ts - Current location lookup
src/features/location/api/getCurrentCity.ts - Current city storage
src/features/location/storage/currentCityStorage.ts
Weather experience
- Weather API
src/features/weather/api/getWeather.ts - Weather page
src/features/weather/components/WeatherPage.tsx - Weather card
src/features/weather/components/WeatherCard.tsx - Weather icon
src/features/weather/components/WeatherIcon.tsx - Condition mapping
src/features/weather/utils/getWeatherCondition.ts - Weather model
src/features/weather/model/weather.ts
Android widget
- Widget city context
src/features/weather-widget/context/WidgetCityContext.tsx - Widget city storage
src/features/weather-widget/storage/widgetCityStorage.ts - Widget city resolver
src/features/weather-widget/utils/resolveWidgetCity.ts - Widget task handler
src/features/weather-widget/widgetTaskHandler.tsx - Current weather widget
src/features/weather-widget/components/CurrentWeatherWidget.tsx - Widget icon SVG
src/features/weather-widget/utils/getWidgetWeatherIconSvg.ts
Shared presentation
- App theme
src/shared/theme/theme.ts - Base theme tokens
src/constants/theme.ts - Themed text
src/components/themed-text.tsx - Themed view
src/components/themed-view.tsx
Other components
- Weather user
- Android widget runtime
- Weather data service
Connections 39
- Weather user → Home screen: views weather
- Weather user → Search screen: searches cities
- Home screen → Current location lookup: gets current city
src/app/index.tsx - Home screen → Favorites context: reads favorites
src/app/index.tsx - Home screen → Weather page: shows weather
src/app/index.tsx - Search screen → City search API: searches cities
src/app/search.tsx - Search screen → Search form: renders form
src/app/search.tsx - Search screen → Search results: renders results
src/app/search.tsx - Search screen → Favorites context: toggles favorite
src/app/search.tsx - Search screen → Weather page: shows selected city
src/app/search.tsx - City search API → City model: returns cities
src/features/city-search/api/searchCities.ts - Search results → City model: displays cities
src/features/city-search/components/CitySearchResults.tsx - Favorites context → Favorites storage: loads and saves
src/features/favorites/context/FavoritesContext.tsx - Current location lookup → City search API: searches resolved place
src/features/location/api/getCurrentCity.ts - Current location lookup → Current city storage: persists current city
src/features/location/api/getCurrentCity.ts - Weather page → Weather API: fetches weather
src/features/weather/components/WeatherPage.tsx - Weather page → Weather card: renders weather
src/features/weather/components/WeatherPage.tsx - Weather card → Weather icon: renders icon
src/features/weather/components/WeatherCard.tsx - Weather icon → Condition mapping: maps condition
src/features/weather/components/WeatherIcon.tsx - Weather card → Condition mapping: maps condition
src/features/weather/components/WeatherCard.tsx - Weather API → Weather data service: requests data
- Widget city context → Widget city storage: loads and saves
src/features/weather-widget/context/WidgetCityContext.tsx - Widget city context → Widget city resolver: resolves location
src/features/weather-widget/context/WidgetCityContext.tsx - Widget city context → Weather API: fetches weather
src/features/weather-widget/context/WidgetCityContext.tsx - Widget city context → Current weather widget: requests widget update
src/features/weather-widget/context/WidgetCityContext.tsx - Widget task handler → Widget city resolver: resolves location
src/features/weather-widget/widgetTaskHandler.tsx - Widget task handler → Weather API: fetches weather
src/features/weather-widget/widgetTaskHandler.tsx - Widget task handler → Current weather widget: renders widget
src/features/weather-widget/widgetTaskHandler.tsx - Android widget runtime → Widget task handler: dispatches tasks
- Widget city resolver → Current location lookup: checks current location
src/features/weather-widget/utils/resolveWidgetCity.ts - Widget city resolver → Current city storage: reads fallback city
src/features/weather-widget/utils/resolveWidgetCity.ts - Widget city resolver → Widget city storage: reads override
src/features/weather-widget/utils/resolveWidgetCity.ts - Current weather widget → Condition mapping: maps condition
src/features/weather-widget/components/CurrentWeatherWidget.tsx - Current weather widget → Widget icon SVG: uses icon SVG
src/features/weather-widget/components/CurrentWeatherWidget.tsx - Widget icon SVG → Condition mapping: maps condition
src/features/weather-widget/utils/getWidgetWeatherIconSvg.ts - Themed text → Base theme tokens: uses theme tokens
src/components/themed-text.tsx - Themed view → Base theme tokens: uses theme tokens
src/components/themed-view.tsx - Weather card → App theme: uses app colors
src/features/weather/components/WeatherCard.tsx - Search screen → App theme: uses app colors
src/app/search.tsx