Releases

Primitive UI releases and their changelogs.

November 24, 2025 (v0.0.6)

Version 0.0.6 Latest

✨

Interactive Primitives: Button & Input

Introduced PrimitiveButton and PrimitiveInput, establishing the foundation for interactive forms and actions with a focus on composability and lower-level control.

PrimitiveButton / PrimitiveInput / EditableText

New Component: PrimitiveButton provides a robust, customizable foundation for actions.
- Multiple variants (primary, secondary, destructive, outline, ghost, link).
- Built-in handling for loading states and disabled states.
New Component: PrimitiveInput introduces a composable text input.
- Built directly on EditableText to avoid Material bloat.
- Supports visual variants (outline, filled, flushed) and decoration slots.

November 24, 2025 (v0.0.5)

Version 0.0.5

Layout Intelligence & Implicit Animations

Introduced standard alignment APIs and smooth implicit animations for enhanced layout control and visual polish.

CrossAxisAlignment / Animated Styles / TweenAnimationBuilder

Layout Intelligence: VStack and HStack now support standard Flutter CrossAxisAlignment (start, center, end, stretch), replacing custom enums.
Implicit Animations: PrimitiveCard now smoothly animates changes to color, elevation, and shadow.
Implicit Animations: PrimitiveSlider now animates programmatic value changes while keeping drag interactions immediate.
API Standardization: Standardized alignment properties across layout components.

November 24, 2025 (v0.0.4)

Version 0.0.4

Accessibility & WAI-ARIA Support

Major accessibility upgrade adding proper Semantic Semantics, ARIA roles, labels, and keyboard support to all interactive components.

Semantics / Keyboard Support / Screen Reader Labels

PrimitiveCard: Added semantic button/container roles and semanticsLabel parameter.
PrimitiveToggleSwitch: Added semantic switch role, toggled state, and semanticsLabel.
PrimitiveSlider: Added semantic slider role, increment/decrement actions for keyboard support, and semanticsLabel.
PrimitiveCircularProgress: Added semantic progress indicator role and semanticsLabel.

November 23, 2025 (v0.0.3)

Version 0.0.3

Feature Enhancements & Layout Updates

Significant updates across several components, introducing flexible layouts, absolute positioning, improved interaction, and new progress indicator capabilities.

CustomFlexible / CustomPositioned / DeterminateProgress

PrimitiveCard: Added shadowColor and onTap (with visual feedback) support.
HStack: Introduced HCustomFlexible and HCustomExpanded for proportional sizing (flex layout).
VStack: Further enhanced with VCustomFlexible and VCustomExpanded for robust flex layout.
ZStack: Added CustomPositioned support for absolute positioning within the stack.
PrimitiveSlider: Enhanced with onChangeStart, onChangeEnd callbacks, and thumbColor customization.
PrimitiveCircularProgress: Now supports determinate progress (pass a value between 0.0 and 1.0) alongside indeterminate mode.

November 23, 2025 (v0.0.2)

Version 0.0.2

Horizontal Layouts & Interactive Widgets

Introduced horizontal stacking with alignment control and new interactive components for value selection and loading states.

HStack / PrimitiveSlider / PrimitiveCircularProgress

Added HStack layout: A horizontal stack layout with alignment options
Added MainAxisAlignment support to VStack and HStack for distributing free space (start, center, end, spaceBetween, spaceAround, spaceEvenly)
Improved layout logic for stacks to correctly handle single children with alignment
Added PrimitiveSlider component: A slider built with CustomPaint and GestureDetector
Added PrimitiveCircularProgress component: An indeterminate progress indicator built with CustomPaint and AnimationController

November 15, 2025

Version 0.0.1

Initial release of Primitive UI.

Core Primitives & Foundation

The initial release establishing the low-level rendering architecture and core layout components.

CustomPaint / RenderBox / VStack / ZStack

Added PrimitiveCard component: A container with shadow, rounded corners, and padding
Added PrimitiveToggleSwitch component: An animated toggle switch
Added VStack layout: A vertical stack layout with alignment options
Added ZStack layout: A layered stack layout with alignment options
Implemented using only low-level primitives: CustomPaint, Canvas, GestureDetector, and custom RenderBox