• 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.flutter-io.cn, 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.

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.

• Chore: Added automated pub.flutter-io.cn release pipeline (version check, tag, publish) via GitHub Actions.

• 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.

• 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.

• 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.

• 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.

• 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.

• Documentation: Updated the documentation to display the screenshots.

• Documentation: Updated the documentation to display the screenshots.

• 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.

• Optimization: Removed unnecessary codes.

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

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

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

• 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.

• 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.

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

• 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.

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

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

• Minor bug fixes.
• Performance improvements.

• Minor bug fixes.
• Performance improvements.

• Minor bug fixes.
• Performance improvements.

• Minor bug fixes.
• Performance improvements.

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

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

• Source code optimized.
• Bug fixes.
• Performance improvements.
• Documentation updated.

• Default Slide Indicator added.
• Bug fixes.
• Performance improvements.

• Bug fixes.
• Documentation updated.

• Minor bug fixes.

• Auto-sized child support.
• Bug fixes.

• Bug fixes.
• Documentation updated.

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

• Initial Version.