pub.dev · #1675 most downloaded on pub.dev

flutter_carousel_widget

4.0.143K downloads/monixrajput/flutter_carousel_widget ↗New releases in your daily digest, changelog included.

A carousel for Flutter with ten composable effects, autoplay, indicators, content-sized pages, keyboard navigation and screen-reader support, on widgets.dart alone.

Last release 8 days ago
29 Sep 2026
Ships unpredictably
gaps range from 3 weeks to 1.7 years
Nearly every release is documented
notes for 35 of 35 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
35 releases · first in 2021

Release timeline

35 releases since 2021

202120222023

Releases

4.0.129 Sept 2026
fix: 4.0.1 tap targets, looping, docs and demo by @nixrajput in #75
What's Changed

fix: 4.0.1 tap targets, looping, docs and demo by @nixrajput in #75

Full Changelog: v4.0.0...v4.0.1
Open source →
Additional notes
Docs: the README has its Contributors section back, with a contributors badge, and its Contributing section points to Issues, Discussions and SECURITY.md.

Docs: links to MIGRATION.md, CONTRIBUTING.md and the other repository files are absolute, so they work on pub.dev, which drops relative ones.

Fixed: indicator dots were 20 by 12 pixel tap targets. Each is now one spacing wide and 48 pixels tall, growing towards the items so none of it falls off the carousel, and the default spacing is 24 pixels, the smallest target WCAG 2.2 allows. Pass SlideIndicatorStyle(spacing: 20) for the 4.0.0 look.

Fixed: turning infinite on or off moved the carousel to another item, because PageView reported a page clamped to the old extent; it now keeps the current item and reports no change.

Chore: the pubspec homepage is the live demo, and CI now requires 100% line coverage.

Example: the demo is redesigned for every screen, from a 320-pixel phone to an ultrawide: the preview never scrolls away, the options sit in collapsible cards that summarise their values while closed, and wide screens give the options a panel of their own. The controller's buttons move under the preview they drive.

One column per quarter.

4.0.029 Sept 2026

feat!: rebuild the carousel as 4.0.0 by @nixrajput in #70

What's Changed

feat!: rebuild the carousel as 4.0.0 by @nixrajput in #70
Release v4.0.0 (2/4): repo setup, CI and the new example by @nixrajput in #71
Release v4.0.0 (3/4): Android, iOS and web shells by @nixrajput in #72
Release v4.0.0 (4/4): desktop shells and all-platform CI by @nixrajput in #73

Full Changelog: v3.1.1...v4.0.0

Open source →

Additional notes

A rewrite on Flutter 3.47 and widgets.dart alone. MIGRATION.md maps every 3.x symbol.

Breaking: Flutter 3.47 or newer (Dart ^3.13.0); no Material import, so a Cupertino or plain WidgetsApp no longer pulls Material in through this package.
Breaking: constructor parameters replace FlutterCarouselOptions and ExpandableCarouselOptions; one FlutterCarouselController drives both widgets, and its methods return futures.
Added: ten composable effects (enlarge, fade, parallax, depth, zoomOut, stack, coverflow, cube, flip, rotate) and CarouselEffect.builder (#26).
Added: autoplay with per-item intervals, pausing on touch, hover, focus, a covered route, the background, offstage tabs and reduced motion; stopAutoPlay stays stopped.
Added: keyboard navigation, screen-reader semantics and announcements; tappable, labelled indicator dots (#31).
Added: CarouselEdgeAlignment.flush for flush first and last items with centred middle ones (#58).
Added: index, position and change notifications on the controller (#39).
Fixed: keyed items keep their state when the list changes, and keepAlive keeps scrolled-away pages (#16, #65).
Fixed: the controller detaches on dispose instead of crashing (#59); no PageController leaks on rebuild.
Fixed: the indicator follows the drag without lag (#62) and mirrors under RTL (#66).
Fixed: ExpandableCarousel keeps item heights when items are added (#60), reaches the last item's height with padEnds: false (#48), and lets small images fill the page (#29).
Fixed: enlarge scales once, autoplay never runs to page -1 in reverse, trackpads drag, and a finite carousel no longer animates a wrap on its last dot.

Open source →

3.1.12 Jul 2026

Fixes last item size when ExpandableCarousel has no padsEnds by @Zigotote in #61

What's Changed

Fixes last item size when ExpandableCarousel has no padsEnds by @Zigotote in #61
ci: standardize CI, release, and security workflows by @nixrajput in #68
ci: automated pub.dev release pipeline by @nixrajput in #69

New Contributors

@Zigotote made their first contribution in #61

Full Changelog: v3.1.0...v3.1.1

Open source →

Additional notes

Chore: Added automated pub.dev release pipeline (version check, tag, publish) via GitHub Actions.

Open source →

Additional notes

v3.1.1 Latest

Latest

Compare

Choose a tag to compare

Open source →

3.1.013 Oct 2024Security2 sources agree

Security : Added SECURITY.md for vulnerability reporting and security best practices.

What's Changed

bumped to version 3.1.0 by @nixrajput in #57
Security: Added SECURITY.md for vulnerability reporting and security best practices.
Enhancement: Added a Pull Request template to ensure thorough checks for new contributions.
Fix: issue #56 fixed.
Fix: issue #55 fixed.

New Contributors

@nixrajput made their first contribution in #57

Full Changelog: v3.0.1...v3.1.0

Open source →

Additional notes

v3.1.0

Compare

Choose a tag to compare

Open source →

3.0.110 Sept 20242 sources agree

Improvement : Added comments to the classes, controllers, states, options, enums, and indicators.

What's Changed

Improvement: Added comments to the classes, controllers, states, options, enums, and indicators.
Improvement: Formatted the code to pass static analysis.
Documentation: Removed demo gif to reduce package size.

Full Changelog: v3.0.0...v3.0.1

Open source →

Additional notes

v3.0.1

Compare

Choose a tag to compare

Open source →

3.0.08 Sept 2024Breaking2 sources agree

Breaking Change : New FlutterCarouselOptions introduced for FlutterCarousel .

What's Changed

Breaking Change: New FlutterCarouselOptions introduced for FlutterCarousel.
Breaking Change: New FlutterCarouselController introduced for FlutterCarousel.
Breaking Change: New FlutterCarouselState introduced for FlutterCarousel.
Breaking Change: New ExpandableCarouselOptions introduced for ExpandableCarousel.
Breaking Change: New ExpandableCarouselController introduced for ExpandableCarousel.
Breaking Change: New ExpandableCarouselState introduced for ExpandableCarousel.
Documentation: Updated the documentation to include breaking changes.
Fix: issue #52 fixed.
Fix: issue #51 fixed.
Fix: issue #50 fixed.
Fix: issue #48 fixed.
Fix: issue #38 fixed.
Fix: issue #37 fixed.
Improvement: Performance improvements.

Full Changelog: v2.3.0...v3.0.0

Open source →

Additional notes

v3.0.0

Compare

Choose a tag to compare

Open source →

2.3.023 Jul 2024Breaking2 sources agree

Breaking Change : New ExpandableCarouselOptions introduced for ExpandableCarousel .

What's Changed

Breaking Change: New ExpandableCarouselOptions introduced for ExpandableCarousel.
Breaking Change: New ExpandableCarouselController introduced for ExpandableCarousel.
Breaking Change: New ExpandableCarouselState introduced for ExpandableCarousel.
Breaking Change: All slide indicator properties have been consolidated into the SlideIndicatorOptions class.
Enhancement: issue #44 Added optional halo effect for slide indicators, customizable via SlideIndicatorOptions properties (enableHalo, haloPadding, haloDecoration).
Chore: Removed dead code.
Fix: issue #46 fixed.
Fix: issue #44 fixed.
Fix: issue #40 fixed.
Hide CarouselController from 'material.dart' import by @InstantlyMoist in #43
Add feature: customizable halo for prebuilt indicators by @ProV1X in #45

New Contributors

@InstantlyMoist made their first contribution in #43
@ProV1X made their first contribution in #45

Full Changelog: v2.2.0...v2.3.0

Open source →

Additional notes

v2.3.0

Compare

Choose a tag to compare

Open source →

2.2.07 Dec 20232 sources agree

New Feature : Support for custom slide indicators added.

New Feature: Support for custom slide indicators added.
Documentation: Updated the documentation to show all contributors.
Documentation: Updated the documentation to demonstrate the use of custom slide indicator.
Fix: issue #28 fixed.
Fix: issue #30 fixed.
Improvement: Performance improvements.
Optimization: Removed unnecessary codes.

What's Changed

export SequentialFillIndicator by @DjordjeMancic97 in #34
Expose and document SlideIndicator contract by @DDavidPrime in #36

New Contributors

@DjordjeMancic97 made their first contribution in #34
@DDavidPrime made their first contribution in #36

Full Changelog: v2.1.2...v2.2.0

Open source →

Additional notes

v2.2.0

Compare

Choose a tag to compare

Open source →

2.1.219 Oct 20232 sources agree

Documentation : Updated the documentation to display the screenshots.

2.1.2

Documentation: Updated the documentation to display the screenshots.

Full Changelog: v2.1.0...v2.1.2

Open source →

Additional notes

v2.1.2

Compare

Choose a tag to compare

Open source →

2.1.119 Oct 2023

Documentation: Updated the documentation to display the screenshots.

Documentation: Updated the documentation to display the screenshots.

Open source →

2.1.012 Aug 2023

Fix : issue #27 LICENSE updated to MIT.

2.1.0

Fix: issue #27 LICENSE updated to MIT.
Fix: issue #24 fixed.
Fix: issue #22 fixed.
Fix: issue #20 fixed.
Fix: issue #17 fixed.
Fixed(?) a bunch of documentation comments that appear to be missing a '/' by @TDuffinNTU in #23

New Contributors

@TDuffinNTU made their first contribution in #23

Full Changelog: v2.0.4...v2.1.0

Open source →

Additional notes

Fix: issue #27 LICENSE updated to MIT.
Fix: issue #24 fixed.
Fix: issue #22 fixed.
Fix: issue #20 fixed.
Fix: issue #17 fixed.
Improvement: Performance improvements.

Open source →

Additional notes

v2.1.0

Compare

Choose a tag to compare

Open source →

2.0.411 Jun 2023

Improvement : Removed unnecessary dependencies.

Changelog

2.0.4

Improvement: Removed unnecessary dependencies.
Fix: All known bugs fixed and removed.
Improvement: Performance improvements.
Optimization: Removed unnecessary codes.

What's Changed

Fixed incorrect carouselController named param in the documentation. by @MatthewJones517 in #19

New Contributors

@MatthewJones517 made their first contribution in #19

Full Changelog: v2.0.2...v2.0.4

Open source →

Additional notes

Optimization: Removed unnecessary codes.

Open source →

Additional notes

v2.0.4

Compare

Choose a tag to compare

Open source →

2.0.311 Jun 2023

Improvement: Removed unnecessary dependencies.

Improvement: Removed unnecessary dependencies.
Fix: All known bug fixed and removed.
Improvement: Performance improvements.
Optimization: Removed unnecessary codes.

Open source →

2.0.21 Feb 2023Breaking2 sources agree

Breaking Change : scrollPhysics is now physics in CarouselOptions .

Changelog

2.0.2

Add: indicatorMargin property added to CarouselOptions.
Improvement: Removed unnecessary dependencies.
Fix: All known bug fixed and removed.
Improvement: Performance improvements.
Optimization: Removed unnecessary codes.

2.0.1

Documentation: Updated the documentation to reflect the new Github Pages deployment
Fix: All known bug fixed and removed.

2.0.0+1

Fix: Enums are now exported.
New Feature: ExpandableCarousel widget added.
Breaking Change: scrollPhysics is now physics in CarouselOptions.
Breaking Change: carouselController is now controller in CarouselOptions.
Breaking Change: Project architecture changed.
Fix: All known bug fixed and removed.
Improvement: Performance improvements.
Optimization: Removed unnecessary codes.

2.0.0

New Feature: ExpandableCarousel widget added.
Breaking Change: scrollPhysics is now physics in CarouselOptions.
Breaking Change: carouselController is now controller in CarouselOptions.
Breaking Change: Project architecture changed.
Fix: All known bug fixed and removed.
Improvement: Performance improvements.
Optimization: Removed unnecessary codes.

1.2.3

Fix: bug auto play carousel is not working.
All known bug fixed and removed.
Performance improvements.
Removed unnecessary codes.

1.2.2

Fix: issue #7 bug show indicator when no custom CarouselController is set and showIndicator is set to true and onPageChanged is called.
Custom CarouselController can be set via CarouselOptions property.
All known bugs are fixed.
Performance improvements.

1.2.1

Github Actions: Web Demo is now deployed to Github Pages
Documentation: Updated the documentation to reflect the new Github Pages deployment

1.2.0

Project structure changed.
Minor bug fixes.
Removed unnecessary codes.

1.1.0

Minor bug fixes.
Performance improvements.

1.0.5

Minor bug fixes.
Performance improvements.

1.0.4

Minor bug fixes.
Performance improvements.

1.0.3

Minor bug fixes.
Performance improvements.

1.0.2

Option to float Slide Indicator over Carousel or to show below Carousel added.
Screenshots updated.
Source code optimised.
Performance improvements.

1.0.1

Web app example demo added.
Indicator color will change according to System theme.
Screenshots updated.
Documentation updated.
Source code optimised.
Performance improvements.

1.0.0

Source code optimised.
Bug fixes.
Performance improvements.
Documentation updated.

0.1.5

Default Slide Indicator added.
Bug fixes.
Performance improvements.

0.1.4

Bug fixes.
Documentation updated.

0.1.3

Minor bug fixes.

0.1.2

Auto-sized child support.
Bug fixes.

0.1.1

Bug fixes.
Documentation updated.

0.1.0

Pre-built Carousel indicator support added.
Bug fixes.
Documentation updated.

0.0.1

Initial Version.

Open source →

Additional notes

v2.0.2

Compare

Choose a tag to compare

Open source →

2.0.111 Jan 20232 sources agree

Documentation: Updated the documentation to reflect the new Github Pages deployment.

Documentation: Updated the documentation to reflect the new Github Pages deployment.
Fix: All known bug fixed and removed.

Open source →

2.0.015 Dec 2022Breaking2 sources agree

Breaking Change: scrollPhysics is now physics in CarouselOptions.

New Feature: ExpandableCarousel widget added.
Breaking Change: scrollPhysics is now physics in CarouselOptions.
Breaking Change: carouselController is now controller in CarouselOptions.
Breaking Change: Project architecture changed.
Fix: All known bug fixed and removed.
Improvement: Performance improvements.
Optimization: Removed unnecessary codes.

Open source →

2.0.0+116 Dec 2022Breaking2 sources agree

Breaking Change: scrollPhysics is now physics in CarouselOptions.

Fix: Enums are now exported.
New Feature: ExpandableCarousel widget added.
Breaking Change: scrollPhysics is now physics in CarouselOptions.
Breaking Change: carouselController is now controller in CarouselOptions.
Breaking Change: Project architecture changed.
Fix: All known bug fixed and removed.
Improvement: Performance improvements.
Optimization: Removed unnecessary codes.

Open source →

1.2.324 Nov 20222 sources agree

Fix: bug auto play carousel is not working.

Fix: bug auto play carousel is not working.
All known bug fixed and removed.
Performance improvements.
Removed unnecessary codes.

Open source →

1.2.218 Nov 20222 sources agree

Fix: issue #7 bug show indicator when no custom CarouselController is set and showIndicator is set to true and onPageChanged is called.

Fix: issue #7 bug show indicator when no custom CarouselController is set and showIndicator is set to true and onPageChanged is called.
Custom CarouselController can be set via CarouselOptions property.
All known bugs are fixed.
Performance improvements.