flutterfy 1.1.1+1727741864 copy "flutterfy: ^1.1.1+1727741864" to clipboard
flutterfy: ^1.1.1+1727741864 copied to clipboard

A powerful command-line tool for Flutter and Dart projects to automatically manage semantic version updates in pubspec.yaml files. Supports patch, minor, and major version increments with intelligent [...]

Changelog #

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.1.1+1727741864 - 2025-08-11 #

Added #

  • ๐Ÿš€ pub.dev Package Support: Full restructure for pub.dev distribution
  • ๐Ÿ“ฆ Global Installation: Install globally with dart pub global activate flutterfy
  • ๐Ÿ”ง Programmatic API: Use Flutterfy functions directly in your Dart code
  • ๐Ÿ“š Comprehensive Examples: Added example/ directory with usage demonstrations
  • ๐Ÿท๏ธ Better Argument Parsing: Improved CLI with --build=NUMBER syntax
  • ๐ŸŽฏ Enhanced Documentation: Professional README with badges, examples, and guides
  • ๐Ÿงช Test Framework: Added test structure for better reliability
  • ๐ŸŒ Cross-Platform Support: Explicit support for all major platforms
  • ๐Ÿ“ Rich Metadata: Added topics, funding, and repository information

Improved #

  • ๐Ÿ›ก๏ธ Error Handling: More descriptive error messages with emojis
  • ๐Ÿ’ป CLI Interface: Cleaner help messages and better UX
  • ๐Ÿ” Version Detection: More robust regex patterns for version parsing
  • ๐Ÿ“– Code Documentation: Added comprehensive inline documentation
  • ๐ŸŽจ Output Formatting: Better visual feedback with success/error indicators

Changed #

  • ๐Ÿ—๏ธ Project Structure: Reorganized to follow pub.dev standards
    • Main logic moved to lib/src/version_updater.dart
    • CLI executable in bin/flutterfy.dart
    • Public API exported from lib/flutterfy.dart
  • ๐Ÿ“‹ Dependencies: Added useful packages (args, yaml, path, io)
  • ๐ŸŽฏ Targeting: Updated SDK constraints to >=3.0.0 <4.0.0

Fixed #

  • ๐Ÿ› Build Number Handling: Fixed edge cases with custom build numbers
  • ๐Ÿ”„ Version Transitions: Better handling of versions without build numbers
  • ๐Ÿ“„ File Encoding: Improved file reading with proper error handling

1.0.1+1727741864 - 2024-09-30 #

Fixed #

  • ๐Ÿ”ง YAML Parsing: Fix on yaml file parsing and version detection

Notes #

  • Improved stability when reading pubspec.yaml files
  • Better error messages for debugging

1.0.0 - 2024-09-30 #

Added #

  • ๐ŸŽ‰ Initial Release: First working version of Flutterfy
  • ๐Ÿ“ˆ Version Management: Support for major, minor, and patch version increments
  • ๐Ÿ”จ CLI Interface: Command-line functionality for version updates
  • ๐Ÿ›ก๏ธ Error Handling: Basic error handling for missing files and invalid versions
  • ๐Ÿ“ Build Numbers: Support for build number generation and custom values
  • ๐ŸŽฏ Semantic Versioning: Full compliance with semantic versioning standards

Features #

  • Update versions with simple commands: major, minor, patch
  • Automatic build number generation using timestamps
  • Custom build number support
  • Validation of pubspec.yaml format and structure
  • Cross-platform compatibility (Windows, macOS, Linux)

Notes #

  • Ensure that the pubspec.yaml file has the correct format (e.g., version: 1.0.0+1) for the functionality to work properly
  • Recommended to add +1 to the version if you receive the error "version not found in pubspec.yaml"
  • Initial version focused on core functionality and reliability

๐Ÿš€ Upcoming Features (Roadmap) #

1.2.0 (Planned) #

  • ๐ŸŽจ Interactive CLI with prompts and confirmations
  • ๐Ÿ“Š Version history tracking and rollback capabilities
  • ๐Ÿ”„ Git tag automation integration
  • ๐ŸŒ Web dashboard for team version management
  • ๐Ÿ“ฑ Flutter plugin for IDE integration

1.3.0 (Future) #

  • ๐Ÿค– AI-powered version suggestions based on commit messages
  • ๐Ÿ“ˆ Analytics and version usage insights
  • ๐Ÿ” Advanced validation rules and policies
  • ๐ŸŒ Multi-project workspace support
  • ๐ŸŽฏ Custom version patterns and formats

๐Ÿ“‹ Migration Guide #

From 1.0.x to 1.1.x #

No breaking changes! Simply update your installation method:

Old way:

dart run bin/flutterfy.dart patch

New way (recommended):

dart pub global activate flutterfy
flutterfy patch

Programmatic Usage (New in 1.1.0) #

import 'package:flutterfy/flutterfy.dart';

// Now you can use Flutterfy in your Dart code
updateVersion('patch', null);
updateVersion('minor', '42');

๐Ÿค Contributing #

We follow Conventional Commits for our changelog generation.

Commit Types #

  • feat: - New features
  • fix: - Bug fixes
  • docs: - Documentation changes
  • style: - Code style changes
  • refactor: - Code refactoring
  • test: - Adding tests
  • chore: - Maintenance tasks

Example #

git commit -m "feat: add interactive CLI prompts"
git commit -m "fix: resolve build number parsing issue"
git commit -m "docs: update installation instructions"
1
likes
140
points
1
downloads

Publisher

verified publisherneryad.dev

Weekly Downloads

A powerful command-line tool for Flutter and Dart projects to automatically manage semantic version updates in pubspec.yaml files. Supports patch, minor, and major version increments with intelligent build number handling.

Repository (GitHub)
View/report issues

Topics

#versioning #flutter #dart #automation #devtools

Documentation

Documentation
API reference

Funding

Consider supporting this project:

ko-fi.com

License

MIT (license)

Dependencies

path

More

Packages that depend on flutterfy