Skip to content
pubscout

flutter_wizard

2.0.5, released 4 years ago by baseflow.com

A library for creating custom multi-step wizards with full control over appearance.

WASM-ready
$ flutter pub add flutter_wizard
Source repository

What it does

It helps you build custom wizards by managing wizard steps, controllers, step states, and navigation events. You get complete control over the UI of each step and access to reactive streams for step indices and enabled actions.

AI-written summary of version 2.0.5, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You need to build a multi-step form or onboarding flow with custom UI.
  • You want full control over wizard appearance, step navigation, and validation states.

Skip it when

  • You only need a simple linear page view without step-based controllers or reactive state requirements.

Strengths

  • 100% control over the appearance of your wizard.
  • Built-in step state management using mixins with blocs, cubits, or providers.
  • Rich set of controllers and event listeners to manage step navigation.

Weaknesses

  • Requires manual setup of step controllers and state handlers.
  • Relies on external state management approaches for individual steps.

Setup

Kind
Flutter widgets
Effort
Low
Code generation
No
Direct dependencies
1

No native setup required. Simply wrap your widgets in DefaultWizardController and mix WizardStep into your state objects.

DefaultWizardController(
  stepControllers: [
    WizardStepController(
      step: provider.stepOneProvider,
    ),
  ],
  child: Wizard(
    stepBuilder: (context, state) {
      if (state is StepOneProvider) {
        return StepOne(provider: state);
      }
      return Container();
    },
  ),
)

Alternatives

Packages that do the same job and could replace flutter_wizard.

Works with

Packages commonly used together with flutter_wizard: ones it builds on, ones built on it, and its own family.