​

1.8.0

​

BREAKING CHANGES 🚨

​

NeoButton Default Hold Duration

• Changed default holdDuration from 3 seconds to 1 second for a snappier hold-to-confirm experience. If you rely on the previous default, explicitly set holdDuration: const Duration(seconds: 3).

​

New 🚀

​

NeoSidePanel

• New utility class for managing side panel visibility alongside your layouts. Supports show, hide, and toggle methods with customizable width and ID-based panel management.
• Works with both NeoSidebarLayout and NeoTopbarLayout.

​

NeoImagePicker

• New widget for selecting images via file picker or drag-and-drop. Features automatic format validation, file size limits, loading states, error handling, and a clear button with hover-to-swap interaction.

​

NeoModal Extra Large Size

• Added extraLarge option to NeoModalSize enum (1536px max width) for displaying larger modal dialogs.

​

Improvements 💪

​

NeoModal Size Adjustments

• Increased medium modal width from 500px to 640px and large from 600px to 896px for better content display.

​

NeoButton Nudge Animation

• Hold-to-confirm buttons now show a nudge animation when quickly tapped, visually indicating that the button requires holding.

​

Loading Indicator Update

• NeoButton and NeoToast now use the circleNotch loading icon for a cleaner look.

​

NeoCard Clipping

• Card now properly clips child content to prevent overflow beyond the border radius.

​

Fixes 🐞

• Fixed an issue where phantom touch events on iOS could immediately dismiss NeoModal upon mounting.

​

1.7.0

​

BREAKING CHANGES 🚨

​

Field Widget API Changes

• Input field submitOnBlur removal: Removed submitOnBlur property from NeoTextField, NeoTextArea, NeoDateField, and NeoTimeField. Use the new onBlur callback instead.
• NeoDateField: Changed onSubmitted callback signature from ValueChanged<String> to ValueChanged<String?>. The callback now receives null when the field is cleared or contains invalid input.
• NeoTimeField: Changed onSubmitted callback signature from ValueChanged<TimeOfDay> to ValueChanged<TimeOfDay?>. The callback now receives null when the field is cleared or contains invalid input.
• Duration tokens renamed to semantic values: The NeoDurationTokens class now uses semantic values (short, medium, long) instead of specific use-case tokens (pressed, hover, sidebar, toggleSwitch, dropdown). Update any code that references the old duration token properties to use the appropriate semantic value.
• Minimum Dart SDK version increased: Now requires Dart SDK >=3.10.0 (previously >=3.3.3)
• Minimum Flutter version increased: Now requires Flutter >=3.38.0 (previously >=3.0.0)

​

New 🚀

​

NeoTopbarLayout

• New layout widget for creating applications with top navigation bars. The layout includes a top bar area and a main content area with automatic safe area handling.

​

NeoButton Hold-to-Confirm

• Added requireHold property for hold-to-confirm functionality. When enabled, users must hold the button for a specified duration before the action is triggered.
• Added holdDuration property to customize the hold duration (defaults to 3 seconds).
• Note: requireHold is only supported for NeoButtonVariant.outlined buttons.
• Added fgHoverColor and fgPressedColor properties for customizing foreground colors in hover and pressed states.
• Added buttonFgHover and buttonFgPressed color tokens to NeoColorTokens for theme customization.

​

Input Field Enhancements

• Added showClearButton property to NeoTextField, NeoDateField, and NeoTimeField for easier input clearing
• Added onBlur callback to NeoTextField, NeoTextArea, NeoDateField, and NeoTimeField for explicit blur event handling
• Added optional focusNode property to NeoDateField and NeoTimeField for external focus management

​

Improvements 💪

​

Input Field Enhancements

• Improved focus handling in all input fields to prevent duplicate unfocus events when focus changes occur within submission callbacks.
• NeoDateField and NeoTimeField now properly handle Enter key presses to submit and unfocus when the field is complete or empty.
• Added animated helper text transitions to NeoTextField, NeoDateField, NeoTimeField, NeoTextArea, and NeoDropdownField for smoother error and description text display.

​

Dart Dot Shorthands Support

• With the Dart SDK upgrade to 3.10.0+, you can now use the new dot shorthand syntax in your code for more concise syntax.

​

Riverpod Updates

• Updated riverpod_annotation to version 4.0.0 for improved performance and new features.

​

Fixes 🐞

• Fixed duplicate submission bug where pressing Enter would trigger both Enter submission and blur submission. Fields now track submission source to prevent duplicate calls to onSubmitted.

​

1.6.0

​

BREAKING CHANGES 🚨

​

NeoDropdownField API Changes

• The widget is now generic and uses selected instead of selectedId
• Migration:
  • Change selectedId: String? to selected: String? (for single-select) or selected: Set<String> (for multi-select)
  • Change onChanged: ValueChanged<String?> to onChanged: ValueChanged<String?> (single-select) or ValueChanged<Set<String>> (multi-select)

​

NeoSidebarStates API Changes

• The property activeItem and method setActiveItem(String item) have been removed from NeoSidebarStates and NeoCurrentSidebarStates notifier
• Rationale: This property was not needed as you can determine the current path locally in your application code. Use the current path to decide which NeoSidebarButton should be active, rather than storing it in the sidebar state. Additionally, tracking the active path did not fit within the scope of sidebar states, which should focus on UI state (collapsed, hidden, etc.) rather than application routing state
• Migration: Remove all references to activeItem and any calls to setActiveItem(). Instead, determine the active button based on your current route path locally

​

New 🚀

​

NeoDropdownField Multi-Select Support

• Added multi-select support to NeoDropdownField. When using Set<String> as the generic type, users can select multiple items
• Selected items are displayed as comma-separated labels

​

Improvements 💪

​

Field Submission Behavior

• Added submitOnBlur property to NeoTextField, NeoTextArea, NeoDateField, and NeoTimeField. When enabled (defaults to true), these fields will automatically call onSubmitted when the field loses focus, providing better form submission behavior

​

NeoModal Size Options

• Added size parameter to NeoModal.show() method. The modal now supports three size options (NeoModalSize.small, NeoModalSize.medium, NeoModalSize.large) with corresponding max widths (400px, 500px, 600px respectively). Defaults to NeoModalSize.small for backward compatibility

​

NeoSidebarStates Performance

• Improved sidebar state management performance. NeoSidebarStates provider now only initializes when actually using NeoSidebarLayout, preventing unnecessary provider initialization in apps that don’t use the sidebar layout

​

Fixes 🐞

• Fixed validation assert: maintainFocusOnSubmit and submitOnBlur cannot both be true in NeoTextField and NeoTextArea. An assert now prevents this invalid configuration
• Fixed maintainFocusOnSubmit not working properly in NeoTextField. The field now correctly maintains focus when Enter is pressed and maintainFocusOnSubmit is true
• Fixed duplicate submission bug where pressing Enter would trigger both Enter submission and blur submission. Fields now track submission source to prevent duplicate calls to onSubmitted

​

1.5.0

​

New 🚀

​

NeoTimeField

• Time input widget with segmented HH:MM format and advanced interaction features:
  • Smart segmented input: HH:MM format with intelligent auto-advance between segments
  • Keyboard navigation: Arrow keys for navigation between segments and value increment/decrement
  • Input validation: Real-time value capping for valid time ranges (00:00-23:59)

​

1.4.1

​

Improvements 💪

• Fixed NeoTextArea manual resize behavior by correcting height calculation

​

Fixes 🐞

• Fixed a bug where NeoTextField and NeoDropdownField were throwing errors when used inside of a NeoModal

​

1.4.0

​

BREAKING CHANGES 🚨

• Changed from DateTime? properties to string-based API for enhanced flexibility
• dateString property replaces previous date properties
• onSubmitted(String) callback replaces previous onSubmitted(DateTime?) callback
• This enables custom validation flows, internationalized error messages, and auto-correction features

​

New 🚀

​

NeoTextArea

• Multi-line text input widget with advanced features:
  • Auto-resizing: Configurable min/max lines with automatic height adjustment
  • Manual resizing: Optional drag handle for user-controlled sizing
  • Keyboard shortcuts: Smart text submission (Enter vs Cmd/Ctrl+Enter based on submitOnEnter setting)
  • Comprehensive properties: Label, placeholder, description, error text, validation, and focus management

​

NeoCard

• Clean card component with configurable padding (defaults to theme.spacings.large)
• Perfect for grouping content with consistent styling and subtle shadows

​

NeoDateValidator

• Comprehensive date validation utility with 7 validation methods:
  • validate(String) - Parses and validates DD-MM-YYYY format with detailed error messages
  • validateIsBefore(DateTime, DateTime) - Validates date is before another date
  • validateIsAfter(DateTime, DateTime) - Validates date is after another date
  • validateIsInRange(DateTime, DateTime, DateTime) - Validates date is within range (inclusive)
  • validateIsNotFuture(DateTime) - Validates date is today or earlier
  • validateIsNotPast(DateTime) - Validates date is today or later
  • format(DateTime) - Formats DateTime objects to DD-MM-YYYY string

​

Other New Features

• NeoApp: Added optional wrapper parameter for custom root-level widget wrapping

​

Improvements 💪

​

NeoDateField - Complete Rewrite

• Smart segmented input: DD-MM-YYYY format with intelligent auto-advance between segments
• Keyboard navigation: Arrow keys for navigation between segments and value increment/decrement
• Focus management: Proper tab order integration with automatic segment selection
• Input validation: Real-time value capping and context-aware month day limits
• Enhanced UX: Tap-to-select segments, automatic padding, and seamless interaction flow
• Flexible error handling: Allows invalid dates in field state, moving validation to end-user side for custom UX flows

​

NeoTextField Improvements

• Enhanced platform consistency: Replaced EditableText with CupertinoTextField for better native behavior
• Improved error handling: Fixed error text display to only show when error text is not empty, preventing layout jumps

​

NeoModal Enhancement

• Enhanced backdrop: Added gradient effect for smoother visual transition

​

Fixes 🐞

• NeoTextField: Fixed error text layout jumps from empty error messages

​

1.3.0

​

BREAKING CHANGES 🚨

​

New 🚀

• NeoDateField: finalized segmented DD-MM-YYYY input
  • Keyboard navigation and smart selection handling
  • Normalizes input and supports disabled state
  • New onSubmitted(DateTime? value) callback
• Added autofocusSearchOnOpen property to NeoDropdownField. When true, the search field will be focused when the dropdown is opened
• Added isEnabled property to NeoTextField, NeoDropdownField and NeoToggleSwitch for consistent disabled-state visuals and behavior

​

Improvements 💪

• Error state now shows a danger-colored border when errorText is set across NeoTextField, NeoDropdownField, and NeoDateField
• Refined shadows.small token for subtler depth

​

Fixes 🐞

• Deselect text when unfocusing in NeoTextField

​

1.2.0

​

BREAKING CHANGES 🚨

• NeoButton: Removed NeoButtonSize.expanded from the size property enum—use the new isExpanded boolean property instead
• NeoTabBar: activeTabId and onChange properties are now required (changed from nullable)
• Field widgets height change: NeoTextField, NeoDropdownField, and NeoDateField changed from flexible height to fixed height (44.0) - may affect layouts relying on flexible field height

​

New 🚀

​

NeoModal

• A new overlay widget for creating modals, dialogs, confirmations, and custom popups
• Features builder-based API with contentBuilder and actionsBuilder for flexible layouts

​

Theming System Additions

• Added NeoShadowTokens with small and medium shadow definitions
• Added semantic color tokens: success/onSuccess, warning/onWarning, danger/dangerHover/dangerPressed/onDanger
• Added button-specific tokens: buttonBg, buttonBgHover, buttonBgPressed, buttonFg
• Added contrast tokens: fgOnContrast and bgContrast
• Added green color to NeoPalette with fgSuccess and fgOnSuccess tokens

​

NeoButton Additions

• Added new states: isLoading, isDanger, isEnabled properties for loading, danger, and disabled states
• Added a new variant: NeoButtonVariant.link, for underlined link-style buttons
• Added isExpanded property for expanded buttons (replaces NeoButtonSize.expanded)
• Added isCaretRotated property for animated dropdown-style carets
• Added enhanced color customization: bgColor, bgHoverColor, bgPressedColor, and fgColor properties

​

NeoToast Additions

• Added NeoToastType enum with preset configurations (info, loading, success, warning, danger)
• Added NeoToast.update() method for dynamically updating existing toasts
• Added toast descriptions with optional description parameter
• Added sophisticated toast stacking system with dynamic height calculation

​

Other Widget Additions

• Added label property to NeoDivider for labeled dividers
• Added errorText and allowDeselect properties to NeoDropdownField
• Added fixedRowHeight property to NeoTable for consistent row heights
• Added optional focusNode property to NeoTextField for better focus management
• Added smart log filtering to NeoLogger with automatic build mode detection
  • Debug builds show all log levels (trace, debug, info, warning, error, fatal) for comprehensive debugging
  • Release builds only show info level and above to reduce noise and improve performance
  • This means you can safely leave trace and debug calls throughout your codebase during development - they won’t clutter the user experience in production builds

​

Improvements 💪

​

NeoButton Improvements

• Better interaction feedback with refined animations and shadows
• More sophisticated color calculations for different variants and states

​

NeoToast Improvements

• Complete visual redesign with modern card-based styling and enhanced shadows
• Intelligent preset system with automatic icon/color configuration and auto-dismiss behavior
• Advanced animation system with staggered entrance, elastic positioning, and smooth dismissal

​

Theming & Widget Improvements

• Restructured color palette with semantic naming (e.g., green500, red500, red600)
• NeoDropdownField: Improved search bar implementation
• Standardized logging format across all Neo widgets with consistent [Neo] [WidgetName] prefixes for easier debugging and filtering

​

Fixes 🐞

• Fixed toast positioning, stacking, memory leaks, and race conditions
• Fixed isDismissable bug in dropdown widgets
• Updated deprecated withOpacity() calls to use withValues(alpha:) for Flutter compatibility

​

1.1.0

​

New 🚀

• Added NeoTabBar. It’s a bar… of tabs! Useful for content switching.
• Added NeoTab. This is used within NeoTabBar to pass data like text and icon.

​

Improvements 💪

• Added the enabled property to NeoCheckbox. If it is false, it is not clickable and has a visual disabled state
• Added onRowHover property to NeoTable. This is a callback that can be used, for example, to show action buttons only on hover over a single row, giving your overall screen a cleaner look
• Removed the scaling animation from both NeoButton and NeoSidebarButton
• Removed the border from the filled variant of the NeoButton; this gives it a cleaner look

​

1.0.1

​

Improvements 💪

• Added defaultLightTheme and defaultDarkTheme properties to NeoApp. This will now allow you to set default themes at startup. When not provided, NeoApp will use the default NeoThemeLight and NeoThemeDark

​

Fixes 🐞

• We forgot to add the new NeoSidebarLayout to neo.dart, so you had to import this separately to use it. This is fixed!

​

1.0.0

​

New 🚀

• Added the NeoTable widget. We finally got tables now! 🎉 More features to come in the future.
  • Also added NeoTableColumn and NeoTableRow. You’ll use these widgets to populate the table
• Added the NeoSidebarLayout assembly (we’re still deciding on the naming of these big “widgets”). It manages the layout of a NeoSidebar and main content, providing the ability to collapse or completely hide the sidebar. Hiding the sidebar will now also completely hide the padding around the main area, giving a more fullscreen feel. This change animates so everything feels fluent! The NeoSidebarLayout also supports mobile platforms, and there the sidebar pushes the main content to the side instead of scaling it

​

Improvements 💪

• Made the NeoBadge stable. It now always scales correctly to its contents; this was a bit wonky before, but not anymore!
• Improve the look of the NeoBadge; it’s now a lot more visible in different theming scenarios.
• Made the NeoSidebarButton work with the improved NeoBadge, it now correctly animated into an indicator when collapsing the sidebar
• Added isIndeterminate property to NeoCheckbox which will show a dash inside of the checkbox for indeterminate states like a select/deselect all box in a table when some but not all rows are selected

​

0.4.1

​

New 🚀

• Added haptic feedback support for MacOS trackpads
• Added new NeoHaptics.error() haptic

​

Improvements 💪

• Added optional MacOS support toggle for haptic feedback methods (disabled by default since trackpads already provide native feedback for clicks - enable with enableMacOS: true when additional feedback is desired, e.g., during drag operations)
• Updated documentation to align with all the recent changes and the Neo CLI

​

0.4.0

​

New 🚀

• Added Toasts! (NeoToastProvider & NeoToast)
• Added NeoCodeBlock
• Added NeoDateField (Keep in mind that this is an alpha-release and it is very much not ready for production use)
• Added NeoRotation

​

Improvements 💪

• Added search functionality to NeoDropdownField (Including an empty state)
• Added sticky header functionality to NeoDropdown
• Added icon and suffix support to NeoTextField
• Improved animation curves of NeoToggleSwitch
• Added keyboardType, inputFormatters, errorText, autofillHints, onSubmitted and maintainFocusOnSubmit properties to NeoTextField
• We’ve completely overhauled the way overlays work
• Improved the docs

​

0.3.0

​

New 🚀

• NeoSidebarButton A button widget specifically designed for the use in sidebars
• NeoHaptics A system that provides haptic feedback on iOS (Also works with Apple Pencil!)
• NeoSidebar
• NeoSafeArea A widget that ensures content is not obstructed by system UI
• NeoToggleSwitch
• NeoCheckbox
• NeoLogger A system that provides a better debugging experience
• NeoBadge A widget designed to display status information or tags, for instance
• NeoDivider A widget that can be used to separate content
• NeoTooltip A widget that can be used to display information on hover over a trigger
• NeoTextField A widget that can be used to input text
• NeoDropdownSectionPrimitive
• NeoFieldPrimitive
• NeoListItemPrimitive
• NeoDropdown
• NeoDropdownMenuSection A section of a dropdown menu
• NeoDropdownMenuItem A single item in a dropdown menu (Used in NeoDropdownMenuSection)
• NeoDropdownFieldSection A section of a dropdown field
• NeoDropdownFieldItem A single item in a dropdown field (Used in NeoDropdownFieldSection)

​

Improvements 💪

• Improved the theming system
• Improved NeoButton

​

0.2.0

​

New 🚀

• Added primary, filled, outline and ghost variants for the NeoButton
• Replaced the font Geist with Inter. This is now the default font for Neo
• Added more (and renamed some) colors, textstyles, radii, spacings and durations

​

Improvements 💪

• Made the default text blue and strikethrough so it’s obvious where a textstyle should be added

​

0.1.0

​

New 🚀

• Added NeoInitializer widget. A utility widget designed to streamline the initialization process of the Neo framework. This widget manages crucial startup tasks, ensuring that the environment is properly set up before any UI components are loaded
• Added Geist and Geist Mono fonts. These are now the default fonts for Neo

​

0.0.1

​

New 🚀

• NeoApp widget. This will act as the root of the app and manage everything
• NeoButton widget
• Initial release of the Neo theming system, including:
  • Basic light and dark theme support
  • Dynamic theme switching based on system settings and user preferences
  • Basic color, radii and spacing settings in NeoTheme class