FLUTTER ECOSYSTEM

ashtanko/flutter_bloc_app_template

📦 Um modelo robusto para construir aplicativos Flutter usando o padrão BLoC, promovendo uma separação clara de responsabilidades e melhorando a manutenibilidade. Ideal para desenvolvedores que buscam soluções escalonáveis de gerenciamento de estado.

Ver no GitHub ↗

Capa do projeto flutter_bloc_app_template

Stars: 197
Forks: 46
Último push (UTC): 16 de set. de 2026
Status do projeto: Ativo

GITHUB User

Oleksii Shtanko ↗

Senior Android Engineer. I am passionate about Android, Flutter and Golang

Lisbon, PortugalSite oficial ↗

LinguagensDartMakefileRubyShellKotlinSwiftObjective-C

Tópicos técnicos

# bloc # flutter # flutter-bloc-pattern # flutter-template # flutter-material # intl # theme-switcher # flutter-lint # dart # dartlang # flutter-demo # flutter-examples # github-actions # template-repository # unit-testing # developwithgoogle

Dependências usadas

Lista de dependências 50 itens

flutter{"sdk":"flutter"}
flutter_bloc^9.0.0
bloc^9.0.0
logger^2.5.0
equatable^2.0.7
http^1.4.0
json_annotation^4.9.0
shared_preferences^2.5.2
dio^5.8.0+1
intl^0.20.2
google_fonts8.2.1
freezed_annotation^3.0.0
intl_utils^2.8.10
effective_dart^1.3.2
flutter_svg^2.0.17
gap^3.0.1
path_provider^2.1.5
file^7.0.0
get_it9.2.1
injectable^2.5.0
nullx^0.1.17
retrofit^4.4.2
retrofit_generator^10.0.1
dartz^0.10.1
talker^5.0.0
talker_logger^5.0.0
talker_dio_logger^5.0.0
talker_bloc_logger^5.0.0
animations^3.0.0
yaml^3.1.2
collection^1.18.0
package_info_plus^10.0.0
provider^6.1.5
url_launcher^6.3.2
flutter_localizations{"sdk":"flutter"}
flutter_testDesenvolvimento{"sdk":"flutter"}
integration_testDesenvolvimento{"sdk":"flutter"}
flutter_driverDesenvolvimento{"sdk":"flutter"}
build_runnerDesenvolvimento^2.4.15
injectable_generatorDesenvolvimento^2.9.1
flutter_gen_runnerDesenvolvimento^5.9.0
json_serializableDesenvolvimento^6.11.2
lintDesenvolvimento^2.8.0
mockitoDesenvolvimento^5.4.5
bloc_testDesenvolvimento^10.0.0
flutter_lintsDesenvolvimento^6.0.0
mocktailDesenvolvimento^1.0.4
freezedDesenvolvimento^3.2.3
network_image_mockDesenvolvimento^2.1.1
flutter_oss_licensesDesenvolvimento^3.0.4

Rankings

Architecture#86

README original

Texto original em inglês. Visite o GitHub para a versão atual.

Expandir / recolher README

flutter-bloc-app-template 🤖

This is a basic Flutter project template that uses the BLoC pattern architecture for state management. It is a good starting point for creating a new Flutter app that uses BLoC for state management.

This template is focused on delivering a project with static analysis and continuous integration already in place.

style: lint codecov CI CodeFactor License style: effective dart GitHub forks GitHub stars Codacy Badge Codacy Badge

How to use 🐾

Just click on Use this template button to create a new repo starting from this template.

Features 🦄

Theme support
BLoC pattern bloc
Service Locator using get_it
Localization using intl
CI Setup with GitHub Actions
Codecov Setup with GitHub Actions
Unit test coverage
Integration tests

Configuration

The template has 3 flavors:

dev
prod
qa

The template has 3 build variants:

debug
profile
release

For example dev configuration for Android Studio looks like:

https://raw.githubusercontent.com/ashtanko/flutter_bloc_app_template/HEAD/preview/config/dev.png

dev: --flavor dev -t lib/main_dev.dart

Android Screenshots

https://raw.githubusercontent.com/ashtanko/flutter_bloc_app_template/HEAD/preview/android/launches_android_dark_theme.png https://raw.githubusercontent.com/ashtanko/flutter_bloc_app_template/HEAD/preview/android/launches_android_light_theme.png

https://raw.githubusercontent.com/ashtanko/flutter_bloc_app_template/HEAD/preview/android/messages_android_dark_theme.png https://raw.githubusercontent.com/ashtanko/flutter_bloc_app_template/HEAD/preview/android/messages_android_ligth_theme.png

iOS Screenshots

https://raw.githubusercontent.com/ashtanko/flutter_bloc_app_template/HEAD/preview/ios/launches_ios_dark_theme.png https://raw.githubusercontent.com/ashtanko/flutter_bloc_app_template/HEAD/preview/ios/launches_ios_light_theme.png

https://raw.githubusercontent.com/ashtanko/flutter_bloc_app_template/HEAD/preview/ios/messages_ios_dark_theme.png https://raw.githubusercontent.com/ashtanko/flutter_bloc_app_template/HEAD/preview/ios/messages_ios_ligth_theme.png

Static Analysis 🔍

This template is using analyzer

Supported Lint Rules

Supported Dart Code Metrics

Dart Lint

CI ⚙️

This template is using GitHub Actions as CI. You don't need to setup any external service and you should have a running CI once you start using this template.

How to build 🛠️

The Project uses FlutterGen to generate localizations, dependencies and mocks

Activate flutter_gen using dart pub global activate flutter_gen command if you haven't done that before.

after add export PATH="$PATH":"$HOME/.pub-cache/bin" to bash_profile

# clean project, install dependencies & generate sources
make

# generate localizations, dependencies, image assets, colors, fonts
make gen

# generate localizations
make localize

# analyze the project
check

Reminders 🧠

Change name in pubspec.yaml file

Remove anything you don't need

Configure analysis_options.yaml for your needs

Contributing 🤝

Feel free to open a issue or submit a pull request for any bugs/improvements.

License 📄

This template is licensed under the MIT License - see the License file for details. Please note that the generated template is offering to start with a MIT license but you can change it to whatever you wish, as long as you attribute under the MIT terms that you're using the template.