adar2378/pin_code_fields

https://i.ibb.co/X5qxF7x/export-banner.png

https://img.shields.io/pub/v/pin_code_fields

Pin Code Fields

A highly customizable Flutter package for PIN code and OTP input fields with beautiful design and animations.

Version 9.0 introduces a new headless architecture - use the ready-made Material Design implementation or build completely custom UIs!

Package Location

The publishable package is located at:

packages/pin_code_fields/

📦 View Package README for full documentation.

Quick Start

dependencies:
  pin_code_fields: ^9.0.0

import 'package:pin_code_fields/pin_code_fields.dart';

// Material Design (ready to use)
MaterialPinField(
  length: 6,
  onCompleted: (pin) => print('PIN: $pin'),
)

// Custom UI (headless)
PinInput(
  length: 4,
  builder: (context, cells) => YourCustomUI(cells),
)

Repository Structure

pin_code_fields/
├── packages/
│   └── pin_code_fields/      # 📦 Main package
│       ├── lib/
│       │   └── src/
│       │       ├── core/     # Headless input engine
│       │       └── material/ # Material Design implementation
│       ├── example/
│       ├── test/
│       ├── README.md
│       ├── CHANGELOG.md
│       └── LICENSE
├── docs/
│   └── FEATURE_COMPARISON.md
├── melos.yaml
└── CLAUDE.md

Development

This project uses melos for monorepo management.

# Install melos
dart pub global activate melos

# Bootstrap workspace
melos bootstrap

# Run tests
melos test

# Run analyzer
melos analyze

Features

• 🎨 Headless Architecture - Full control over UI rendering
• 📱 Material Design Ready - Beautiful out-of-the-box implementation
• 🎮 Unified Controller - Single controller for text, focus, and errors
• ✨ Rich Animations - Scale, fade, slide entry animations
• 🔐 Obscure Support - Character or custom widget obscuring
• 📋 Paste Support - Long-press to paste from clipboard
• 📝 Form Integration - Works with Flutter's Form widget
• 📲 Autofill Support - SMS OTP autofill for iOS/Android
• 💫 Error Animation - Shake animation with programmatic control

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE for details.