# ayman-alaswad-j-f-d/auracast-app architecture

> Architecture diagram of the GitHub repository ayman-alaswad-j-f-d/auracast-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ayman-alaswad-j-f-d/auracast-app
- Repository: https://github.com/ayman-alaswad-j-f-d/auracast-app

## Overview

AuraCast is a Flutter weather app. The principal workflow uses the user’s location or a searched city to show current conditions, nearby-area weather, and a five-day forecast, with a separate detailed-weather view. The README describes feature-first layers and repository/service-mediated API access; the source excerpts contain no Dart implementation, so component-level call relationships are limited to documented flows.

Main entry points: [`lib/features/weather/presentation/controllers`](https://github.com/ayman-alaswad-j-f-d/auracast-app/tree/main/lib/features/weather/presentation/controllers) (Weather controllers), [`lib/features/weather/presentation/views/home_screen.dart`](https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/features/weather/presentation/views/home_screen.dart) (Home screen), [`lib/core/network/api/api_client.dart`](https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/core/network/api/api_client.dart) (API client), [`lib/features/weather/data/repositories`](https://github.com/ayman-alaswad-j-f-d/auracast-app/tree/main/lib/features/weather/data/repositories) (Weather repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_app_entry["App entry<br/>[main.dart]"]
  node_app_setup["App setup<br/>[app.dart]"]
  node_routes["Routes<br/>[routes.dart]"]
  node_splash["Splash screen<br/>[splash_screen.dart]"]
end

subgraph group_presentation["Weather experience"]
  node_home["Home screen<br/>[home_screen.dart]"]
  node_search_ui["City search UI"]
  node_details_ui["Weather details"]
  node_forecast_ui["Forecast chart"]
  node_weather_controllers["Weather controllers"]
  node_weather_providers["Weather providers"]
end

subgraph group_domain["Weather data flow"]
  node_weather_repositories["Weather repositories"]
  node_weather_models["Weather models"]
end

subgraph group_infrastructure["Shared infrastructure"]
  node_weather_service["Weather service"]
  node_location_service["Location service"]
  node_search_service["City search service"]
  node_api_client["API client<br/>[api_client.dart]"]
  node_error_handling["Error handling"]
end

node_user(("User"))
node_open_weather{{"OpenWeatherMap"}}
node_photon{{"Photon geocoder"}}
node_gps{{"Device GPS"}}

node_user -->|"opens app"| node_app_entry
node_app_entry -->|"starts"| node_app_setup
node_app_setup -->|"registers routes"| node_routes
node_routes -->|"opens entry"| node_splash
node_user -->|"requests weather"| node_home
node_home -->|"watches state"| node_weather_controllers
node_weather_controllers -->|"uses providers"| node_weather_providers
node_weather_controllers -->|"requests data"| node_weather_repositories
node_weather_repositories -->|"uses service"| node_weather_service
node_weather_service -->|"sends requests"| node_api_client
node_api_client -->|"fetches weather"| node_open_weather
node_weather_repositories -->|"maps responses"| node_weather_models
node_weather_controllers -->|"gets location"| node_location_service
node_location_service -->|"reads position"| node_gps
node_home -->|"offers search"| node_search_ui
node_search_ui -->|"submits query"| node_weather_controllers
node_weather_controllers -->|"requests suggestions"| node_search_service
node_search_service -->|"sends requests"| node_api_client
node_api_client -->|"geocodes city"| node_photon
node_home -->|"opens details"| node_details_ui
node_home -->|"opens forecast"| node_forecast_ui
node_weather_controllers -.->|"handles failures"| node_error_handling

click node_app_entry "https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/main.dart"
click node_app_setup "https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/app/app.dart"
click node_routes "https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/app/routes/routes.dart"
click node_splash "https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/features/splash/splash_screen.dart"
click node_home "https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/features/weather/presentation/views/home_screen.dart"
click node_search_ui "https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/features/weather/presentation/views/widgets/city_search_delegate/city_search_delegate_widget.dart"
click node_details_ui "https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/features/weather/presentation/views/weather_details_screen.dart"
click node_forecast_ui "https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/features/weather/presentation/views/flowchart_details_screen.dart"
click node_weather_controllers "https://github.com/ayman-alaswad-j-f-d/auracast-app/tree/main/lib/features/weather/presentation/controllers"
click node_weather_providers "https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/features/weather/presentation/providers/weather_providers.dart"
click node_weather_repositories "https://github.com/ayman-alaswad-j-f-d/auracast-app/tree/main/lib/features/weather/data/repositories"
click node_weather_models "https://github.com/ayman-alaswad-j-f-d/auracast-app/tree/main/lib/features/weather/data/models"
click node_weather_service "https://github.com/ayman-alaswad-j-f-d/auracast-app/tree/main/lib/core/services/weather"
click node_location_service "https://github.com/ayman-alaswad-j-f-d/auracast-app/tree/main/lib/core/services/location"
click node_search_service "https://github.com/ayman-alaswad-j-f-d/auracast-app/tree/main/lib/core/services/search"
click node_api_client "https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/core/network/api/api_client.dart"
click node_error_handling "https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/core/network/errors/errors_handler.dart"

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_entry,node_app_setup,node_routes,node_splash,node_user toneBlue
class node_home,node_search_ui,node_details_ui,node_forecast_ui,node_weather_controllers,node_weather_providers toneAmber
class node_weather_repositories,node_weather_models toneMint
class node_weather_service,node_location_service,node_search_service,node_api_client,node_error_handling toneRose
class node_open_weather,node_photon,node_gps toneIndigo
```

## Components

### App shell

- [App entry](https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/main.dart): `lib/main.dart`
- [App setup](https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/app/app.dart): `lib/app/app.dart`
- [Routes](https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/app/routes/routes.dart): `lib/app/routes/routes.dart`
- [Splash screen](https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/features/splash/splash_screen.dart): `lib/features/splash/splash_screen.dart`

### Weather experience

- [Home screen](https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/features/weather/presentation/views/home_screen.dart): `lib/features/weather/presentation/views/home_screen.dart`
- [City search UI](https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/features/weather/presentation/views/widgets/city_search_delegate/city_search_delegate_widget.dart): `lib/features/weather/presentation/views/widgets/city_search_delegate/city_search_delegate_widget.dart`
- [Weather details](https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/features/weather/presentation/views/weather_details_screen.dart): `lib/features/weather/presentation/views/weather_details_screen.dart`
- [Forecast chart](https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/features/weather/presentation/views/flowchart_details_screen.dart): `lib/features/weather/presentation/views/flowchart_details_screen.dart`
- [Weather controllers](https://github.com/ayman-alaswad-j-f-d/auracast-app/tree/main/lib/features/weather/presentation/controllers): `lib/features/weather/presentation/controllers`
- [Weather providers](https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/features/weather/presentation/providers/weather_providers.dart): `lib/features/weather/presentation/providers/weather_providers.dart`

### Weather data flow

- [Weather repositories](https://github.com/ayman-alaswad-j-f-d/auracast-app/tree/main/lib/features/weather/data/repositories): `lib/features/weather/data/repositories`
- [Weather models](https://github.com/ayman-alaswad-j-f-d/auracast-app/tree/main/lib/features/weather/data/models): `lib/features/weather/data/models`

### Shared infrastructure

- [Weather service](https://github.com/ayman-alaswad-j-f-d/auracast-app/tree/main/lib/core/services/weather): `lib/core/services/weather`
- [Location service](https://github.com/ayman-alaswad-j-f-d/auracast-app/tree/main/lib/core/services/location): `lib/core/services/location`
- [City search service](https://github.com/ayman-alaswad-j-f-d/auracast-app/tree/main/lib/core/services/search): `lib/core/services/search`
- [API client](https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/core/network/api/api_client.dart): `lib/core/network/api/api_client.dart`
- [Error handling](https://github.com/ayman-alaswad-j-f-d/auracast-app/blob/main/lib/core/network/errors/errors_handler.dart): `lib/core/network/errors/errors_handler.dart`

### Other components

- **User**
- **OpenWeatherMap**
- **Photon geocoder**
- **Device GPS**

## Connections

- User → App entry: opens app (evidence: `README.md`)
- App entry → App setup: starts (evidence: `README.md`)
- App setup → Routes: registers routes (evidence: `README.md`)
- Routes → Splash screen: opens entry (evidence: `README.md`)
- User → Home screen: requests weather (evidence: `README.md`)
- Home screen → Weather controllers: watches state (evidence: `README.md`)
- Weather controllers → Weather providers: uses providers (evidence: `README.md`)
- Weather controllers → Weather repositories: requests data (evidence: `README.md`)
- Weather repositories → Weather service: uses service (evidence: `README.md`)
- Weather service → API client: sends requests (evidence: `README.md`)
- API client → OpenWeatherMap: fetches weather (evidence: `README.md`)
- Weather repositories → Weather models: maps responses (evidence: `README.md`)
- Weather controllers → Location service: gets location (evidence: `README.md`)
- Location service → Device GPS: reads position (evidence: `README.md`)
- Home screen → City search UI: offers search (evidence: `README.md`)
- City search UI → Weather controllers: submits query (evidence: `README.md`)
- Weather controllers → City search service: requests suggestions (evidence: `README.md`)
- City search service → API client: sends requests (evidence: `README.md`)
- API client → Photon geocoder: geocodes city (evidence: `README.md`)
- Home screen → Weather details: opens details (evidence: `README.md`)
- Home screen → Forecast chart: opens forecast (evidence: `README.md`)
- Weather controllers → Error handling: handles failures
