smooth_page_indicator
Customizable animated page indicator with a set of built-in effects.
3.0.0
1000K downloads/mo
#53 most downloaded on pub.dev
Milad-Akarie/smooth_page_indicator
What this package is like to depend on
Last release 2 days ago
21 Aug 2026
Release timing varies
gaps range from 9 days to 1.5 years
Some releases are documented
notes for 10 of 25 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
26 releases · first in 2020
3 releases in the last 12 months
see the full history below
Release timeline
26 releases · Jan 2020 to Aug 2026Releases
latest 26-
3.0.021 Aug 2026Release notes
Open source →-
Breaking:
SmoothPageIndicatorno longer derives its default colors from the app'sThemeData. The fallback colors are nowColor(0xFF3F51B5)for active dots andColor(0xFF9E9E9E)for inactive dots. -
Breaking:
SmoothPageIndicatorThemeis now anInheritedTheme, not aThemeExtension. It configures only its descendant indicators and is no longer added throughThemeData.extensions. -
Optimization: Painters now receive their offset as a
ValueListenable<double>, allowing offset changes to repaint only the painter instead of rebuilding the widget tree. -
Breaking: If you use
SmoothIndicatordirectly, its offset now takes aValueListenable<double>rather than adouble. -
Migrate to a design-system-agnostic setup by wrapping the indicator subtree with
SmoothPageIndicatorThemeand providingDefaultIndicatorColors:SmoothPageIndicatorTheme( defaultColors: DefaultIndicatorColors( active: Colors.blue, inactive: Colors.grey, ), child: MyPage(), ) -
To style individual indicators, continue setting
dotColorandactiveDotColoron their effects.WormEffectremains the fallback when no effect is supplied.
-
-
2.0.107 Dec 2025 -
2.0.007 Dec 2025Release notes
Open source →- Breaking: Default colors (
dotColor,activeDotColor) are now derived from the app's theme (primaryColorandunselectedWidgetColor) instead of hardcoded values. This may affect existing implementations that relied on the previous default colors. - Add
SmoothPageIndicatorTheme- aThemeExtensionthat allows configuring default effect and colors app-wide - Add
DefaultIndicatorColorsclass for managing indicator color defaults
- Breaking: Default colors (
-
1.2.123 Feb 2025 -
1.2.011 Jul 2024 -
1.2.0+120 Jul 2024Nothing published for this version
-
1.2.0+220 Jul 2024Nothing published for this version
-
1.2.0+320 Jul 2024Nothing published for this version
-
1.1.017 Apr 2023Nothing published for this version
-
1.0.112 Feb 2023Nothing published for this version
-
1.0.028 Aug 2021Release notes
Open source →- Fix ignored active dot stroke in ColorTransitionEffect #40
- Fix crash when last item is removed #21
- Add loop support
- Add variants to SwapEffect (zRotation, YRotation)
- Add variants to WormEffect (thin worm)
- Rename [elevation] property from JumpingDotEffect [Breaking]
- Add customization params to JumpingDotEffect (jumpScale, verticalOffset)
- Add CustomizableEffect
-
1.0.0+128 Aug 2021Nothing published for this version
-
1.0.0+228 Aug 2021Nothing published for this version
-
0.3.0-nullsafety.028 Feb 2021 pre-releaseNothing published for this version
-
0.2.324 Mar 2021Nothing published for this version
-
0.2.224 Mar 2021Nothing published for this version
-
0.2.128 Feb 2021Nothing published for this version
-
0.2.024 Jul 2020Nothing published for this version
-
0.1.516 Mar 2020 -
0.1.401 Mar 2020 -
0.1.315 Jan 2020 -
0.1.211 Jan 2020Nothing published for this version
-
0.1.2+114 Jan 2020Nothing published for this version
-
0.1.104 Jan 2020 -
0.1.003 Jan 2020Nothing published for this version
-
0.1.0+103 Jan 2020Nothing published for this version