pub package License: MIT GitHub top language


Flutter_Otp_Text_Field is a TextField widget to help display different style pin. It supports all the platforms flutter supports.

Feature 👇👇

  • allows you to customize the shape of textField in any way you want
  • built-in 2 commonly used pin styles of shape
  • obscure support
  • input decoration support
  • support all the textField properties support
  • Flutter web support

Installing 🔧

Install the latest version from pub.


Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:

  flutter_otp_text_field: ^0.0.1

2. Install it

You can install packages from the command line: with Flutter:

$ flutter packages get

Alternatively, your editor might support flutter packages get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:

import 'package:flutter_otp_text_field/flutter_otp_text_field.dart';


            numberOfFields: 5,
            borderColor: Color(0xFF512DA8),
            showFieldAsBox: true, //set to true to show as box or false to show as dash
            onCodeChanged: (String code) {
                //handle validation or checks here           
            onSubmit: (String verificationCode){
                  context: context,
                  builder: (context){
                    return AlertDialog(
                      title: Text("Verification Code"),
                      content: Text('Code entered is $verificationCode'),
            }, // end onSubmit


Customizable attributes for PinInputTextField

Attribute Name Example Value Description
numberOfFields 4 The default is 4
fieldWidth 40 allows to change the width of the textField
showFieldAsBox true changes the default decoration of the textFields to a box with borderRadius of 4.0
hasCustomInputDecoration true set this to true if you want to pass your own decoration
decoration InputDecoration set hasCustomInputDecoration to true and pass your own input decoration the way you see fit
filled false set to true if you want to pass a fillColor
fillColor Colors.red pass fillColor and set filled to true
borderRadius BorderRadius.all(Radius.circular(4.0)) pass BorderRadius to customise textField when showFieldAsBox is set to true
margin EdgeInsets.only(right: 8.0) customize the margin between each textField
textStyle TextStyle(fontSize: 20, color: Colors.green); Add custom textStyle
borderWidth 2.0 Default value is 2.0, allows you to customize the width of the border
cursorColor Colors.blue Change color of textFields cursor. Defaults to [ThemeData.cursorColor] or [CupertinoTheme.primaryColor] depending on [ThemeData.platform].
mainAxisAlignment MainAxisAlignment.center Defaults to MainAxisAlignment.center
crossAxisAlignment CrossAxisAlignment.center Defaults to CrossAxisAlignment.center
onSubmit (String pin){} The callback will execute when user is done inputting the verification code.
keyboardType TextInputType.number Just like TextField's keyboardType, the default is TextInputType.number
autoFocus false Same as TextField's autoFocus, the default is false
enabled true Same as TextField's enabled, the default is true
obscureText false Defaults to false
onCodeChanged (String code){} Executes every time a value is entered into the textField. Same as TextField's onChanged