Quroz is a Flutter application built to showcase a clean, scalable, and maintainable project structure.
The app follows Clean Architecture principles to ensure a clear separation of concerns between the UI, business logic, and data layers.
The project is organized into distinct layers, each with a specific responsibility.
This structure helps in creating a modular, testable, and maintainable codebase.
lib/
├── core/
│ ├── assets/
│ │ ├── colors/
│ │ ├── fonts/
│ │ ├── icons/
│ │ └── app\_icons.dart
│ ├── common/
│ │ └── widgets/
│ │ └── svg\_icon.dart
│ ├── errors/
│ │ ├── exceptions.dart
│ │ └── failures.dart
│ └── usecase/
│ └── usecase.dart
├── features/
│ ├── account/
│ │ └── presentation/...
│ ├── activity/
│ │ └── presentation/...
│ ├── explore/
│ │ └── presentation/...
│ ├── global\_search/
│ │ └── presentation/...
│ └── marketplace/
│ ├── data/
│ │ ├── datasources/
│ │ ├── models/
│ │ └── repositories/
│ ├── domain/
│ │ ├── entities/
│ │ ├── repositories/
│ │ └── usecase/
│ └── presentation/
│ ├── bloc/
│ ├── pages/
│ └── widgets/
├── main.dart
└── pubspec.yaml
Located at lib/features/<feature_name>/presentation.
Contains all the UI code, including:
- Pages
- Widgets
- State management (BLoC)
Responsible for what the user sees and interacts with.
Located at lib/features/<feature_name>/domain.
This is the core of the application and contains:
- Business logic
- Entities (data models)
- Repository contracts
- Use cases
⚡ This layer has no knowledge of UI or data sources.
Located at lib/features/<feature_name>/data.
Responsible for:
- Fetching data from external sources (APIs, databases, etc.)
- Converting raw data into domain entities
- go_router → Robust, declarative navigation
- flutter_dotenv → Manage environment variables
- BLoC → State management
- Clean Architecture → Scalable project structure
Follow these steps to run the project:
git clone [repository_url]
cd [your_project_name]flutter pub getCreate a .env file in the root directory and add the base API URL:
BASE_URL=https://staging1.hashfame.com/api/v1/
flutter run- 📱 Responsive Design: Adapts seamlessly to different screen sizes.
- 🏠 Home Navigation: Functional bottom navigation bar for smooth transitions.
- 🌐 API Integration: Marketplace section fetches data from API endpoints.
- 📊 Structured Data Handling: Models and repositories ensure clean and consistent data flow.
This project is licensed under the MIT License – see the LICENSE file for details.