Changelog

VibeMQ project change history.

Planned Versions

Version 1.0.0 (In Development)

Date: Q2 2026

Status: Current Stable Version

New features:

  • Basic message broker functionality

  • Pub/Sub with queues

  • Delivery guarantees via acknowledgments (ACK)

  • Keep-alive (PING/PONG) and automatic reconnections

  • Support for delivery modes (round-robin, fan-out)

  • Token-based authentication

  • Graceful shutdown

  • Health checks for orchestrators

  • Performance metrics collection

  • Custom binary protocol for improved performance: - Fixed field order for unambiguous parsing - Payload stored as JSON in UTF-8 for easy debugging and UI display - Zero external dependencies - Protocol version support for backward compatibility

Components:

  • VibeMQ.Core — system core

  • VibeMQ.Server — broker server

  • VibeMQ.Client — client for connection

  • VibeMQ.Protocol — message exchange protocol

  • VibeMQ.Health — HTTP health check server

  • VibeMQ.Server.DependencyInjection — server DI integration

  • VibeMQ.Client.DependencyInjection — client DI integration

Documentation:

  • Full documentation on ReadTheDocs

  • Usage examples

  • Deployment guides

Backlog (Version 2.0+)

Planned features:

  • Persistence layer for message storage

  • Clustering for horizontal scaling

  • Support for other protocols (AMQP, MQTT, HTTP)

  • Advanced monitoring (Prometheus, Grafana)

  • Web management interface

  • .NET 10 support

  • Protocol-level compression

  • Granular authorization

  • Class-based subscriptions

  • Delayed messages

  • Transactional messages

Version Archive

Version 0.1.0 (Alpha)

Date: February 2026

Status: Alpha version for testing

Includes:

  • Basic project architecture

  • Communication protocol prototype

  • Simple queue implementation

  • Basic client and server

Known limitations:

  • No delivery guarantees

  • No persistent storage

  • Limited documentation

  • API may change

Version Format

VibeMQ uses SemVer 2.0 with version set from the repository tag in the Release pipeline (passed as MSBuild property Version):

Format: MAJOR.MINOR.PATCH

  • MAJOR — incompatible API changes (set via release tag)

  • MINOR — new functionality, backward compatible (set via release tag)

  • PATCH — bug fixes (set via release tag)

Versioning:

  • Releases: version is taken from the git tag (e.g. v1.0.0) and passed directly into the pipeline (-p:Version=...); no version file in the repo.

  • Local builds: default 1.0.0 (or pass -p:Version=1.2.3).

Examples:

  • 1.0.0 — release from tag v1.0.0

  • 1.1.0 — release from tag v1.1.0

  • 2.0.0 — breaking changes release from tag v2.0.0

Pre-release versions:

  • 1.0.0-alpha.1 — alpha version

  • 1.0.0-beta.1 — beta version

  • 1.0.0-rc.1 — release candidate

Versioning Policy

Version Support

  • Current version — full support

  • Previous MINOR — security patch support

  • Older versions — not supported

Release Schedule

  • MAJOR releases — as breaking changes accumulate

  • MINOR releases — quarterly

  • PATCH releases — as needed

Change Notifications

Breaking changes are announced:

  • In changelog

  • In release notes on GitHub

  • One month before new MAJOR version release

Contributing to the Project

How to Suggest an Improvement

  1. Create an issue on GitHub with feature description

  2. Discuss feasibility with maintainers

  3. If approved — create a pull request

How to Report a Bug

  1. Check existing issues

  2. Create a new issue with description: - VibeMQ version - Steps to reproduce - Expected behavior - Actual behavior - Logs and errors

How to Contribute to Documentation

  1. Find a documentation issue

  2. Create an issue or pull request

  3. Describe proposed changes