adar2378 · bazookon · Aug 27, 2026
diff --git a/.fvmrc b/.fvmrc
@@ -0,0 +1,3 @@
+{
+  "flutter": "3.47.1"
+}
diff --git a/.gitignore b/.gitignore
@@ -27,3 +27,6 @@ migrate_working_dir/
 **/doc/api/
 .dart_tool/
 build/
+
+# FVM Version Cache
+.fvm/
diff --git a/packages/pin_code_fields/CHANGELOG.md b/packages/pin_code_fields/CHANGELOG.md
@@ -1,3 +1,19 @@
+## 10.0.0
+
+### 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).
+
+Apps that still import `package:flutter/material.dart` should either migrate with `dart fix --apply --code=migrate_design_widgets`, or wrap mixed trees with `MaterialUiCompatibilityBridge`. See [migration/10.0.0/MIGRATION_GUIDE.md](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.
+
 ## 9.4.0
 
  - **FIX**: suppress semantic hint and focused state when disabled (#427).

diff --git a/packages/pin_code_fields/README.md b/packages/pin_code_fields/README.md
@@ -66,12 +66,22 @@ Add to your `pubspec.yaml`:
 
 ```yaml
 dependencies:
-  pin_code_fields: ^9.0.0
+  pin_code_fields: ^10.0.0
+  material_ui: ^1.0.0
+```
+
+Requires **Flutter 3.44+** (tested on **Flutter 3.47**). `pin_code_fields` now depends on the standalone [`material_ui`](https://pub.dev/packages/material_ui) and [`cupertino_ui`](https://pub.dev/packages/cupertino_ui) packages introduced in Flutter 3.47.
+
+If you are still on `package:flutter/material.dart`, run:
+
+```bash
+dart fix --apply --code=migrate_design_widgets
 ```
 
 ### Quick Start - Material Design
 
 ```dart
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 MaterialPinField(
@@ -91,6 +101,7 @@ MaterialPinField(
 For complete control over the UI, use the headless `PinInput`:
 
 ```dart
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 PinInput(
@@ -413,6 +424,17 @@ PinCellData(
 )
 ```
 
+## Migration from v9.x 🔄
+
+v10.0.0 is a **major** release for Flutter 3.47: Material and Cupertino now live in standalone packages.
+
+1. Upgrade Flutter (`flutter upgrade` to 3.47, or at least 3.44).
+2. Bump the dependency to `pin_code_fields: ^10.0.0` and add `material_ui: ^1.0.0`.
+3. Replace `package:flutter/material.dart` with `package:material_ui/material_ui.dart` (`dart fix --apply --code=migrate_design_widgets`).
+4. If some of your dependencies still use the SDK Material library, wrap the app with `MaterialUiCompatibilityBridge`.
+
+📖 **Full migration guide**: [migration/10.0.0/MIGRATION_GUIDE.md](https://github.com/adar2378/pin_code_fields/blob/main/packages/pin_code_fields/migration/10.0.0/MIGRATION_GUIDE.md)
+
 ## Migration from v8.x 🔄
 
 Upgrading from v8.x? Here's a quick reference:

diff --git a/packages/pin_code_fields/analysis_options.yaml b/packages/pin_code_fields/analysis_options.yaml
@@ -1,3 +1,12 @@
+analyzer:
+  exclude:
+    - build/**
+    - android/**
+    - ios/**
+    - web/**
+    - windows/**
+    - macos/**
+    - linux/**
 include: package:flutter_lints/flutter.yaml
 
 linter:

diff --git a/packages/pin_code_fields/example/analysis_options.yaml b/packages/pin_code_fields/example/analysis_options.yaml
@@ -7,6 +7,15 @@
 
 # The following line activates a set of recommended lints for Flutter apps,
 # packages, and plugins designed to encourage good coding practices.
+analyzer:
+  exclude:
+    - build/**
+    - android/**
+    - ios/**
+    - web/**
+    - windows/**
+    - macos/**
+    - linux/**
 include: package:flutter_lints/flutter.yaml
 
 linter:

diff --git a/packages/pin_code_fields/example/lib/demos/animations/creative_cell_animations_demo.dart b/packages/pin_code_fields/example/lib/demos/animations/creative_cell_animations_demo.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// Creative Cell Animations - Showcase headless architecture flexibility

diff --git a/packages/pin_code_fields/example/lib/demos/animations/custom_cursor_demo.dart b/packages/pin_code_fields/example/lib/demos/animations/custom_cursor_demo.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// Custom Cursor - Different cursor styles

diff --git a/packages/pin_code_fields/example/lib/demos/animations/entry_animations_demo.dart b/packages/pin_code_fields/example/lib/demos/animations/entry_animations_demo.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// Entry Animations - Compare all animation types

diff --git a/packages/pin_code_fields/example/lib/demos/customization/headless_builder_demo.dart b/packages/pin_code_fields/example/lib/demos/customization/headless_builder_demo.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// Headless Builder - Completely custom UI

diff --git a/packages/pin_code_fields/example/lib/demos/customization/hints_demo.dart b/packages/pin_code_fields/example/lib/demos/customization/hints_demo.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// Hints Demo - Hint characters and widgets

diff --git a/packages/pin_code_fields/example/lib/demos/customization/obscure_text_demo.dart b/packages/pin_code_fields/example/lib/demos/customization/obscure_text_demo.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// Obscure Text Demo - Password mode with blink effect

diff --git a/packages/pin_code_fields/example/lib/demos/customization/separators_demo.dart b/packages/pin_code_fields/example/lib/demos/customization/separators_demo.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// Separators Demo - Custom separators between cells

diff --git a/packages/pin_code_fields/example/lib/demos/customization/text_gradient_demo.dart b/packages/pin_code_fields/example/lib/demos/customization/text_gradient_demo.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// Text Gradient - Apply gradient effects to PIN text

diff --git a/packages/pin_code_fields/example/lib/demos/interactions/autofill_demo.dart b/packages/pin_code_fields/example/lib/demos/interactions/autofill_demo.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// Autofill Demo - SMS autofill and keyboard suggestions

diff --git a/packages/pin_code_fields/example/lib/demos/interactions/clipboard_demo.dart b/packages/pin_code_fields/example/lib/demos/interactions/clipboard_demo.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:flutter/services.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 

diff --git a/packages/pin_code_fields/example/lib/demos/interactions/custom_formatters_demo.dart b/packages/pin_code_fields/example/lib/demos/interactions/custom_formatters_demo.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:flutter/services.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 

diff --git a/packages/pin_code_fields/example/lib/demos/interactions/form_validation_demo.dart b/packages/pin_code_fields/example/lib/demos/interactions/form_validation_demo.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// Form Validation - Using PIN fields with Form validation

diff --git a/packages/pin_code_fields/example/lib/demos/quick_start/basic_demo.dart b/packages/pin_code_fields/example/lib/demos/quick_start/basic_demo.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// Basic Usage - Simplest example

diff --git a/packages/pin_code_fields/example/lib/demos/quick_start/controller_demo.dart b/packages/pin_code_fields/example/lib/demos/quick_start/controller_demo.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// Controller Usage - Programmatic control

diff --git a/packages/pin_code_fields/example/lib/demos/shapes_themes/app_wide_theming_demo.dart b/packages/pin_code_fields/example/lib/demos/shapes_themes/app_wide_theming_demo.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// Demo showing how to use MaterialPinThemeExtension for app-wide theming

diff --git a/packages/pin_code_fields/example/lib/demos/shapes_themes/color_customization_demo.dart b/packages/pin_code_fields/example/lib/demos/shapes_themes/color_customization_demo.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// Color Customization - Comprehensive state-based theming

diff --git a/packages/pin_code_fields/example/lib/demos/shapes_themes/shadows_demo.dart b/packages/pin_code_fields/example/lib/demos/shapes_themes/shadows_demo.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// Shadows Demo - Box shadows and elevation

diff --git a/packages/pin_code_fields/example/lib/demos/shapes_themes/shape_gallery_demo.dart b/packages/pin_code_fields/example/lib/demos/shapes_themes/shape_gallery_demo.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// Shape Gallery - All 4 shapes side-by-side

diff --git a/packages/pin_code_fields/example/lib/demos/state_theming/all_states_demo.dart b/packages/pin_code_fields/example/lib/demos/state_theming/all_states_demo.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// All States Demo - Visual state machine

diff --git a/packages/pin_code_fields/example/lib/demos/state_theming/error_state_demo.dart b/packages/pin_code_fields/example/lib/demos/state_theming/error_state_demo.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// Error State Demo - Error handling and display

diff --git a/packages/pin_code_fields/example/lib/home_page.dart b/packages/pin_code_fields/example/lib/home_page.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 
 // Use Cases
 import 'use_cases/otp_verification_page.dart';

diff --git a/packages/pin_code_fields/example/lib/main.dart b/packages/pin_code_fields/example/lib/main.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 import 'home_page.dart';

diff --git a/packages/pin_code_fields/example/lib/playground/playground_page.dart b/packages/pin_code_fields/example/lib/playground/playground_page.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// Comprehensive Playground - Interactively customize all options

diff --git a/packages/pin_code_fields/example/lib/use_cases/app_lock_screen.dart b/packages/pin_code_fields/example/lib/use_cases/app_lock_screen.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// App Lock Screen - Full-screen PIN lock

diff --git a/packages/pin_code_fields/example/lib/use_cases/invite_code_page.dart b/packages/pin_code_fields/example/lib/use_cases/invite_code_page.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// Invite/Referral Code - Alphanumeric code input

diff --git a/packages/pin_code_fields/example/lib/use_cases/otp_verification_page.dart b/packages/pin_code_fields/example/lib/use_cases/otp_verification_page.dart
@@ -1,6 +1,6 @@
 import 'dart:async';
 
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// OTP Verification - Stunning visual design

diff --git a/packages/pin_code_fields/example/lib/use_cases/payment_pin_page.dart b/packages/pin_code_fields/example/lib/use_cases/payment_pin_page.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:flutter/services.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 

diff --git a/packages/pin_code_fields/example/lib/use_cases/pin_login_page.dart b/packages/pin_code_fields/example/lib/use_cases/pin_login_page.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// PIN Login - Authenticate with PIN

diff --git a/packages/pin_code_fields/example/lib/use_cases/pin_setup_flow.dart b/packages/pin_code_fields/example/lib/use_cases/pin_setup_flow.dart
@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:pin_code_fields/pin_code_fields.dart';
 
 /// PIN Setup Flow - Two-step PIN creation