easy_stepper

Thursday, 23rd July, 2026

• Feat: Added verticalAlignment to align the steps of a vertical stepper to the start, center, or end — the connector line and titles follow the icons (resolves #62).
• Docs: Placed the four app mockups in a single row and made all variation demos a uniform size (equal aspect ratio).
• Chore: Refined the pub.dev package logo — smaller mark with padding so it reads well as a thumbnail.
• Chore: Added a "Vertical Stepper (Alignment)" example screen.

Thursday, 23rd July, 2026

• Docs: Refreshed branding — new logo and cover image, plus a square package logo shown on pub.dev (via screenshots).
• Docs: Rebuilt the README around stepper types, each with animated demos and collapsible, per-type example code.
• Docs: Added an app-mockup showcase at the top of the README.
• Chore: Updated the package description.

Tuesday, 19th May, 2026

• Feat: Added verticalTitlePlacement to EasyStepper, allowing vertical stepper titles to be rendered either beside the icon (VerticalTitlePlacement.side, default) or below the icon (VerticalTitlePlacement.belowIcon), with correct LTR/RTL handling.
• Feat: Added LineStyle.verticalLinePadding to add extra spacing around the connecting line when titles are placed below the icon.
• Chore: Added a "Vertical Stepper (Title Below)" example screen.

Wednesday, 31st Dec, 2025

• Chore: Applied dart format to all package files.
• Chore: Internal code cleanup and minor refinements.

Wednesday, 31st Dec, 2025

• Stable Release: Official 1.0.0 release for production use.
• Feat: Implemented Flexible Line Length support. Use lineLength: double.infinity to allow lines to fill available space (Fixes #30 and #56).
• Feat: Horizontal flexible lines now dynamically calculate available width to ensure title wrapping and prevent container overflow.
• Feat: Vertical flexible lines now support centered lineText overlaying the connecting line.
• Feat: Enabled Lottie animations on Web platform.
• Fix: Wrapped step titles in GestureDetector to ensure custom titles respond to tap gestures (Fixes #60).
• Fix: Refined InkWell splash radius and shape to match step icons (ensuring circular splash for circular steps).
• Fix: Resolved "unbounded height" layout error for horizontal flexible steppers.
• Fix: Ensured vertical lines correctly expand and center within the stepper column.
• Fix: Improved visibility of dashed/dotted lines in vertical orientation and fixed vertical dashed line rendering.
• Fix: Removed redundant forced padding in vertical steppers to allow "zero padding" designs.
• Fix: Upgraded linting rules and fixed all analysis issues.
• Refactor: Extracted EasyStep building logic into StepBuilder for improved scalability and maintainability.
• Docs: Added comprehensive DartDoc comments to public APIs.
• Test: Achieved 100% test coverage with comprehensive widget tests.

Thursday, 10th Oct, 2025

• Updated project dependencies to their latest compatible versions.
• Refactored key parameters in EasyBorder and EasyLine for improved clarity and maintainability.
• Simplified internal logic to enhance readability and consistency across components.

Wednesday, 9th Oct, 2025

• Feat: Added maxTitleLines property to limit the number of lines for step titles.
• Feat: Introduced borderRadius support in LineStyle and EasyLine for smoother line edges.
• Fix: Improved platform support for mobile and web.
• Update: Improved padding calculations to handle larger titles and prevent text clipping. Thanks to Mostafa Abdelazim.
• Update: Enhanced step layout alignment and spacing for better visual consistency. Thanks to Basem Osama
• Update: Changed the default value of showScrollbar to false for a cleaner initial UI.
• Update: Title and icon colors now adapt automatically to the theme’s ColorScheme for improved appearance.
• Refactor: Updated _buildLine and _buildProgressLine to use the new borderRadius feature.
• Updated BaseStepDelegate to use more direction-aware naming for title positioning.
• Introduced a new property: placeTitleAtStart — a clearer, axis-independent replacement for topTitle.
  • placeTitleAtStart = true → places the title above the step in horizontal mode, or on the start side (left in LTR / right in RTL) in vertical mode.
  • placeTitleAtStart = false → places the title below (horizontal) or on the end side (vertical).

⚠️ Deprecations

• topTitle has been deprecated and will be removed in the next release.
  Please migrate to the new placeTitleAtStart property for better readability and directional consistency.

Sunday, 19th May, 2024

• Fix: static analysis

Sunday, 2nd Aug, 2024

• Fix: static analysis

Sunday, 28th Apr, 2024

• Fix: multiline step title display. Thanks to SeriousMonk.

Thursday, 30th Nov, 2023

• Fix: flutter version constraint error in pubspec.yaml. Thanks to Xiaochao Fang.

Tuesday, 14th Nov, 2023

• Fix: Top title get cut when stepper is scrollable in web. Thanks to BelalNayzak.
• Update CHANGELOG.

Wednesday, 27th Sept, 2023

• Update README.md

Tuesday, 26th Sept, 2023

• feat: Support Different line type for reached & unreached steps. Thanks to ARASHz4
• feat: Add Line progress & progressColor for LineStyle. Thanks to lx8s8
• feat: LineType now support new dashed type, you can access it via LineType.dashed.
• Breaking Change: All properties related to the line style moved to LineStyle class. [lineType , defaultLineColor , unreachedLineColor , activeLineColor , finishedLineColor , lineLength , lineWidth , lineThickness , lineSpace , unreachedLineType].
• Update example app.
• Update CHANGELOG.

Saturday, 22th Jul, 2023

• [Specific reached steps] With this change, the user could disable certain steps in the stepper. Thanks to thfr69
• Update example with external navigation (forward and back button) in the main.dart file.

Monday, 19th Jun, 2023

• Minor fix.

Monday, 19th Jun, 2023

• Fix minor bugs in Stepper Scrolling.

Sunday, 18th Jun, 2023

• Add showScrollbar to easy_stepper to Show or Hide Scrollbar in Web or Desktop.
  Thanks to Francesco Bussolino
• Remove blank space when showTitle is false during vertical direction . Thanks to Martin Jablečník
• Update Example App
• Update README.md

Friday, 26th May, 2023

• Add fitWidth to easy_stepper to fill the full width of the screen when the disableScroll = true.
  Thanks to Maclaon & Seamoon Pandey
• Fix large title not showing correctly in the vertical stepper . Thanks to Basem Osama
• Remove unnecessary export of flutter/material.dart from the package. Thanks to ryanc16
• Update README.md

Thursday, 4th May, 2023

• Add maxReachedStep & isAlreadyReached to the Stepper in order to navigate only between already reached steps by step tapping. Thanks to Thorsten Fritzsche
• Add lineThickness instead of lineDotRadius (Deprecated).
• Update Example App

Thursday, 4th May, 2023

• Update README.md

Sunday, 30th April, 2023

• Added enabled property for EasyStep to enable/disable specific step despite steppingEnabled = true. Thanks to thfr69
• Update Example App
• Update README.md

Tuesday, 4th April, 2023

• Breaking Change: lineColor replaced by defaultLineColor, and now you can add more customization for line colors unreachedLineColor, activeLineColor & finishedLineColor. Thanks to adar2378
• Added topTitle property to setting the title above or below the step icon. Thanks to AbdulazizAlnahhas
• Fix minor bugs.
• Update Example App
• Update README.md

Friday, 24th March, 2023

• Adding customStep, customTitle & customLineWidget : Now you can create your own step widget with all customizations . Thanks to darshanjain64
• Update Example App
• Update README.md

Friday, 17th February, 2023

• Adding showLoadingAnimation : show or hide the loading animation inside the step . Thanks to OmarYehiaDev

Friday, 27th January, 2023

• Added options to customize step border type for different states.
• Show or hide the step border. Thanks to Seth-Pharès Gnavo

Saturday, 31th December, 2022

• Add New Rect & RRect Shapes To Stepper.
• Now We Can Control The line padding.
• Update example App.
• Fix Minor Bugs.
• Update README.md file.

Saturday, 24th December, 2022

• Upgrade to lottie 2.1.0
• Update example
• Match the dart formatter
• Update README.md file

Friday, 23th December, 2022

• Add loading animation to customize the loading animation icon from lottie package.
• Update stepper default colors to match theme colors.
• Fix normal line with large width bug.
• Add active border width.
• Update example app with new steppers.
• Change the minimum Dart-Sdk Version from v.2.17.5 to v.2.16.0.

Tuesday, 6th December, 2022

• Fix: Unable to load asset.

Tuesday, 6th December, 2022

• Match the Dart formatter.

Tuesday, 6th December, 2022

• Fix: Active Step radius

Monday, 5th December, 2022

• Fix: Fix Normal line bug.

Sunday, 4th December, 2022

• Feature: Add text for step line.
• Feature: Add line types [Normal , Dotted].
• Feature: Add Active & Finished Icons.
• Remove dotted_border Package.

Sunday, 4th December, 2022

• Minor Fixes.

Sunday, 4th December, 2022

• Minor Fixes.

Sunday, 4th December, 2022

• Initial release.

• Added IconStepper.