Release Notes

How to Read Helix Releases

Helix release notes are intended to describe the framework as a coordinated platform.

That means each release should answer a few practical questions:

• what changed across Helix overall
• whether there are any breaking changes
• what adopters need to do during upgrade
• which ecosystem areas changed
• whether compatibility expectations shifted

For the canonical tagged release record, see the GitHub releases for the project.

Latest Release

Helix 0.3.0

Released: March 16, 2026

Summary

Helix 0.3.0 expands the framework from the initial public release into a more complete evaluation and adoption platform, with broader documentation, a stronger examples catalog, release workflow improvements, and new reusable library capabilities.

Highlights

• Added a richer public examples catalog across CLI, library, and REST API application shapes
• Added the new helix-mapper library for small, composable model mapping
• Expanded the website and documentation surface with more ecosystem coverage, navigation, and release process documentation
• Improved release preparation so template settings plugin versions are updated as part of the release flow
• Added additional runtime capabilities such as credit-card masking support in helix-logstash

Breaking Changes

None in this release.

Upgrade Notes

• If you consume Helix templates, update the pinned com.helixframework.settings version in template settings.gradle files to 0.3.0.
• Keep Helix plugins, templates, and libraries aligned on the same release line when upgrading.
• No Java, Gradle, or Spring Boot baseline change is called out for this release.

Changes By Area

CLI

• Expanded CLI-oriented example coverage with a standalone basic-cli example and related workspace setup flow coverage.

Templates

• Updated Helix template settings.gradle files to align with the 0.3.0 settings plugin release.

Plugins

• Improved release preparation so template settings plugin versions are updated as part of releasePrepare.
• Expanded internal developer and release documentation around repository architecture, developer workflows, and release operations.

Starters and Libraries

• Added helix-mapper for composable, context-aware model mapping.
• Added credit-card masking support in helix-logstash.
• Improved selected feature-flag, actuator, concurrency, and metadata coverage across existing modules.

Documentation and Website

• Expanded the documentation site with broader library, plugin, starter, examples, guides, and compatibility coverage.
• Added more contributor-oriented documentation for architecture, developer setup, release flow, and release note structure.

Compatibility

• Java: JDK 17+
• Spring Boot: 3.3.1 baseline remains in the Helix BOM
• Gradle: 8.10 wrapper in the repository
• Alignment guidance: upgrade Helix plugins, templates, and libraries together on 0.3.0

Earlier History

Helix 0.2.0

Released: March 9, 2026

Summary

Initial public release of Helix as an opinionated platform framework for Spring Boot teams, including templates, CLI workflows, Gradle plugins, reusable libraries, and documentation.

Highlights

• Established the first public Helix release line
• Published the initial framework ecosystem for project generation, build conventions, and reusable runtime modules
• Published the website and docs experience for evaluation and adoption

Breaking Changes

None in this release.

Upgrade Notes

This is the initial release, so there is no prior Helix release line to upgrade from.

Release Format

Helix release notes are organized around these sections:

1. Summary
2. Highlights
3. Breaking Changes
4. Upgrade Notes
5. Changes by Area
6. Compatibility

The goal is to make each release useful both for active adopters and for teams evaluating whether Helix is a stable platform fit.

The historical changelog is kept in the repository:

• CHANGELOG.md

Future Helix releases should expand this page with version-by-version summaries and upgrade guidance.