DEV Community

Cover image for 🌊 FlowMaster CLI: A Modern GitFlow Tool for Seamless Version Management
Marvin Ndg
Marvin Ndg

Posted on

🌊 FlowMaster CLI: A Modern GitFlow Tool for Seamless Version Management

Photo by Irvan Smith on Unsplash

🌊 FlowMaster CLI: Streamlining GitFlow Workflows

Managing Git workflows in teams can be challenging, especially when following the GitFlow branching model. That's where FlowMaster CLI comes in - a powerful, interactive command-line tool designed to make GitFlow workflows more intuitive and efficient.

✨ Key Features

  • 🎯 Interactive menu-driven interface
  • 🌿 Streamlined feature branch management
  • 🚀 Smart release management with pre-release support
  • 🔧 Simplified hotfix handling
  • 📝 Conventional commit creation
  • 📊 Repository status monitoring
  • 📘 Built-in workflow documentation
  • 🔄 Automated changelog generation

🎯 Version Management Made Simple

FlowMaster CLI follows a clear versioning strategy:

  • Production releases: X.Y.Z (e.g., 1.0.0)
  • Pre-releases: X.Y.Z-stage.N where stage can be:
    • alpha.N: For internal testing
    • beta.N: For external testing
    • rc.N: For release candidates

🚀 Getting Started

  1. Install FlowMaster:
npm install -g flowmaster-cli
Enter fullscreen mode Exit fullscreen mode
  1. Start the interactive menu:
flowmaster
Enter fullscreen mode Exit fullscreen mode

💡 Why FlowMaster CLI?

1. Interactive Interface

No more remembering complex Git commands. FlowMaster provides an intuitive menu system that guides you through each workflow step.

2. Smart Version Management

The tool automatically suggests appropriate version numbers based on your current stage and helps manage pre-releases seamlessly.

3. Automated Changelog

Every significant commit automatically updates your CHANGELOG.md file, keeping your documentation in sync with your code.

4. Conventional Commits

Built-in support for conventional commits helps maintain clean, meaningful commit messages across your team.

🎨 Features in Action

Feature Management

# Start a new feature
flowmaster
# Select [1] Start Feature
# Enter feature name: awesome-feature

# Finish feature
flowmaster
# Select [2] Finish Feature
Enter fullscreen mode Exit fullscreen mode

Release Management

# Start a release
flowmaster
# Select [3] Start Release
# Choose version: 1.0.0-beta.1

# Finish release
flowmaster
# Select [4] Finish Release
Enter fullscreen mode Exit fullscreen mode

Hotfix Handling

# Start a hotfix
flowmaster
# Select [5] Start Hotfix
# Enter version: 1.0.1

# Finish hotfix
flowmaster
# Select [6] Finish Hotfix
Enter fullscreen mode Exit fullscreen mode

🔧 Advanced Features

Conventional Commits

FlowMaster guides you through creating structured commit messages:

  • feat: New features
  • fix: Bug fixes
  • docs: Documentation changes
  • style: Code style updates
  • refactor: Code refactoring
  • perf: Performance improvements
  • test: Test updates
  • build: Build system changes
  • ci: CI configuration updates
  • chore: Maintenance tasks

Automated Changelog

The tool automatically categorizes your changes in the CHANGELOG.md:

  • 🆕 Added (new features)
  • 🔄 Changed (updates to existing functionality)
  • 🐛 Fixed (bug fixes)
  • 🗑️ Removed (removed features)

🤝 Contributing

FlowMaster CLI is open-source and welcomes contributions! Check out our contribution guidelines to get started.

💖 Support the Project

If you find FlowMaster CLI valuable, consider:

  • ⭐ Starring the repository
  • 🐛 Reporting issues
  • 🤝 Contributing code
  • 💰 Becoming a sponsor

🔗 Useful Links

🌟 Conclusion

FlowMaster CLI transforms GitFlow from a complex workflow into an intuitive, guided process. Whether you're a solo developer or part of a large team, FlowMaster helps maintain clean version control and consistent releases.

Give it a try and let me know what you think in the comments below! 👇


Top comments (0)