riverpod_form_binder Documentation

Overview

Coordinate field values and validation state when building forms with Riverpod.

riverpod_form_binder Coordinate field values and validation state when building forms with Riverpod.

Forms

Riverpod

Validation

Installation

Add the package to your Flutter project.

bash

flutter pub add riverpod_form_binder:^1.0.0

Quick Start

Start with this small example, then connect it to your own application. Read the known limitations before using it with real data.

dart

import 'package:riverpod_form_binder/riverpod_form_binder.dart';

class SignupFormNotifier extends FormBinderNotifier {
  SignupFormNotifier() {
    registerField<String>(
      'email',
      initialValue: '',
      validator: FieldValidator<String>()
          .required('Email is required')
          .email('Enter a valid email'),
    );
  }
}

This is a starting point, not a complete application. Add error handling and tests for your own backend and lifecycle.

Configuration

Keep configuration with the part of your application that owns the package instance. Connect authentication, storage, exporters or backend handlers explicitly rather than relying on hidden global state.

Use the versioned API reference for constructors and options. The starting example above focuses on a small integration surface; the repository example shows the surrounding application code.

Explore configuration in the API reference

Known Limitations

The audit reproduced a field that remains in its validating state after synchronous validation fails with an asynchronous validator configured. Test validation failures and disposal before adopting this release.

API Reference

Explore the public classes, methods and constructors for version 1.0.0.

Open versioned API reference

Example & Tests

Use the repository example to explore the package in context. Run its tests locally, and add regression cases for the known limitations above. The SSL package’s device test results do not apply to this package.

bash

git clone https://github.com/lekthedeveloper/riverpod_form_binder.git
cd riverpod_form_binder
flutter pub get
flutter test

View repository example

Frequently Asked Questions

Can I use this package in a commercial app?

The package is MIT licensed. Follow the license terms and review the current limitations for your use case.

Where should I report a bug?

Open an issue in the package repository. Include the package and Flutter versions, a minimal reproduction and the expected behavior. Remove credentials and private data.

Are these packages all verified for production?

No blanket guarantee is made. Each guide documents its current limitations. Test your integration and use independent review for sensitive workflows.