flutter_smart_forms 1.0.1

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.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)