📚 Documentation #

• Added comprehensive dartdoc comments for better API documentation
• Created example/ directory with sample usage
• Added example Flutter app with ValueKey usage
• Improved pub.flutter-io.cn score compliance

🐛 Bug Fixes #

• Fixed dependency version conflict: downgraded lints from ^5.0.0 to ^3.0.0 for Dart 3.2.0 compatibility
• Fixed GitHub Actions workflow paths and YAML syntax

🐛 Bug Fixes

• Fixed release date in changelog from placeholder to actual date

🎉 Initial Release #

✨ Features

• Key Validation Engine: Comprehensive Flutter key detection and validation

  • Support for ValueKey and Key declarations
  • Support for find.byValueKey, find.bySemanticsLabel, find.byTooltip finders
  • Regex-based pattern matching for accurate key detection

• Project Dependency Validation

  • Automatic detection of integration_test dependency
  • Automatic detection of appium_flutter_server dependency
  • Validation of proper integration test setup

• CLI Interface

  • --keys flag for specifying YAML key definitions
  • --path flag for custom project paths
  • --strict mode for catching extra keys
  • --verbose flag for detailed output

• YAML Configuration Support

  • Simple key list format
  • Support for dynamic keys with placeholders
  • Comments and organization support

• Beautiful Console Output

  • Colorful ANSI output with emojis
  • Structured sections for different validation types
  • Clear success/failure indicators
  • File path reporting for found keys

🛠️ Technical Features

• Cross-platform compatibility (Windows, macOS, Linux)
• Recursive directory scanning
• Efficient regex-based key detection
• Comprehensive error handling
• Unit test coverage

📦 Package Structure

• Clean library API with KeyChecker class
• Separated CLI and core functionality
• Example project with integration tests
• Comprehensive documentation

🧪 Testing & Quality

• Unit tests for core functionality
• Integration test examples
• Linting with package:lints
• Code coverage reporting

🚀 Getting Started #

dart pub global activate flutter_keycheck
flutter_keycheck --keys expected_keys.yaml

📋 Requirements #

• Dart SDK >= 3.2.0
• Flutter project with integration tests (for full validation)

Future Roadmap #

🔮 Planned Features (v1.1.0+) #

• ❌ Auto-generation of expected_keys.yaml from existing code
• ❌ Support for additional finder methods (find.text, find.byIcon)
• ❌ HTML/Markdown report generation
• ❌ Monorepo support with multiple pubspec.yaml files
• ❌ Auto-fix capabilities for missing keys
• ❌ Plugin architecture for custom checkers
• ❌ Integration with popular CI/CD platforms

💡 Ideas Under Consideration #

• JSON configuration format support
• Key usage analytics and statistics
• Integration with Flutter Inspector
• VS Code extension for real-time validation
• GitHub App for automated PR checks

For the complete list of changes, see the commit history.