• pin_code_fields@10.0.1

Breaking Changes ⚠️

Migrate to Flutter 3.47's standalone design-system packages.

• Material / Cupertino imports: package:flutter/material.dart and package:flutter/cupertino.dart are replaced with package:material_ui/material_ui.dart and package:cupertino_ui/cupertino_ui.dart.
• New dependencies: material_ui and cupertino_ui (the Flutter SDK still ships the old libraries in 3.47, but they are scheduled for deprecation).
• Minimum SDK: Dart ^3.12.0, Flutter >=3.44.0 (tested on Flutter 3.47.1 / Dart 3.13.1).
• Theme lookups: The package reads material_ui's Theme. Apps still on package:flutter/material.dart will not have their ThemeData picked up, so PIN fields fall back to default colors.
• MaterialPinThemeExtension: Must be registered on material_ui's ThemeData. Registering it on the SDK ThemeData is a compile error.

Your app must use material_ui to use 10.x. Migrate with dart fix --apply --code=migrate_design_widgets. If your app is still on package:flutter/material.dart, stay on pin_code_fields: ^9.4.0. MaterialUiCompatibilityBridge only helps the other direction: a migrated app with dependencies that still use SDK Material. See migration/10.0.0/MIGRATION_GUIDE.md.

Features ✨

• Flutter 3.47 support: PIN fields now use the pub.dev material_ui / cupertino_ui 1.0 packages so Material types (ThemeData, ColorScheme, selection handles, context menus) stay in sync with the decoupled design system.

• FIX: hide the invisible input from screen readers.

• FIX: show long-press context menu on screen (#432).
• FEAT: add autocorrect parameter to pin fields (#431).

• FIX: suppress semantic hint and focused state when disabled (#…

• FEAT: add semanticHintBuilder parameter for customizable accessibility hints.
  • Enables localization of screen reader hints to different languages
  • Supports custom terminology (e.g., "characters" instead of "digits")
  • Allows static hints for context-specific guidance
  • Maintains backward compatibility with default English hints
  • Fixes #424

Features ✨

• Theme Extension: Added MaterialPinThemeExtension for embedding MaterialPinTheme in ThemeData
  • Register a default PIN theme at the app level using ThemeData.extensions
  • Access the theme anywhere with Theme.of(context).materialPinTheme
  • Supports light/dark theme configurations
  • MaterialPinField automatically uses the global theme when no explicit theme is provided
  • Added example demo showing app-wide theming usage
• MaterialPinFormField: New Material Design form field with built-in Form validation
  • Combines MaterialPinField styling with FormField capabilities (validator, onSaved, autovalidateMode)
  • Dual error states: controller errors trigger shake animation, form validation shows error text below the field
  • Theme resolution from widget prop, ThemeData extension, or default
  • reset() clears both text and controller error state

Bug Fixes 🐛

• PinInputFormField: Added missing parameters that exist in PinInput — onClipboardFound, clipboardValidator, onLongPress, onTapOutside, mouseCursor, semanticLabel

Documentation 📚

• Updated README with "App-Wide Theming" section
• Added code examples for theme extension setup and usage

Breaking Changes ⚠️

This is a complete rewrite with a new headless architecture. Migration required.

• New Headless Architecture: The package now provides both a headless core (PinInput) and a Material Design implementation (MaterialPinField)
• Unified Controller: PinInputController replaces separate TextEditingController, FocusNode, and errorAnimationController
• Theme System: New MaterialPinTheme with automatic ColorScheme resolution
• Renamed Parameters: See migration guide below

Features ✨

• Headless Core: Build completely custom PIN UIs with PinInput and PinCellData
• Material Design Ready: Use MaterialPinField for beautiful, ready-to-use PIN fields
• PinInputController: Single controller for text, focus, and error state management
  • setText(), clear(), text - Text control
  • triggerError(), clearError(), hasError - Error control
  • requestFocus(), unfocus(), hasFocus - Focus control
• Improved Animations: Scale, fade, slide, and none animation types
• All Cell Shapes: Outlined, filled, underlined, and circle
• Text Gradient: Apply gradients to PIN text via MaterialPinTheme.textGradient
• Custom Obscuring Widget: Use any widget for obscuring with obscuringWidget
• Form Integration: PinInputFormField for form validation
• SMS Autofill: Full autofill support with enableAutofill and autofillHints
• Haptic Feedback: Configurable haptic feedback types
• Accessibility (Semantics): Full screen reader support with semanticLabel parameter
  • Announces field purpose (e.g., "6-digit PIN code field")
  • Provides hints about remaining digits
  • Masks values when obscured for privacy
  • Exposes enabled/focused states
• cursorAlignment: Position custom cursor widgets within cells (e.g., underscore at bottom)
• onClipboardFound: Callback when clipboard contains valid PIN-like content on focus
• onTapOutside: Callback when user taps outside the field
• errorText & errorBuilder: Custom error display below the PIN field
• followingFillColor & followingBorderColor: Style for cells after the focused cell
• completeFillColor, completeBorderColor & completeTextStyle: Style when all cells are filled

Bug Fixes 🐛

• iOS App Hang fix: All Clipboard.getData calls are now guarded with a 500 ms timeout so a stalled native clipboard never blocks the UI thread
• Focus-triggered clipboard probe deferred: _checkClipboard() dispatched via addPostFrameCallback instead of running synchronously inside the focus listener
• Long-press paste deferred: Default context menu no longer triggers an eager clipboard read; clipboard data is read only after the user explicitly taps Paste
• Centralised safe clipboard helper: All clipboard reads go through _safeClipboardRead() with try/catch + .timeout()
• Focus on complete: Last cell now shows focused state when PIN is complete and field is focused
• Cursor alignment: Fixed custom cursor positioning - removed internal Center widget that was overriding alignment
• Web input: Fixed text input not working on web by adjusting invisible text field configuration
• Controller notifications: Fixed PinInputController not notifying listeners on focus/text changes

Example App 📱

• Added comprehensive use case demos (OTP verification, PIN setup, PIN login, payment confirmation, invite codes, app lock screen)
• Added feature demos for all customization options
• Added interactive Playground for real-time customization of all options

Documentation 📚

• Updated README with demo GIFs showcasing all features
• Added static screenshots for pub.dev gallery

Migration Guide

Parameter Renames

Basic Migration

Before (v8.x):

PinCodeTextField(
  appContext: context,
  length: 6,
  controller: textController,
  focusNode: focusNode,
  pinTheme: PinTheme(
    shape: PinCodeFieldShape.box,
    activeColor: Colors.blue,
  ),
  onChanged: (value) {},
  onCompleted: (value) {},
)

After (v9.0):

final pinController = PinInputController();

MaterialPinField(
  length: 6,
  pinController: pinController,
  theme: MaterialPinTheme(
    shape: MaterialPinShape.outlined,
    focusedBorderColor: Colors.blue,
  ),
  onChanged: (value) {},
  onCompleted: (value) {},
)

Error Handling Migration

Before:

final errorController = StreamController<ErrorAnimationType>();
errorController.add(ErrorAnimationType.shake);

After:

final pinController = PinInputController();
pinController.triggerError();  // Triggers shake + sets error state
pinController.clearError();    // Clears error state

• Added activeBorderWidth, selectedBorderWidth, inactiveBorderWidth, disabledBorderWidth, errorBorderWidth

• Updated Dart SDK constraint sdk: ">=2.12.0 <4.0.0"
• Use PinCodePlatform instead Platform enum
• Numerous bug fixes, thanks to each and every contributor for resolving issues

• Added new attributes readOnly, textGradient, errorTextDirection, errorTextMargin, autoUnfocus
• Resolved blinkDebounce setState() after dispose() bug
• Example app refactor

AutovalidateMode.disabled will not add extra space below the pin cells
Added new attributes errorBorderColor, readOnly, textGradient and scrollPadding

• Much requested feature placeholder has been added hintCharacter
• hintStyle has been added to customize the hint TextStyle

• Added useExternalAutoFillGroup to use this widget with external AutofillGroup
• Added fieldOuterPadding to add extra padding on each cells. Default to 0.0

Features ✨

• Added AutofillContextAction, default is AutofillContextAction.commit

Breaking changes ⚠️

• Migrated to null-safety.
• Minimum Flutter version is set to 1.22.0

Fixes 🐛

• Fixed default text value not showing, #153

Features ✨

• Added haptic feedback enum HapticFeedbackTypes { heavy, light, medium, selection, vibrate, }
• Added animated obscure widget support obscuringWidget and blinkWhenObscuring

Fixes 🐛

• Fixed bug related to TextStyle not given.
• Fixed bug related to setState is being called after disposal.

Added fallback color when the cursor color fails to retrive and fixed deprecated List constructors.

Fixed read-only warning when field is not enabled & cursor animation now only triggers if showCursor = true

Features ✨

• Added Cursor
  `
  /// Whether to show cursor or not
  final bool showCursor;

  /// The color of the cursor, default to Theme.of(context).accentColor
  final Color cursorColor;

  /// width of the cursor, default to 2
  final double cursorWidth;

  /// Height of the cursor, default to FontSize + 8;
  final double cursorHeight;
  `

• Added boxhShadows

Breaking changes ⚠️

• autoValidate changed according to the new version of Flutter
• Minimum Flutter version is set to 1.22.0

Fixes 🐛

• typo fixes

[5.1.0]

Features ✨

• Added errorAnimationDuration to customize Error animation duration.
• Added enablePinAutofill to enable or disable the auto-fill feature.

Breaking changes ⚠️

• Chagned textInputType to more familiar keyboardType to change they keyboard type

Fixes 🐛

• Fixed rootNavigator issue for paste dialogs, #101

Features ✨

• Added onSave, onTap callbacks.
• Added PastedTextStyle.
• Added iOS autofill added wtih Flutter version 1.20.0

Breaking changes ⚠️

• Must provide context in the appContext parameter.
• Minimum Flutter version is set to 1.20.0

Fixes 🐛

• Reopen keyboard onTap on the cells #92, thanks to https://github.com/YaroslavGS for the suggestion

Features ✨
Added support for flutter-web
Breaking changes ⚠️
Replaced internal automatic OS selection for dialog styles, you can select which style you want by configuring with the DialogConfig

• Introduced PinTheme & DialogConfig
• Added beforeTextPaste callback
• Added onCompleted callback

• Added animations while changing value
• Added multiple customization parameters
• Pressing backspace focuses previous field