Skip to content
CAI
Software that uses CAICheck a score

aleksanderwozniak/table_calendar

60.5

Adequate · 17 November 2026

2.9k

lines of production code

Dart

primary language

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

This system is a Flutter library providing a highly customizable TableCalendar widget for displaying and interacting with calendar data. It supports multiple view formats, gesture-based navigation, and range selection, while offering granular control over styling and behavior through a modular builder API. The package includes comprehensive documentation, platform-specific UI adaptations, and accessibility features to facilitate integration into mobile and web applications.

How it got here

2019 — Flutter V2 migration and API restructuring

10 changes.

The project underwent a comprehensive overhaul to align with modern Flutter standards, migrating the Android and iOS example apps to the V2 embedding, Kotlin, and Swift. The core library was refactored from a monolithic structure into a modular architecture, exposing a granular customization API for builders and styles while improving accessibility and platform-aware UI elements.

2021 — Initial TableCalendar release

4 changes.

This period marks the initial release of the TableCalendar widget, introducing core components, shared utility types, and comprehensive test coverage. The work established the foundational calendar logic, including support for multiple formats, gesture navigation, and range selection, while updating example applications to align with the new API.

Features

Initial release of the TableCalendar widget

This change introduces the core \TableCalendar\ widget and its underlying \TableCalendarBase\ component to the library. The new widget provides a highly customizable calendar interface supporting multiple formats (month, week, two weeks), gesture-based navigation, and range selection. Key features include configurable animations for page transitions and format changes, customizable styling for headers, days of the week, and calendar cells, and support for event loading and day predicates. The implementation also includes accessibility improvements such as screen reader semantics and configurable hit test behaviors.

lib/src · high confidence

Introduces comprehensive calendar customization via builders and style classes

The \lib/src/customization\ area now provides a structured API for customizing the \TableCalendar\ appearance and behavior. \CalendarBuilders\ allows users to supply custom widgets for specific day states (today, selected, range start/end, holidays, etc.), event markers, and header components. \CalendarStyle\ exposes granular control over cell decorations, text styles, marker positioning, and range highlights. Additionally, \HeaderStyle\ and \DaysOfWeekStyle\ enable customization of the header chevrons (including visibility and icon replacement), title formatting, and the days-of-week panel text and styling.

lib/src/customization · high confidence

New shared utility types and functions for calendar logic

A new \lib/src/shared/utils.dart\ file has been added, introducing core type definitions and helper functions used by the calendar component. This includes \DayBuilder\ and \FocusedDayBuilder\ function signatures for widget generation, \TextFormatter\ for localized date text, and enums for \AvailableGestures\, \CalendarFormat\, and \StartingDayOfWeek\. It also provides utility functions \getWeekdayNumber\, \normalizeDate\, and \isSameDay\ to handle date normalization and comparison, establishing the foundational shared logic for the calendar's behavior.

lib/src/shared · high confidence

Behavioural changes

Android example app upgraded to Flutter V2 embedding and modern build tools

The Android example app has been migrated to the Flutter V2 Android embedding, which requires updating the AndroidManifest.xml to declare the activity as exported and use the new NormalTheme, replacing the legacy FlutterApplication and splash-screen meta-data. The Java MainActivity has been replaced by a Kotlin implementation, and the Gradle wrapper has been upgraded from version 4.10.2 to 9.1.0. Additionally, Flutter Web support has been added to the example via new index.html and manifest.json files, enabling the app to run in browsers.

example/android · high confidence

Calendar widget library refactored with platform-aware UI and accessibility improvements

The calendar widget library has been refactored into a modular structure (CalendarCore, CalendarHeader, CalendarPage, CellContent) to improve maintainability and introduce several user-facing enhancements. Navigation chevrons and format buttons are now platform-aware, using CupertinoButton on iOS/macOS and InkWell elsewhere for native feel. Accessibility is improved with semantic labels for screen readers on day cells. Users can now customize the header title via a builder, view week numbers, and adjust cell padding, alignment, and table borders. A fix ensures the focused day is correctly maintained when navigating between pages.

lib/src/widgets · high confidence

Example app restructured with navigation and localization support

The example application has been reorganized to serve as a comprehensive showcase. A new start page replaces the previous single-view layout, providing navigation buttons to distinct examples including Basics, Range Selection, Events, Multiple Selection, and Complex scenarios. Additionally, the app now initializes date formatting via the intl package to ensure proper locale support, and utility functions for event handling and date range generation have been added to support these examples.

example/lib · high confidence

Refactor library structure and expose customization API

The library has been restructured to replace the internal \CalendarLogic\ class with a modular, export-based architecture. The public API now exposes specific customization components, including \calendar\_builders.dart\, \calendar\_style.dart\, \days\_of\_week\_style.dart\, and \header\_style.dart\, allowing users to customize the calendar's appearance and behavior. The previous monolithic implementation in \table\_calendar.dart\ has been split into separate source files under \src/\, providing a cleaner separation of concerns and enabling more granular control over the calendar's UI elements.

lib · high confidence

Removal of legacy GeneratedPluginRegistrant class

The legacy \GeneratedPluginRegistrant.java\ file has been removed from the Android application module. This change eliminates the manual plugin registration mechanism, aligning the project with modern Flutter plugin registration standards where plugins are registered automatically at runtime.

android · high confidence

Updated example application pages

The example application's demonstration pages (basics, complex, events, multi, and range) have been updated to reflect the current TableCalendar API. These changes include adopting the new \super.key\ syntax for stateful widgets, implementing proper disposal of \ValueNotifier\ instances, and adjusting event selection logic to align with the library's current behavior for single selection, multi-selection, and range modes.

example/lib/pages · high confidence

Updated example project configuration and documentation

The example app now includes an analysis options file that excludes build and platform directories and includes Flutter lints. The .gitignore has been streamlined to focus on Flutter/Dart, Web, and symbolication artifacts, removing older Android and iOS-specific exclusions. The project metadata indicates a switch to the Flutter beta channel, and the README has been rewritten to specifically demonstrate the Table Calendar package's styling and builder customization features.

example · high confidence

iOS example app upgraded to modern Xcode and Swift configuration

The iOS example app has been migrated from Objective-C to Swift, replacing the manual AppDelegate implementation with a modern setup using \FlutterImplicitEngineDelegate\ and a bridging header. The Xcode project file was upgraded to object version 54 (Xcode 15.1), updating the build scheme to use a custom LLDB init file and enabling GPU validation mode. Additionally, the app configuration now supports iOS 13+ scene lifecycle via \UIApplicationSceneManifest\, disables minimum frame duration on iPhone, supports indirect input events, and updates the app name to "table\_calendar example".

example/ios · high confidence

Test coverage

Added widget and unit tests for Table Calendar components

Added comprehensive widget tests for the calendar header, page, cell content, custom icon button, and format button, along with unit tests for shared utility functions. The new tests verify correct day layout, header visibility controls, format button behavior, and date normalization logic.

test · high confidence

Dependencies

Example app migrates to Kotlin DSL and Dart 3; package updates dependencies and targets Dart 3

The example app's Android build configuration has been migrated from Groovy to Kotlin DSL (build.gradle.kts), upgrading the Android Gradle plugin to 9.0.1, Kotlin to 2.3.20, and Java/Kotlin targets to version 17, while also increasing JVM memory arguments. On the Dart side, both the main package and the example app now require Dart SDK 3.0.0+, replacing the old date\_utils dependency with simple\_gesture\_detector (^0.2.0) and updating intl to \>=0.20.3 \<0.21.0, along with adding flutter\_lints ^6.0.0 for linting.

(dependencies) · high confidence

Housekeeping

Project initialization and documentation overhaul

The repository has been initialized with a new \analysis\_options.yaml\ configuration that includes Flutter lints and strict type checking, while the legacy \.iml\ module file has been removed. The project's \.gitignore\ has been significantly expanded to cover modern Flutter, Android, and iOS build artifacts, and the \.metadata\ file indicates a switch to the Flutter beta channel. Additionally, the \README.md\ has been completely rewritten to provide comprehensive usage instructions, examples, and API documentation for the TableCalendar widget, and the license has been updated to Apache 2.0.

(repo-wide) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 56.8 → 60.5 (+3.7)
  • Rubric changed (rubric-2026.11.2 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 95.5 → 90.6 (-4.9)
  • Architecture 100.0 → 100.0 (0.0)
  • Maturity 54.4 → 57.9 (+3.5)
  • Readiness 35.3 → 42.6 (+7.3)
  • Security 100.0 → 100.0 (0.0)

Resolved (1)

  • Duplicated block (6 lines × 3) (lib/src/table_calendar.dart)

New (9)

  • Duplicated block (6 lines × 3) (lib/src/table_calendar.dart)
  • Edited copy of a member (10 corresponding lines) (lib/src/table_calendar_base.dart)
  • Edited copy of a member (13 corresponding lines) (example/lib/pages/complex_example.dart)
  • Edited copy of a member (17 corresponding lines) (example/lib/pages/complex_example.dart)
  • Edited copy of a member (19 corresponding lines) (lib/src/table_calendar_base.dart)
  • Edited copy of a member (28 corresponding lines) (lib/src/widgets/calendar_core.dart)
  • Edited copy of a member (4 corresponding lines) (example/lib/pages/complex_example.dart)
  • Edited copy of a member (5 corresponding lines) (example/lib/pages/complex_example.dart)
  • Edited copy of a member (67 corresponding lines) (example/lib/pages/events_example.dart)

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

aleksanderwozniak/table_calendar was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 17 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 514bbb87fba154fea69d04576ab8be4a093b03bf — the exact code this score is about.
  • Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.85+preprod-eba6548ac50f.