Search packages, repositories and app categories

stepper_a cover
Package detailsv1.4.0

stepper_a

StepperA is a simple and robust Flutter package which is making it possible to use FormKey validation and easy access your own button press control.

AndroidiOSWebmacOSWindowsLinux
30-day downloads
78
Likes
39
Pub points
160

Install package

flutter pub add stepper_a

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

StepperA is a lightweight Flutter package designed to simplify form navigation with step-by-step workflows. It enables seamless integration of FormKey validation and provides direct control over button presses, allowing developers to manage transitions between steps efficiently. Built for reliability across platforms, it supports Android, iOS, Web, macOS, Windows, and Linux. The package enhances user experience by offering predictable state management during multi-step processes.

Use cases

  • Multi-step form creation
  • Form validation in sequential steps
  • Custom button control in wizards
  • Cross-platform stepper interfaces
  • User onboarding flows
  • Dynamic form progression

Key features

  • Built-in FormKey validation
  • Direct button press control
  • Cross-platform compatibility
  • Simple API integration
  • State management for steps
  • Lightweight and fast

Suitable for

  • Developers building wizards
  • Teams needing form validation
  • Projects requiring step-by-step input
  • Apps with onboarding or checkout flows
  • Flutter beginners seeking simple stepper solutions

Considerations

  • Requires manual step state handling
  • Limited styling customization
  • No built-in animations
  • Best suited for basic stepper logic
  • Depends on proper FormKey usage
  • Not ideal for complex UI transitions

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Flutter StepperA

Key Features

Stepper A can easily build Stepper facility of you any flutter app.

  • Form Validation with FormKey [GlobalKey()]
  • Support Horizontal and Vertical Stepper
  • Customized Stepper step Shape [Rectangle, Circle,Diamond,Triangle]
  • Customized Stepper step border [Dash, Straight]
  • Customized Stepper line [Dash, Straight]
  • Smooth sliding with Animation
  • Number step text style provision added.
  • Stepper page swipe
  • Easily Customize Step [Image, IconData, or a fully custom widget builder]
  • Forward and previous button custom style .
  • Material 3 theming support via StepA.fromTheme(context)
  • Screen-reader friendly (Semantics labels on every step)
  • Jump directly to any step with StepperAController.jumpToStep()
  • Listen to step changes with the onStepChanged callback

package.yaml

stepper_a: <latest version>

Import

import 'package:stepper_a/stepper_a.dart';

Simple Example

 StepperA(
        stepperSize: const Size(300, 90),
        borderShape: BorderShape.rRect,
        borderType: BorderType.straight,
        stepperAxis: Axis.horizontal,
        lineType: LineType.dotted,
        stepperBackgroundColor: Colors.transparent,
        stepperAController: controller,
        stepHeight: 40,
        stepWidth: 40,
        stepBorder: true,
        pageSwipe: false,
        formValidation: true,
        previousButton: (int index) => StepperAButton(
            width: 90,
            height: 40,
            onTap: (int currentIndex){
            
            },
            buttonWidget: const Icon(
            Icons.arrow_back,
            color: Colors.white,
           ),
        ),
        forwardButton: (index) => StepperAButton(
            width: index == 0 ? 200 : 90,
            height: 40,
            onTap: (int currentIndex){
            
            },
            onComplete: (){
              debugPrint("Forward Button click complete step call back!");
            },
            buttonWidget: index == 3
            ? const Text('Complete', style: TextStyle(fontSize: 14, color: Colors.white))
                : const Text('Next', style: TextStyle(fontSize: 14, color: Colors.white)),
        ),
        customSteps: [
            const CustomSteps(stepsIcon: Icons.login, title: "LogIn"),
            const CustomSteps(stepsIcon: Icons.home, title: "Home"),
            const CustomSteps(stepsIcon: Icons.account_circle, title: "Account"),
            CustomSteps(image: Image.asset("assets/pic/pay.png",color: Colors.white,), title: "Payment"),
        ],
        step: const StepA(
            currentStepColor: Colors.green,
            completeStepColor: Colors.indigo,
            inactiveStepColor: Colors.black45,
            // loadingWidget: CircularProgressIndicator(color: Colors.green,),
            margin: EdgeInsets.all(5)
      ),
      stepperBodyWidget: [
            StepOne(controller: controller),
            StepTwo(controller: controller),
            StepThree(controller: controller),
            StepFour(controller: controller),
      ]
)

New in 1.4.0

Material 3 theming

Let the stepper pick up your app's ColorScheme automatically:

step: StepA.fromTheme(context),

Any color you still pass explicitly (e.g. StepA.fromTheme(context, currentStepColor: Colors.green)) overrides the theme default.

Jump to a step
controller.jumpToStep(
    index: 2,
    onTap: (currentIndex) {
      // currentIndex is now 2
    },
);
Listen for step changes
StepperA(
  // ...
  onStepChanged: (currentIndex) {
    debugPrint('Now on step $currentIndex');
  },
)
Fully custom step widget
CustomSteps(
  title: "Payment",
  builder: (context, index, isCompleted, isCurrent) => Icon(
    isCompleted ? Icons.check : Icons.payment,
    color: Colors.white,
  ),
)

ScreenShot

FormKey validation

Horizontal rectangle

Screenshot_20230602_233154

Custom Steps

vertical circle

Others

vertical circle

Horizontal circle

Horizontal rectangle

Support

If this package was useful to you, helped you to easily deliver your app, saved you a lot of time, or you just want to support the project, I would be grateful if you give us a rating.

Categories

Source repository

Projects using this package

No data available yet.