implement-data

To implement a Flutter data layer, create files under lib/data/ for Models, DataSources, and Repositories. This structure separates raw data retrieval from domain logic, ensuring consistent JSON serialization, error handling, and API wiring.

The best way to structure Flutter data sources and repositories is to have DataSources return raw data like Maps or HttpResponse, while Repository implementations handle errors with try/catch blocks and wrap results for safe data flows.

To parse JSON and map API responses in Flutter, build Models that extend domain entities using fromJson and toJson methods. This approach cleanly translates raw API data into usable domain objects without cluttering the core layer.

You do not strictly need a separate local cache, but Repository implementations support optional caching strategies. Integrating local caching within the data layer allows you to store retrieved API data and reduce redundant network calls.

Flutter repositories fail to handle API errors when DataSources attempt to manage exceptions instead of returning raw data. Repositories should implement try/catch blocks and Result wrapping to safely catch failures and manage error states.

You can add a new data source to a Flutter clean architecture project by creating a new file under lib/data/datasources. The Skill activates for modifying existing files to wire API calls, parse JSON, or connect the new DataSource to its Repository.