flutter_calendar_carousel 3.0.0

An accessible, theme-aware Flutter calendar with lazy month and week paging, controlled dates, and typed event builders.

[Unreleased]

3.0.0 - 2026-08-09

Breaking changes

• Redesign the public API around controlled selectedDate and focusedDate values, onDateSelected, onDateLongPressed, and onPageChanged callbacks.
• Replace the 2.x boolean view selector with CalendarCarousel.month, CalendarCarousel.week, and the explicit CalendarView enum.
• Remove the package-owned event and marked-date models, adapter interfaces, mutable event index, positional day builder, and their deep-import files. Applications now provide their own model through eventsForDate.
• Group header, weekday, layout, paging, theme, day-style, and marker options into focused immutable configuration objects. Calendar size is now controlled exclusively by parent constraints, and pages always snap.
• Replace date lists and integer weekday indexes with isDateEnabled, Flutter Locale, and the CalendarWeekday enum. The default range now spans 100 years before and after today.

Added and changed

• Unify month and week navigation on a lazy, date-only pager that handles every first-day-of-week value, year boundaries, range updates, and runtime view changes consistently.
• Add named day, marker, date-style, header, and weekday builders with immutable details objects and Material-theme-aware defaults.
• Limit the built-in event marker to a configured number of visible dots plus one bounded overflow label; custom marker builders run once per marked day.
• Fix controlled selection updates, duplicate page-change callbacks, external focus navigation, date-picker lifecycle and locale fallback, and day semantics.
• Make rapid header navigation, vertical paging, far date-picker jumps, narrow and wide layouts, large text, RTL ordering, and event overflow badges deterministic and regression-tested.
• Preserve complete day grids under constrained heights and vertical page previews, keep hit targets at full-cell size, expose read-only dates as labels, and add customizable event-count semantics with selected-marker contrast.
• Keep week views complete when month-only outside-date filtering is enabled, and derive today, selection, weekend, and month flags from each cell's date.
• Replace date-dependent tests and the previous example with deterministic month/week regression coverage and a concise Material 3 demo.
• Refresh and commit the example lockfile during automated version bumps to prevent recurring release drift (#409).
• Provision pub.dev OIDC credentials in the publish workflow so tagged releases do not wait for interactive authentication (#403).
• Update the example to intl 0.20.3, current Android build tooling, iOS 13/UIScene, and Flutter Swift Package Manager integration.
• Add regression coverage for disabled-date predicates and page navigation, and build the Android example in CI.
• Synchronize Codex and Claude repository workflows around shared issue, verification, commit, rebase, self-review, and five-minute PR review procedures.
• Document the autonomous maintenance runbooks, PR review loop, and deployment workflow expectations (#402).

2.6.11 - 2026-08-08

• fix(maintenance): support current Flutter and release flows (#424)

2.6.10 - 2026-07-27

• chore: sync example lockfile version (#423)

2.6.9 - 2026-07-20

• chore: sync example lockfile version (#422)

2.6.8 - 2026-07-13

• chore: sync example lockfile version (#421)

2.6.7 - 2026-07-06

• chore: sync example lockfile version (#418)

2.6.6 - 2026-06-29

• chore: sync example lockfile version (#417)

2.6.5 - 2026-06-22

• chore: sync example lockfile version (#416)
• chore: sync example lockfile version (#415)

2.6.4 - 2026-06-15

• chore: sync example lockfile version (#413)

2.6.3 - 2026-06-08

• chore: sync example lockfile version (#412)
• ci: run checks for dependency lockfiles (#408)

2.6.2 - 2026-06-01

• chore(deps): weekly lock refresh (#406)

2.6.1 - 2026-05-25

• chore(deps): bump example dependencies (#405)

2.6.0 - 2026-05-13

• docs: add autonomous maintenance runbooks
• feat: support inactive dates
• feat: support uppercase weekday labels

2.5.7 - 2026-04-27

• chore(ci): remove one-shot format/apply-fix workflows

2.5.6 - 2026-04-23

• style: apply dart fix and remove unreachable default
• ci: add one-shot workflow to apply dart fix
• style: apply dart format
• ci: add one-shot workflow to apply dart format
• fix(ci): correct YAML syntax in auto-release skip step
• ci: wire up CI, release, and publish workflows

2.5.5

• Bump flutter_lints to ^6.0.0 and raise Dart SDK floor to ^3.8.0 (#401)

2.5.4

• Update intl version #397

2.5.3

• Add ability to configure day border radius by setting daysBorderRadius (#391)

2.5.1

• Replace bare Function types with typedefs (#393)
• Add ability to configure day border radius by setting daysBorderRadius (#391)
• Fix PR links in 2.5.0's changelog not being clickable (#390)
• Fix inactive (disabled) days being clickable (#389)
• Don't invoke animateToPage when page was scrolled manually (#388)

2.5.0

• Add linter and code formatting (#386)
• Upgrade dependencies and integrate linter (#384)
• Support Xcode 16 for iOS (#385)
• Migrate Gradle to use declarative plugins block in Android example (#383)

2.4.4

Upgrade intl to ^0.19.0

2.4.3

Upgrade intl to ^0.18.1

2.4.2

Support Flutter version 3+

2.4.1

Update iOS podspec and info.plist

2.1.0

Update build config on flutter V2 embedding (#293)

2.0.3

Multiple days selection using addRange method #285

2.0.2

Multiple days selection #282

2.0.1

Null safety improvements #272

[2.0.1]

Added disableDayPressed option #267

2.0.0

Support null-safety #260

1.5.3

• Add id to event model #257

1.5.2

• Bump up intl dependency #254

1.5.1

• Bugfix when switching month - "The method 'call' was called on null." #243

1.5.0

• Add key to widget constructor #234
• Enhance initilizing page numbers #231

1.4.12

• Handle issue #207, #209

1.4.11

• Add first day of week offset to week builder #204

1.4.10

• Fix Calendar displays incorrectly when scrolling horizontally #193

1.4.9

• Target date for custom header

1.4.8

• Add ability to set targetDate on header #183.

1.4.7

• Fix current day showing incorrectly when using showOnlyCurrentMonthDate #181.

1.4.6

• Set default minSelectedDate and maxSelectedDate #179.

1.4.4

• Expose pageScrollPhysics for pageView.

1.4.2

• Add option for setting scrollDirection #166
• Resolve #123 in #165.

1.4.1

• Resolve #164.

1.4.0

• Resolve #154.

1.3.29

• Resolve #157.

1.3.28

• Allow the use of generic type with Interface #149
• Added doc to custom weekday builder. Weekday number is now supplied to the builder #150

1.3.27

• customDayBuilder fix.
• Remove date_utils dep.

1.3.26

• Support custom day container feature #145.

1.3.23

• Support intl >= 0.15.7 < 0.17.0 to inclease pub health
• Removed deprecated methods markedDates, markedDateColor
• Fixes #101
• Fixes #104
• Fixes #112
• Fixes #119
• Support long pressed as a feature request#103
• Support semantic label as a feature request #139
• Expose dayCrossAxisAlignment and dayMainAxisAlignment to resolve #122
• Expose showIconBehindDayText to resolve #131
• Fixes #94

1.3.20

• Support intl >= 0.15.7

1.3.19

• Improved customizability for weekday containers #141

1.3.18

• Fix vertical scroll behavior for weekFormat calendar view.
• Reformat code with dartfmt

1.3.17

• Added feature to only show dates from today adding showOnlyCurrentMonthDate parameter.

1.3.16

• Added feature for change first day of the week.

[1.3.15+]

• Ability to disable horizontal scroll to change month with isScrollable param.
  • Resolve #74
• Show events in week calendar.
  • Resolve #66
• Update breaking docs in pub.
• Expose event list to user.
• Remove print.
• Pass first date of week to onCalendarChanged in week view #88
• Support for passing in custom widgets for next and previous month arrow icons #95

1.3.14

• Code refactoring #77
  • Seperate weekday widget

1.3.13

• Code refactoring #73
  • Seperate header.
  • Add first basic test code.
  • Add composable header widget

1.3.12

• Setting dot icon per event #71

1.3.11

• Fixed selectledDayTextStyle property not being respected #65.

1.3.10

• Add property for static six week format to keep calendar height consistent between months #62.

1.3.9

• Changed priority for today higher than prevMonth and nextMonth and thisMonth.

1.3.7

• Ability to choose the weekday format on the constructor #47.

1.3.6

• custom event type added #49.

1.3.5

• headerTitleTouchable and onHeaderTitlePressed props added #44.

1.3.4

• Bug fix. PrevDaysTextStyle and PrevDaysTextStyle overwrite weekendTextStyle #41.

1.3.3

• Fixed FlatButton fill and border color. #37
• EventList bug fixing. #37

1.3.2

• Mapping events for better performance. #34.

1.3.1

• weekdays bug fix.

1.3.0

• Better localization support for weekDays. Setting manually weekdays isn't required now. Related #23.
• Add custom icons in event #28.

1.2.3

• Add custom physics parameter. Feature in #21.

1.2.2

• headerTextStyle fix#17.
• Can show or hide header button with showHeaderButton attribute.

1.2.1

• Week-format shows current week #15.

1.2.0

• Support carousel week calendar.

1.1.11

• Ability to customize weekend days #13.

1.1.10

• Support weekFormat but without carousel.

1.1.9

• Updated readme.

1.1.8

• Render multiple marked dates.
• markedDates is deprecated. Use markedDatesMap instead.

1.1.3

• Mark dates with non-zero times.

1.1.2

• Implemented a way to change the header text style.

1.1.1

• Expose new variables.
  • headerMargin, childAspectRatio, weekDayMargin

1.1.0

• Give proper text color in weekend when it is today.
• Compare month and year for marking today's date. Resolve #3.

1.0.3

• Fixed pub broken image.

1.0.2

• Use Position widget to mark the dates.

1.0.1

• Show markedDates.

0.2.0

• Customizable headerWidget.
• Setting weekdays visibility
• Customizable weekend color.

0.1.3

• Rename the top-level "docs" directory to "doc".

0.1.1

• Added readme.

0.1.0

• First release