Skip to content

What's New in Brine2D

Release history and version information for Brine2D.

Latest Release

v1.1.1 — 2026

Bug-fix release: the default camera now correctly matches the letterbox design resolution instead of the live window size.

Release notes

Release History

Version Release Date Highlights
v1.1.1 2026 Fix: default camera respects letterbox design resolution
v1.1 2026 Physics on by default, lazy sprite loading, letterbox effect
v1.0 2026 Entity persistence, AOT serialization, Brine2D.Build, cross-platform CI

Version Support

Version Status .NET
v1.1 ✅ Latest (stable) .NET 10
v1.0 ⚠️ Maintenance .NET 10

Breaking Changes Log

v1.1

Two narrowly-scoped exceptions to the "no breaking changes without a major bump" policy — see Release Philosophy below for why, and the v1.1 release notes for migration details.

  • UI anchors: UIAnchorResolver is now size-aware for Center/Right/Bottom anchors — remove any manual compensating AnchorOffset
  • Behavior: Behavior.Entity is now non-nullable and throws InvalidOperationException instead of returning null after detachment

v1.0

No breaking changes. v1.0 is the first stable release.

Release Philosophy

Brine2D follows Semantic Versioning:

  • Major (1.0, 2.0) — Breaking changes
  • Minor (1.1, 1.2) — New features, no breaking changes (with rare, narrowly-scoped exceptions — see below)
  • Patch (1.1.1, 1.1.2) — Bug fixes only, no breaking changes

Stable Phase (Current — v1.0+)

  • No breaking changes without a major version bump, except for small, mechanical fixes to genuine bugs discovered during real project use (e.g. v1.1's UIAnchorResolver/Behavior.Entity fixes) — these are called out explicitly in the Breaking Changes Log above with a migration note, rather than held until a major release
  • Deprecations announced one minor version before removal
  • Long-term support for each major version
  • Predictable release schedule
  • Production-ready stability

Get Notified