How ayman-alaswad-j-f-d/auracast-app works
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: controllers Weather controllers · home_screen.dart Home screen · api_client.dart API client · repositories Weather repositories
Components 21
App shell
- App entry
lib/main.dart - App setup
lib/app/app.dart - Routes
lib/app/routes/routes.dart - Splash screen
lib/features/splash/splash_screen.dart
Weather experience
- Home screen
lib/features/weather/presentation/views/home_screen.dart - City search UI
lib/features/weather/presentation/views/widgets/city_search_delegate/city_search_delegate_widget.dart - Weather details
lib/features/weather/presentation/views/weather_details_screen.dart - Forecast chart
lib/features/weather/presentation/views/flowchart_details_screen.dart - Weather controllers
lib/features/weather/presentation/controllers - Weather providers
lib/features/weather/presentation/providers/weather_providers.dart
Weather data flow
- Weather repositories
lib/features/weather/data/repositories - Weather models
lib/features/weather/data/models
Shared infrastructure
- Weather service
lib/core/services/weather - Location service
lib/core/services/location - City search service
lib/core/services/search - API client
lib/core/network/api/api_client.dart - Error handling
lib/core/network/errors/errors_handler.dart
Other components
- User
- OpenWeatherMap
- Photon geocoder
- Device GPS
Connections 22
- User → App entry: opens app
README.md - App entry → App setup: starts
README.md - App setup → Routes: registers routes
README.md - Routes → Splash screen: opens entry
README.md - User → Home screen: requests weather
README.md - Home screen → Weather controllers: watches state
README.md - Weather controllers → Weather providers: uses providers
README.md - Weather controllers → Weather repositories: requests data
README.md - Weather repositories → Weather service: uses service
README.md - Weather service → API client: sends requests
README.md - API client → OpenWeatherMap: fetches weather
README.md - Weather repositories → Weather models: maps responses
README.md - Weather controllers → Location service: gets location
README.md - Location service → Device GPS: reads position
README.md - Home screen → City search UI: offers search
README.md - City search UI → Weather controllers: submits query
README.md - Weather controllers → City search service: requests suggestions
README.md - City search service → API client: sends requests
README.md - API client → Photon geocoder: geocodes city
README.md - Home screen → Weather details: opens details
README.md - Home screen → Forecast chart: opens forecast
README.md - Weather controllers → Error handling: handles failures