flutter_smart_forms 1.0.2

A powerful reactive JSON-driven form builder for Flutter with validation, async validation, conditional fields, dynamic UI, file upload, image upload, nested arrays, and extensible architecture.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

---

1.0.2

Added

• New SmartFormStepper widget for multi-step forms with dynamic section titles and navigation.
• Support for displaying step titles alongside numbers with proper ellipsis handling for long titles.
• Added JSON configuration support for stepper colors, text colors, spacing, and border radius.
• Support for onTap navigation between steps in SmartFormStepper.
• Enhanced JsonFormBuilder helper to convert JSON sections directly into FormSectionModel.
• Added maxWidth constraints for step titles to improve UI on small screens.
• Stepper now fully respects disabled state via FieldExtra.
• Added submit and next/back button customization through extra properties.

Fixed

• Fixed issue where stepper only displayed numbers (1, 2, 3…) and ignored section titles.
• Fixed overflow issues in stepper header when titles are too long.
• Fixed color inconsistencies for active, inactive, and completed steps.
• Fixed reactivity issues when switching steps dynamically.

Changed

• Updated SmartFormStepper to use ConstrainedBox for step titles to prevent layout break.
• Improved FieldExtra usage for default colors and padding in stepper and navigation buttons.
• Refined UI layout and spacing for stepper header, field sections, and navigation buttons.
• Minor performance improvements in stepper rendering.

---

1.0.1

Added

• Reactive architecture improvements using ValueListenableBuilder across field widgets.

• Improved FieldExtra helper usage for safer access to extra configuration values.

• Enhanced controller synchronization for dynamic fields like SmartArrayField.

• New configuration options for multiple fields including spacing, padding, and styling through JSON.

• Improved internal utilities including:

  • ColorParser
  • ConditionEvaluator
  • ImageHelper
  • IconMapper

Fixed

• Fixed setState() or markNeedsBuild() called during build issue in SmartArrayField by deferring controller updates using WidgetsBinding.instance.addPostFrameCallback.
• Fixed reactivity issues where some fields were not rebuilding when form values changed.
• Fixed margin/padding inconsistencies when parsing layout properties from JSON.
• Fixed conditional visibility edge cases for nested fields.

Changed

• Updated several fields to use the latest reactive architecture:

  • SmartCheckboxField
  • SmartSignatureField
  • SmartArrayField
  • SmartOtpField

• Improved handling of disabled and readOnly states across all field types.

• Updated field rendering to consistently respect ConditionEvaluator for visibility and enable rules.

• Improved UI consistency and theming support for dynamic fields.

---

1.0.0

Added

• Initial release of flutter_smart_forms.

• Fully reactive, JSON-driven form builder for Flutter.

• Support for conditional visibility (showIf, hideIf) and enable/disable rules (enableIf).

• Built-in validation and async validation support.

• Reactive updates for form fields when JSON or FieldModel changes.

• Nested array fields and complex field hierarchies.

• Common field types:

  • SmartTextField
  • SmartEmailField
  • SmartPasswordField
  • SmartPhoneField
  • SmartDateField
  • SmartOtpField
  • SmartBarcodeField
  • SmartDropdownField
  • SmartCheckboxField
  • SmartFileUploadField
  • SmartImageUploadField
  • SmartSuggestionField
  • SmartSignatureField
  • SmartArrayField

• Reactive visibility updates with ReactiveVisibility wrapper.

• Customizable field styles and spacing.

• Form submission handling with loading state.

• Support for onSubmit callback with current form values.

• Scrollable forms with keyboard dismissal.

• Optional formKey for external validation handling.

• Easily extensible for custom fields.

Fixed

• N/A (Initial release)

Changed

• N/A (Initial release)