Verman 🦸‍♂️

Your friendly neighborhood version manager for Flutter projects.

Stop juggling versions between pubspec.yaml, build.gradle, and Info.plist. Verman automates versioning, ensuring consistency across your entire Flutter project with simple, intuitive commands.

---

The Problem

Managing your app's version can be a repetitive and error-prone task. You update pubspec.yaml...

# pubspec.yaml
version: 1.2.4+6

...then you have to remember to update build.gradle...

// android/app/build.gradle
android {
    defaultConfig {
        versionCode 6
        versionName "1.2.4"
    }
}

...and also Info.plist.

<!-- ios/Runner/Info.plist -->
<key>CFBundleShortVersionString</key>
<string>1.2.4</string>
<key>CFBundleVersion</key>
<string>6</string>

Forgetting a step leads to inconsistencies. Verman solves this.

Features ✨

• View Current Version: Instantly see your project's version.
• Increment with Ease: Bump your major, minor, or patch version. The build number is automatically incremented.
• Check Consistency: Verify that your Android and iOS versions match your pubspec.yaml.
• Sync Instantly: Push the version from pubspec.yaml to your platform-specific files.
• Smart Detection: Intelligently handles both hardcoded versions and modern Flutter projects that use variables like flutter.versionCode and $(FLUTTER_BUILD_NAME).

Installation

Activate verman globally from your terminal.

# From pub.flutter-io.cn (once published)
dart pub global activate verman

# Or, activate from your local source code
dart pub global activate --source path .

Usage

Run verman commands from the root of your Flutter project.

verman current

Displays the current version from pubspec.yaml.

$ verman current
Current version: 1.2.3+4

verman increment <part>

Increments the version. part can be major, minor, or patch. The build number is always incremented.

$ verman increment patch
Success: Updated version to 1.2.4+5

verman check-platforms

Checks for version consistency across pubspec.yaml, Android, and iOS.

$ verman check-platforms
Checking platform files against pubspec version: 1.2.3+4...
Android (android/app/build.gradle) version: 1.2.0 (3) - ❌ Out of Sync
iOS (ios/Runner/Info.plist) - ✅ In Sync (using Flutter variables)

verman sync

Updates build.gradle and Info.plist to match the version in pubspec.yaml.

$ verman sync
Syncing version 1.2.3+4 to platforms...
Android (android/app/build.gradle) - ✅ Synced.
iOS (ios/Runner/Info.plist) - ✅ Already configured to use Flutter variables.

Contributors ✨

A big thank you to all the contributors who have helped make this project better!

• artkinx - Idea, initial work, and feature development.

License

This project is licensed under the MIT License. See the LICENSE file for details.