# Saropa Lints Reference Links

## Project

- [saropa_lints on pub.dev](https://pub.dev/packages/saropa_lints)
- [saropa_lints CHANGELOG on pub.dev](https://pub.dev/packages/saropa_lints/changelog)
- [GitHub Repository](https://github.com/saropa/saropa_lints)
- [Issue Tracker](https://github.com/saropa/saropa_lints/issues)
- [Saropa Website](https://saropa.com/)

## Documentation

- [ROADMAP.md](ROADMAP.md) — Planned rules and implementation priorities; [Part 2](ROADMAP.md#part-2-deferred-rules--technical-limitations) covers deferred rules (cross-file, heuristic, technical limitations)
- [MIGRATION_V5.md](MIGRATION_V5.md) — v4 (custom_lint) → v5 (native analyzer plugin) upgrade; the full migration plan was previously in `bugs/history/plans/ROADMAP_NATIVE_PLUGIN.md`

## Custom Lint Development

- [custom_lint package](https://pub.dev/packages/custom_lint)
- [custom_lint_builder package](https://pub.dev/packages/custom_lint_builder)
- [Creating custom lint rules (Riverpod blog)](https://riverpod.dev/docs/concepts/about_code_generation)

## Dart Analyzer

- [analyzer package](https://pub.dev/packages/analyzer)
- [Dart AST documentation](https://github.com/dart-lang/sdk/tree/main/pkg/analyzer/doc)
- [Understanding the Dart AST](https://medium.com/dartlang/understanding-the-dart-ast-8a1c8d8b3a0a)

## Dart & Flutter Linting Standards

- [Effective Dart](https://dart.dev/guides/language/effective-dart)
- [Dart Linter Rules](https://dart.dev/tools/linter-rules)
- [Flutter Lints package](https://pub.dev/packages/flutter_lints)
- [Very Good Analysis](https://pub.dev/packages/very_good_analysis)

## Flutter Best Practices

- [Flutter Performance Best Practices](https://docs.flutter.dev/perf/best-practices)
- [Flutter Widget Lifecycle](https://api.flutter.dev/flutter/widgets/State-class.html)
- [Flutter Accessibility](https://docs.flutter.dev/ui/accessibility-and-internationalization/accessibility)

## Testing

- [Dart Testing](https://dart.dev/guides/testing)
- [Flutter Testing](https://docs.flutter.dev/testing)

## Package-Specific Rule Sources

These resources informed the package-specific lint rules in Part 5 of the ROADMAP.

### Articles & Blogs

- [DCM Blog: 15 Common Mistakes in Flutter and Dart Development](https://dcm.dev/blog/2025/03/24/fifteen-common-mistakes-flutter-dart-development)
- [DCM Blog: The Hidden Cost of Async Misuse in Flutter](https://dcm.dev/blog/2025/05/28/hidden-cost-async-misuse-flutter-fix)

### State Management

- [Riverpod Documentation](https://riverpod.dev/docs/) — Official Riverpod best practices
- [Bloc Documentation](https://bloclibrary.dev/) — Official Bloc library documentation

### Networking & Data

- [Dio Package](https://pub.dev/packages/dio) — HTTP client documentation
- [cached_network_image](https://pub.dev/packages/cached_network_image) — Image caching documentation

### Navigation

- [go_router Package](https://pub.dev/packages/go_router) — Navigation documentation

### Firebase & Backend

- [Flutter Firebase](https://firebase.flutter.dev/) — FlutterFire documentation

### Security & Storage

- [permission_handler](https://pub.dev/packages/permission_handler) — Permission handling best practices
- [flutter_secure_storage](https://pub.dev/packages/flutter_secure_storage) — Secure storage documentation

### Local Databases

- [Isar Database](https://isar.dev/) — Fast cross-platform NoSQL database documentation
- [Hive Database](https://pub.dev/packages/hive) — Lightweight key-value database documentation

## Dart & Flutter Evolution

- [Dart 3.x Release Notes](https://dart.dev/guides/language/evolution) — New language features by version
- [Flutter Release Notes](https://docs.flutter.dev/release/release-notes) — Widget and framework changes
- [Dart Analyzer API](https://pub.dev/documentation/analyzer/latest/) — AST visitor documentation

## Standards & Guidelines

- [WCAG 2.1 Guidelines](https://www.w3.org/WAI/WCAG21/quickref/) — Accessibility success criteria
- [OWASP Mobile Security](https://owasp.org/www-project-mobile-security-testing-guide/) — Mobile application security testing

## Contact

- [Email](mailto:dev@saropa.com)
