GSOC Organizations

This is an example app which demonstrates the use of BLoC State Management and Clean Architecture in Flutter. This app uses a GSOC API which can be found here.

For maintainable apps, every feature of the app, for example the home feature in the above code, must implement and follow clean architecture pattern. In this, every feature folder is divided into three major types of folders which are Data, Domain and Presentation.

Presentation : This is the folder where all the magic UI,UX and State Management is going to happen. This is further divided into cubit, pages and widgets.
Cubit contains the BLoC logic of the app where all the calls to the domain/repository layer are made and the where the State of the app is managed.
Pages contains the screen dart files which are displayed as pages.
Widgets are like small indivisual components of each page, contained in the Widgets folder.

Domain : This layer acts as an intermediatory which is independant of data sources or UI changes. This is further divided into usecases, entities and repositories.
UseCases contains the usecases of the app or the user which are simply dart classes arranged as dart files.
Entities are just like models but they do not contain the data conversion methods, for example they cannot have toJson and fromJson methods..
Repositories in domain layer are the abstract class definitions of repositories and the data layer.

Data : This layer is the root or source of all the data used by the app.
datasources contains the various data source files which are required by the app for example local and online DB.
Models contains model files which are used to convert json or xml data into dart objects.
Repositories contains the abstraction implementations of the repositories in domain layer.