Changelog

Version history for the .brfr file format specification.

Version 0.10

January 2026

Clean slate revision focusing on simplicity and consistency.

Breaking Changes

• id field now required on manifest (UUID v4)
• Text presets reduced to five: small, body, heading, title, hero
• Image fit defaults to "contain" (was "cover")
• SVG fit options reduced to contain/cover (removed "fill")
• Annotation types consolidated: number and text merged into label
• Removed annoAspect (renderer derives from actual image)

Changes

• Hero text preset reduced from 72px to 60px
• Audio and video fields reserved for future use
• Semantic colors expanded: ok, warn, error, info, muted

Prior Versions

Versions prior to 0.10 underwent significant iteration during early development and are not documented here. The format was not considered stable enough for external use during this period.

Versioning Policy

During 0.x development, breaking changes may occur between any versions. No backwards compatibility is guaranteed.

Version 1.0 will be the first stable release. After 1.0:

• Patch versions (1.0.x) - Bug fixes, documentation only
• Minor versions (1.x.0) - Backwards-compatible additions
• Major versions (x.0.0) - Breaking changes (rare)