# bloc_lint 0.4.1

Official lint rules for development when using the bloc state management library.




## Installing
```
export PUB_HOSTED_URL=https://pub.mirror.p-hatan.ir
flutter pub add 'bloc_lint:0.4.1'
```
Published: 2026-04-12T17:59:28.905063Z
Expected archive SHA-256: 5bf965e3be5346fd6133e7f2eb4c845de3f2ae09eeae4d6622f400848b4aba71

Available in cache; verification: upstream_checksum
## Direct dependencies
- _fe_analyzer_shared: >=93.0.0 <=99.0.0
- checked_yaml: ^2.0.0
- collection: ^1.0.0
- glob: ^2.0.0
- json_annotation: ^4.9.0
- path: ^1.0.0
- pubspec_lock_parse: ^2.0.0

## Package README (untrusted upstream documentation)
<p align="center">
<img src="https://raw.githubusercontent.com/felangel/bloc/master/assets/logos/bloc_lint.png" height="100" alt="Bloc" />
</p>

<p align="center">
<a href="https://pub.dev/packages/bloc_lint"><img src="https://img.shields.io/pub/v/bloc_lint.svg" alt="Pub"></a>
<a href="https://github.com/felangel/bloc/actions"><img src="https://github.com/felangel/bloc/actions/workflows/main.yaml/badge.svg" alt="build"></a>
<a href="https://codecov.io/gh/felangel/bloc"><img src="https://codecov.io/gh/felangel/Bloc/branch/master/graph/badge.svg" alt="codecov"></a>
<a href="https://github.com/felangel/bloc"><img src="https://img.shields.io/github/stars/felangel/bloc.svg?style=flat&logo=github&colorB=deeppink&label=stars" alt="Star on Github"></a>
<a href="https://pub.dev/packages/bloc_lint"><img src="https://img.shields.io/badge/style-bloc_lint-20FFE4.svg" alt="style: bloc lint"></a>
<a href="https://flutter.dev/docs/development/data-and-backend/state-mgmt/options#bloc--rx"><img src="https://img.shields.io/badge/flutter-website-deepskyblue.svg" alt="Flutter Website"></a>
<a href="https://github.com/Solido/awesome-flutter#standard"><img src="https://img.shields.io/badge/awesome-flutter-blue.svg?longCache=true" alt="Awesome Flutter"></a>
<a href="https://fluttersamples.com"><img src="https://img.shields.io/badge/flutter-samples-teal.svg?longCache=true" alt="Flutter Samples"></a>
<a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-purple.svg" alt="License: MIT"></a>
<a href="https://discord.gg/bloc"><img src="https://img.shields.io/discord/649708778631200778.svg?logo=discord&color=blue" alt="Discord"></a>
<a href="https://github.com/felangel/bloc"><img src="https://tinyurl.com/bloc-library" alt="Bloc Library"></a>
</p>

---

Official lint rules for development when using the bloc state management library.

**Learn more at [bloclibrary.dev](https://bloclibrary.dev)!**

This package is built to work with:

- [bloc](https://pub.dev/packages/bloc)
- [bloc_tools](https://pub.dev/packages/bloc_tools)
- [flutter_bloc](https://pub.dev/packages/flutter_bloc)
- [angular_bloc](https://pub.dev/packages/angular_bloc)
- [bloc_concurrency](https://pub.dev/packages/bloc_concurrency)
- [bloc_test](https://pub.dev/packages/bloc_test)
- [hydrated_bloc](https://pub.dev/packages/hydrated_bloc)
- [replay_bloc](https://pub.dev/packages/replay_bloc)

---

## Sponsors

Our top sponsors are shown below! [[Become a Sponsor](https://github.com/sponsors/felangel)]

<table style="background-color: white; border: 1px solid black">
    <tbody>
        <tr>
            <td align="center" style="border: 1px solid black">
                <a href="https://shorebird.dev"><img src="https://raw.githubusercontent.com/felangel/bloc/master/assets/sponsors/shorebird.png" width="225"/></a>
            </td>            
            <td align="center" style="border: 1px solid black">
                <a href="https://getstream.io/chat/flutter/tutorial/?utm_source=Github&utm_medium=Github_Repo_Content_Ad&utm_content=Developer&utm_campaign=Github_Jan2022_FlutterChat&utm_term=bloc"><img src="https://raw.githubusercontent.com/felangel/bloc/master/assets/sponsors/stream.png" width="225"/></a>
            </td>
            <td align="center" style="border: 1px solid black">
                <a href="https://rettelgame.com/"><img src="https://raw.githubusercontent.com/felangel/bloc/master/assets/sponsors/rettel.png" width="225"/></a>
            </td>
        </tr>
    </tbody>
</table>

---

## Quick Start

1. Install the [bloc command-line tools](https://pub.dev/packages/bloc_tools)

   ```sh
   dart pub global activate bloc_tools
   ```

2. Install the [bloc_lint](https://pub.dev/packages/bloc_lint) package

   ```sh
   dart pub add --dev bloc_lint
   ```

3. Add an `analysis_options.yaml` to the root of your project with the
   recommended rules

   ```yaml
   include: package:bloc_lint/recommended.yaml
   ```

4. Run the linter

   ```sh
   bloc lint .
   ```

For more information, check out the [official documentation](https://bloclibrary.dev/lint)

## Recommended Lint Rules

- [avoid_flutter_imports](https://bloclibrary.dev/lint-rules/avoid_flutter_imports)
- [avoid_public_bloc_methods](https://bloclibrary.dev/lint-rules/avoid_public_bloc_methods)
- [avoid_public_fields](https://bloclibrary.dev/lint-rules/avoid_public_fields)
- [prefer_file_naming_conventions](https://bloclibrary.dev/lint-rules/prefer_file_naming_conventions)
- [prefer_void_public_cubit_methods](https://bloclibrary.dev/lint-rules/prefer_void_public_cubit_methods)

## All Lint Rules

- [avoid_build_context_extensions](https://bloclibrary.dev/lint-rules/avoid_build_context_extensions)
- [avoid_flutter_imports](https://bloclibrary.dev/lint-rules/avoid_flutter_imports)
- [avoid_public_bloc_methods](https://bloclibrary.dev/lint-rules/avoid_public_bloc_methods)
- [avoid_public_fields](https://bloclibrary.dev/lint-rules/avoid_public_fields)
- [prefer_bloc](https://bloclibrary.dev/lint-rules/prefer_bloc)
- [prefer_build_context_extensions](https://bloclibrary.dev/lint-rules/prefer_build_context_extensions)
- [prefer_cubit](https://bloclibrary.dev/lint-rules/prefer_cubit)
- [prefer_file_naming_conventions](https://bloclibrary.dev/lint-rules/prefer_file_naming_conventions)
- [prefer_void_public_cubit_methods](https://bloclibrary.dev/lint-rules/prefer_void_public_cubit_methods)

## Dart Versions

- Dart 3: >= 3.7.0

## Maintainers

- [Felix Angelov](https://github.com/felangel)

## Changelog
# 0.4.1

- deps: adjust upper bound for `_fe_analyzer_shared`

# 0.4.0

- feat: upgrade to latest analyzer frontend

# 0.3.7

- fix: `analysis_options.yaml` resolution in pub workspace
- deps: support latest stable Flutter version.

# 0.3.6

- feat: upgrade to latest analyzer frontend

# 0.3.5

- fix: adjust upper bound for `_fe_analyzer_shared`

# 0.3.4

- chore: various dependency upgrades

# 0.3.3

- fix: ignore whitespace in ignore comments
- docs: add `bloc_lint` badge to `README`

# 0.3.2

- feat: add [prefer_build_context_extensions](https://bloclibrary.dev/lint-rules/prefer_build_context_extensions)

# 0.3.1

- fix: adjust lower bound for `_fe_analyzer_shared`

# 0.3.0

- fix: widen supported version ranges for `_fe_analyzer_shared`
- feat: add [avoid_build_context_extensions](https://bloclibrary.dev/lint-rules/avoid_build_context_extensions)
- feat: add [prefer_file_naming_conventions](https://bloclibrary.dev/lint-rules/prefer_file_naming_conventions)

# 0.2.1

- feat: ignore dot directories
- fix: include bloc/cubit instances defined in any file
- chore: various dependency upgrades

# 0.2.0

- chore: stable `0.2.0` release 🎉
- chore: various dependency upgrades
- fix: ignore `.fvm`

# 0.2.0-dev.6

- fix: `prefer_void_public_cubit_methods` false positive when using switch expressions
- fix: `avoid_public_bloc_methods` false positive when using switch expressions

# 0.2.0-dev.5

- fix: `avoid_public_bloc_methods` false positive when using switch expressions

# 0.2.0-dev.4

- fix: various bug fixes for Windows

# 0.2.0-dev.3

- feat: add support for `// ignore`
- feat: add support for `// ignore_for_file`

# 0.2.0-dev.2

- feat: add [prefer_void_public_cubit_methods](https://bloclibrary.dev/lint-rules/prefer_void_public_cubit_methods)

# 0.2.0-dev.1

- fix: package resolution in `include` on windows
- fix: uri resolution on windows
- docs: improvements to `README.md`

# 0.2.0-dev.0

- Full rewrite of `pkg:bloc_lint`
- Supported Lint Rules
  - [avoid_flutter_imports](https://bloclibrary.dev/lint-rules/avoid_flutter_imports)
  - [avoid_public_bloc_methods](https://bloclibrary.dev/lint-rules/avoid_public_bloc_methods)
  - [avoid_public_fields](https://bloclibrary.dev/lint-rules/avoid_public_fields)
  - [prefer_bloc](https://bloclibrary.dev/lint-rules/prefer_bloc)
  - [prefer_cubit](https://bloclibrary.dev/lint-rules/prefer_cubit)

# 0.1.0

- Initial experimental community release using `pkg:custom_lint`