Domain-Driven Bloc

Domain-Driven Bloc jumpstarts your Flutter projects with a clean, modular foundation. Get instant best practices—Bloc, Clean Architecture, DI, and feature isolation—so you can focus on building, not boilerplate. Everything you need for fast, confident app development is ready out of the box.

---

Credits 🙏

This project was originally developed by Very Good Ventures 🦄

It has been forked and adapted for creating different app templates with a clean architecture based on domain driven design

This fork is not officially maintained or affiliated with Very Good Ventures.

---

Getting Started 🚀

This app template can be generated using mason_cli with customized variables.

Ensure you have mason_cli installed.

# Activate mason_cli from https://pub.dev
dart pub global activate mason_cli

# Or install from https://brew.sh
brew tap felangel/mason
brew install mason

Installation

# Install locally
mason add domain_driven_bloc

# Or install globally
mason add -g domain_driven_bloc

Usage 🚀

# Generate the domain_driven_bloc app template
mason make domain_driven_bloc

---

What's Included ✨

Everything you need for a modern, production-grade Flutter app:

• 🏛️ Clean Architecture: Modular, scalable architecture inspired by DDD—separation of concerns, testability, and maintainability.
• 🧩 Feature Isolation: Each feature is fully modular for easy scaling and testing.
• 🧠 Bloc State Management: Clean separation of business logic and UI using Bloc.
• 🧬 Dependency Injection: Built-in DI with injectable, get_it for testability and loose coupling.
• 🛠 Configurable Build Flavors: Effortless switching between dev, staging, and prod environments.
• 🌍 Internationalization: Streamlined i18n with codegen—add new languages in minutes, no manual boilerplate.
• 🛡 Null Safety: 100% sound null safety for safer, more reliable code.
• 🔒 Secure Storage: Secure sensitive data with flutter_secure_storage.
• 🧪 Testing Suite: Extensive unit, widget, and golden tests; includes mocks, fakes, and golden tests for robust, reliable test suites.
• 📝 Extensible Logging: Catch and log uncaught exceptions, plug in your own loggers, or use pretty logging for debugging and production.
• 🏎 Performance Ready: Responsive layouts and best practices for smooth UX on all platforms.
• 🧑‍💻 Developer Experience: Makefile, FVM, and pre-configured analysis for fast onboarding and consistent code quality.
• 🤖 CI/CD Ready: Lint, format, test, and coverage checks via GitHub Actions.
• 🔄 Automated Dependency Updates: Dependabot keeps your dependencies fresh and secure.

Key Packages 🗃

• 🧠 State Management: flutter_bloc, flutter_hooks
• 🧮 Functional Programming: fpdart, fpvalidate
• 🗄️ Model: freezed, json_serializable
• 🧭 Navigation: go_router
• 🧬 DI: injectable, get_it
• 📱 Responsive: responsive_framework
• 🌱 Env: flutter_dotenv
• 🌐 HTTP: chopper
• 💾 Storage: flutter_secure_storage, shared_preferences
• 🛡 Security: safe_device
• 📝 Logging: logger, pretty_chopper_logger
• 🌍 Localization: intl, slang
• 🧾 Device Info: package_info_plus, device_info_plus
• 🖼 Assets: flutter_svg, flutter_gen
• 🧪 Testing: alchemist, bloc_test
• 🦾 Mocking: mockito, mocktail_image_network, faker
• 🧹 Code Quality: very_good_analysis, dart_code_metrics

Output 🗂️

Core Functionality 🏅

• 🏠 Home: Live Reddit FlutterDev feed integration—real-world API, pagination, error handling.
• 🔐 Auth: Mock login using DummyJSON—prototype real auth flows with any user.
• 👤 Profile: Mock user profile via DummyJSON—user state management and editing patterns.
• 🌙 Dark Mode: Seamless theme switching with persistent user preference.

Architecture 🏗️

---

Folder Structure 📁

Output after running the template:

├── .github
│   ├── PULL_REQUEST_TEMPLATE.md
│   ├── dependabot.yaml
│   └── workflows
│       └── main.yaml
├── .idea
│   └── runConfigurations
│       ├── development.xml
│       ├── production.xml
│       └── staging.xml
├── .vscode
│   ├── extensions.json
│   └── launch.json
├── android
├── assets
│   ├── env
│   ├── fonts
│   ├── icons
│   ├── images
│   └── i18n
│       └── en.i18n.json
├── ios
├── lib
│   ├── app
│   │   ├── config
│   │   ├── constants
│   │   ├── generated
│   │   ├── helpers
│   │   │   ├── converters
│   │   │   ├── extensions
│   │   │   └── injection
│   │   ├── observers
│   │   ├── routes
│   │   ├── themes
│   │   ├── utils
│   │   └── app.dart
│   ├── core
│   │   ├── data
│   │   │   ├── dto
│   │   │   ├── repository
│   │   │   └── service
│   │   ├── domain
│   │   │   ├── cubit
│   │   │   ├── interface
│   │   │   └── entity
│   │   │       └── enum
│   │   └── presentation
│   │       ├── views
│   │       └── widgets
│   │           └── dialogs
│   │           └── wrappers
│   ├── features
│   │   ├── auth
│   │   │   ├── data
│   │   │   │   ├── dto
│   │   │   │   ├── repository
│   │   │   │   └── service
│   │   │   ├── domain
│   │   │   │   ├── cubit
│   │   │   │   ├── interface
│   │   │   │   └── entity
│   │   │   └── presentation
│   │   │       ├── views
│   │   │       └── widgets
│   │   ├── home
│   │   │   ├── data
│   │   │   │   ├── dto
│   │   │   │   ├── repository
│   │   │   │   └── service
│   │   │   ├── domain
│   │   │   │   ├── cubit
│   │   │   │   ├── interface
│   │   │   │   └── entity
│   │   │   └── presentation
│   │   │       ├── views
│   │   │       └── widgets
│   │   └── profile
│   │       ├── data
│   │       │   ├── dto
│   │       │   ├── repository
│   │       │   └── service
│   │       ├── domain
│   │       │   ├── cubit
│   │       │   ├── interface
│   │       │   └── entity
│   │       └── presentation
│   │           ├── views
│   │           └── widgets
│   │
│   ├── main.dart
├── scripts
├── test
│   ├── utils
│   ├── unit
│   │   ├── core
│   │   │   ├── cubit
│   │   │   └── repository
│   │   └── features
│   │       ├── auth
│   │       │   ├── cubit
│   │       │   └── repository
│   │       └── home
│   │           ├── cubit
│   │           └── repository
│   ├── widget
│   │   ├── core
│   │   │   ├── dialogs
│   │   │   │   ├── goldens(generated)
│   │   │   │   └── failures(generated)
│   │   │   └── widgets
│   │   │       ├── goldens(generated)
│   │   │       └── failures(generated)
│   │   └── features
│   │       ├── auth
│   │       │   └── widgets
│   │       │       ├── goldens(generated)
│   │       │       └── failures(generated)
│   │       ├── home
│   │       │   └── widgets
│   │       │       ├── goldens(generated)
│   │       │       └── failures(generated)
│   │       └── profile
│   │           └── widgets
│   │               ├── goldens(generated)
│   │               └── failures(generated)
│   └── flutter_test_config.dart
├── web
├── .gitignore
├── analysis_options.yaml
├── coverage_badge.svg
├── LICENSE
├── Makefile
├── pubspec.lock
├── pubspec.yaml
└── README.md

---

Screenshots 📷

Login Screen	Home Screen	Profile Screen

Contributing 🤝

Contributions are welcome! To get started:

1. Fork the repo and create your branch from main.
2. Make your changes, following the existing code style and conventions.
3. Add tests for any new features or bug fixes.
4. Run the linter and tests to ensure everything passes:

   make lint         # for static analysis
   make lcov_*      # for running tests and generating coverage (see Makefile for available targets)

5. Open a pull request with a clear description of your changes.

For major changes, please open an issue first to discuss what you'd like to change.

If you have questions, suggestions, or want to discuss ideas, feel free to open an issue or start a discussion.

---