🎬 Movie App
https://embed.figma.com/design/XUI0FcwkjT7dk5oW1YI2dp/Movies-app--Community-?node-id=6-686&m=dev&t=ZvejD5NqFyy0bQZ1-1&embed-host=notion&footer=false&theme=system
This section maps every key file to its purpose, location, and rationale.
lib/
├── main.dart
│ └── Initializes dependencies (API, Repo, UseCases)
│ Injects into MovieCubit via BlocProvider
│ Loads the HomeScreen
├── core/
│ └── theme/
│ └── app_theme.dart
│ - Global dark theme (colors, fonts)
├── movie_app/
│ ├── domain/
│ │ ├── entities/
│ │ │ └── movie.dart
│ │ │ - Core movie structure (id, title, rating, poster)
│ │ │ - No Flutter or JSON logic
│ │ ├── usecases/
│ │ │ └── get_*.dart
│ │ │ - Business logic
│ │ │ - Calls execute() → returns List<Movie>
│ │ └── infra/
│ │ └── movie_repository.dart
│ │ - Abstract repository interface for use cases
│ ├── infra/
│ │ ├── datasources/
│ │ │ └── movie_api_service.dart
│ │ │ - Makes raw HTTP calls
│ │ ├── models/
│ │ │ └── movie_response.dart
│ │ │ - Parses JSON
│ │ │ - Maps to `Movie` via toEntity()
│ │ └── repository/
│ │ └── movie_repository_impl.dart
│ │ - Implements MovieRepository
│ │ - Connects API → DTO → Entity
│ ├── presenter/
│ │ ├── controllers/
│ │ │ └── cubit/
│ │ │ ├── movie_cubit.dart
│ │ │ │ - Uses injected UseCases
│ │ │ │ - fetchMoviesByCategory(), getFeaturedMovies()
│ │ │ └── movie_state.dart
│ │ │ - State classes for UI: Loading, Loaded, Error
│ │ └── ui/
│ │ ├── home_screen.dart
│ │ │ - Main UI screen
│ │ │ - Displays search, categories, movie grid
│ │ └── widgets/
│ │ ├── search_bar_widget.dart
│ │ │ - TextField + clear icon
│ │ ├── featured_movie_card.dart
│ │ │ - Carousel for 2 top movies
│ │ ├── movie_grid.dart
│ │ │ - GridView builder
│ │ └── movie_poster_card.dart
│ │ - Shows each movie poster with rating
🎯 Each file belongs to a distinct layer: