Skip to content

v1.0

Release Date: 2026
Target Framework: .NET 10

Brine2D 1.0 is the first stable release. The core engine is feature-complete, the API is locked, and CI runs on Windows, macOS, and Linux.


API Stability

From v1.0 onward:

  • No breaking changes without a major version bump (2.0)
  • Deprecations are announced one minor version before removal
  • Patch releases contain only bug fixes

Known Limitations

  • NativeAOT / IL-trimmed publishing: RegisterBrineComponents() uses reflection. For a fully trim-safe deployment, register each component type with a source-generated JsonTypeInfo<T>. A fully AOT-safe built-in registration path is on the post-1.0 roadmap.
  • macOS and Linux runtime: Both platforms build and test clean in CI. In-game runtime validation is community-sourced — reports welcome.