0.8.1 (2026-08-06)

Features

• upgrade to Dart 3.12 (#152) (24e443c), closes #151

Miscellaneous Chores

• deps: bump very_good_analysis from 6.0.0 to 7.0.0 (#135) (971f906)
• deps: bump very_good_analysis from 6.0.0 to 7.0.0 in /example (#134) (126237f)
• deps: bump very_good_analysis from 7.0.0 to 9.0.0 (#139) (3da77ad)
• deps: bump very_good_analysis from 9.0.0 to 10.0.0 (#143) (5e967a2)
• deps: upgrade very_good_analysis to ^10.3.0 (#155) (2bf536f), closes #154
• fixing changelog formatting (#132) (54eaea0)

Docs

• add contributing documentation (#141) (32a0483)

Features

• upgrade to Dart 3.12 (#152) (24e443c), closes #151

Miscellaneous Chores

• deps: bump very_good_analysis from 6.0.0 to 7.0.0 (#135) (971f906)
• deps: bump very_good_analysis from 6.0.0 to 7.0.0 in /example (#134) (126237f)
• deps: bump very_good_analysis from 7.0.0 to 9.0.0 (#139) (3da77ad)
• deps: bump very_good_analysis from 9.0.0 to 10.0.0 (#143) (5e967a2)
• deps: upgrade very_good_analysis to ^10.3.0 (#155) (2bf536f), closes #154
• fixing changelog formatting (#132) (54eaea0)

Docs

• add contributing documentation (#141) (32a0483)

• chore: tighten dependencies (#127) - Note: This now requires Dart 3.5.0 or higher.
• chore(deps): bump VeryGoodOpenSource/very_good_coverage from 2 to 3 (#120)
• chore(deps): bump very_good_analysis from 5.1.0 to 6.0.0 in /example (#124)
• chore(deps): bump very_good_analysis from 5.1.0 to 6.0.0 (#125)

• chore: tighten dependencies (#127) - Note: This now requires Dart 3.5.0 or higher.

• feat!: update Dart version constraints to "^3.0.0" (#115)

• feat!: update Dart version constraints to "^3.0.0" (#115)

• fix(example): update validation to throw on empty values (#100)
• chore: update very good analysis to 5.1.0 (#104)
• fix(docs): wrong docs (#106)

• fix(example): update validation to throw on empty values (#100)
• chore: update very good analysis to 5.1.0 (#104)
• fix(docs): wrong docs (#106)

• feat: add FormzInputErrorCacheMixin mixin
• feat: add isInProgressOrSuccess to FormzSubmissionStatusX
• feat: add purity check to FormzMixin

• feat: add FormzInputErrorCacheMixin mixin
• feat: add isInProgressOrSuccess to FormzSubmissionStatusX
• feat: add purity check to FormzMixin

• docs: add a caching example
• refactor: update very good analysis, workflows, flutter/dart version
• feat: update very good analysis
• feat: add dependabot
• BREAKING: this release promotes 0.5.0-dev.1 which brings breaking changes

• docs: add caching example
• refactor: update very good analysis, workflows, flutter/dart version
• feat: update very good analysis
• feat: add dependabot
• BREAKING: this release promotes 0.5.0-dev.1 which brings breaking changes

0.5.0-dev.1

• docs: use nullable validator in README

• feat: add example Flutter app

• BREAKING: decouple purity, validity, and submission status

  Changes

  1. FormzStatus renamed to FormzSubmissionStatus:

  /// Enum representing the submission status of a form.
  enum FormzSubmissionStatus {
  /// The form is in the process of being submitted.
  inProgress,
  
  /// The form has been submitted successfully.
  success,
  
  /// The form submission failed.
  failure,
  
  /// The form submission has been canceled.
  canceled
  }

  1. FormzInput class no longer exposes a status (FormzInputStatus). Instead there are isValid and isNotValid getters:

  class NameInput extends FormzInput<String, NameInputError> {
  const NameInput.pure() : super.pure('');
  const NameInput.dirty({String value = ''}) : super.dirty(value);
  
  @override
  NameInputError? validator(String value) {
      return value.isNotEmpty == true ? null : NameInputError.empty;
  }
  }
  
  void main() {
  const name = NameInput.pure();
  print(name.isValid); // false
  print(name.isNotValid); // true
  
  const joe = NameInput.dirty(value: 'joe');
  print(joe.isValid); // true
  print(joe.isNotValid); // false
  }

  1. FormzInput has a displayError getter which returns an error to display if the input is not valid and has been modified by the user (closes #44)

  void main() {
  const name = NameInput.pure();
  print(name.displayError); // null
  
  const invalid = NameInput.dirty(value: '');
  print(name.displayError); // NameInputError.empty
  }

  1. Renamed pure to isPure for consistency

• docs: use nullable validator in README

• feat: add example Flutter app

• BREAKING: decouple purity, validity, and submission status

  Changes

  1. FormzStatus renamed to FormzSubmissionStatus:

  /// Enum representing the submission status of a form.
  enum FormzSubmissionStatus {
  /// The form is in the process of being submitted.
  inProgress,
  
  /// The form has been submitted successfully.
  success,
  
  /// The form submission failed.
  failure,
  
  /// The form submission has been canceled.
  canceled
  }
  

  1. FormzInput class no longer exposes a status (FormzInputStatus). Instead there are isValid and isNotValid getters:

  class NameInput extends FormzInput<String, NameInputError> {
  const NameInput.pure() : super.pure('');
  const NameInput.dirty({String value = ''}) : super.dirty(value);
  
  @override
  NameInputError? validator(String value) {
      return value.isEmpty ? NameInputError.empty : null;
  }
  }
  
  void main() {
  const name = NameInput.pure();
  print(name.isValid); // false
  print(name.isNotValid); // true
  
  const joe = NameInput.dirty(value: 'joe');
  print(joe.isValid); // true
  print(joe.isNotValid); // false
  }
  

  1. FormzInput has a displayError getter which returns an error to display if the input is not valid and has been modified by the user (closes #44)

  void main() {
  const name = NameInput.pure();
  print(name.displayError); // null
  
  const invalid = NameInput.dirty(value: '');
  print(name.displayError); // NameInputError.empty
  }
  

  1. Renamed pure to isPure for consistency

• feat: add submissionCanceled to FormzStatus

• feat: add submissionCanceled to FormzStatus

• BREAKING: opt into null safety
• feat!: upgrade Dart SDK constraints to >=2.12.0-0 <3.0.0

• BREAKING: opt into null safety
• feat!: upgrade Dart SDK constraints to >=2.12.0-0 <3.0.0

• BREAKING: opt into null safety
• feat!: upgrade Dart SDK constraints to >=2.12.0-0 <3.0.0

• chore: fix code formatting
• ci: update to Dart 2.10.0

• Allow value to be null in FormzInput

• Add FormzMixin
• Fix Formz.validate to take pure into consideration
• Lint improvements

• Remove redundant extensions on FormzInputStatus
• Add isValidated extension on FormzStatus
• Add invalid getter to FormzInput

• Add extensions on FormzStatus
• Add extensions on FormzInputStatus

Initial Release of the formz.