Kalender

https://github.com/werner-scholtz/kalender
Admin
Kalender is a Flutter calendar widget package providing four views: MultiDay (day/week), Month,...
Tokens:45,099
Snippets:447
Trust Score:6.9
License:MIT
Update:2 months ago
Show doc for...
Tokens:
Raw
### Basic CMake Project Setup

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/example/linux/CMakeLists.txt

Initializes CMake version and project name. Sets the executable and application ID. Configures installation paths and build policies.

```cmake
cmake_minimum_required(VERSION 3.10)
project(runner LANGUAGES CXX)

set(BINARY_NAME "example")
set(APPLICATION_ID "com.example.example")

cmake_policy(SET CMP0063 NEW)
set(CMAKE_INSTALL_RPATH "$ORIGIN/lib")
```

--------------------------------

### Installation: Bundle Setup and Cleanup

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/advanced_example/linux/CMakeLists.txt

Configures the installation prefix to create a relocatable bundle and ensures the build bundle directory is clean before installation.

```cmake
set(BUILD_BUNDLE_DIR "${PROJECT_BINARY_DIR}/bundle")
if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
  set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE)
endif()

install(CODE "
  file(REMOVE_RECURSE \"${BUILD_BUNDLE_DIR}/\")
  " COMPONENT Runtime)
```

--------------------------------

### Installation Configuration

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/testing/linux/CMakeLists.txt

Sets up the installation process, defining the bundle directory and ensuring a clean installation by removing previous contents.

```cmake
set(BUILD_BUNDLE_DIR "${PROJECT_BINARY_DIR}/bundle")
if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
  set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE)
endif()

install(CODE "
  file(REMOVE_RECURSE \"${BUILD_BUNDLE_DIR}/\")
  " COMPONENT Runtime)

set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data")
set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}/lib")
```

--------------------------------

### Basic CMake Project Setup

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/web_demo/linux/CMakeLists.txt

Initializes CMake, sets the project name, and specifies the programming language. This is a standard starting point for any CMake project.

```cmake
cmake_minimum_required(VERSION 3.10)
project(runner LANGUAGES CXX)
```

--------------------------------

### Installation Rules for Runtime Components

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/web_demo/windows/CMakeLists.txt

Configures the installation process to copy the executable, data files, libraries, and native assets to the specified installation prefix. This ensures the application can run correctly after installation.

```cmake
# === Installation ===
# Support files are copied into place next to the executable, so that it can
# run in place. This is done instead of making a separate bundle (as on Linux)
# so that building and running from within Visual Studio will work.
set(BUILD_BUNDLE_DIR "$<TARGET_FILE_DIR:${BINARY_NAME}>")
# Make the "install" step default, as it's required to run.
set(CMAKE_VS_INCLUDE_INSTALL_TO_DEFAULT_BUILD 1)
if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
  set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE)
endif()

set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data")
set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}")

install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
  COMPONENT Runtime)

if(PLUGIN_BUNDLED_LIBRARIES)
  install(FILES "${PLUGIN_BUNDLED_LIBRARIES}"
    DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
    COMPONENT Runtime)
endif()

# Copy the native assets provided by the build.dart from all packages.
set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/windows/")
install(DIRECTORY "${NATIVE_ASSETS_DIR}"
   DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
   COMPONENT Runtime)

# Fully re-copy the assets directory on each build to avoid having stale files
# from a previous install.
set(FLUTTER_ASSET_DIR_NAME "flutter_assets")
install(CODE "
  file(REMOVE_RECURSE \"${INSTALL_BUNDLE_DATA_DIR}/${FLUTTER_ASSET_DIR_NAME}\")
  " COMPONENT Runtime)
install(DIRECTORY "${PROJECT_BUILD_DIR}/${FLUTTER_ASSET_DIR_NAME}"
  DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" COMPONENT Runtime)

# Install the AOT library on non-Debug builds only.
install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
  CONFIGURATIONS Profile;Release
  COMPONENT Runtime)
```

--------------------------------

### Run a Kalender Example

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/README.md

Commands to navigate to an example directory and launch the Flutter application.

```sh
cd example
flutter run
```

--------------------------------

### Installation Rules

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/ics/windows/CMakeLists.txt

Configures the installation of the executable, Flutter assets, and native libraries.

```cmake
set(BUILD_BUNDLE_DIR "$<TARGET_FILE_DIR:${BINARY_NAME}>")
# Make the "install" step default, as it's required to run.
set(CMAKE_VS_INCLUDE_INSTALL_TO_DEFAULT_BUILD 1)
if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
  set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE)
endif()

set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data")
set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}")

install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
  COMPONENT Runtime)

if(PLUGIN_BUNDLED_LIBRARIES)
  install(FILES "${PLUGIN_BUNDLED_LIBRARIES}"
    DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
    COMPONENT Runtime)
endif()

# Copy the native assets provided by the build.dart from all packages.
set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/windows/")
install(DIRECTORY "${NATIVE_ASSETS_DIR}"
   DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
   COMPONENT Runtime)

# Fully re-copy the assets directory on each build to avoid having stale files
# from a previous install.
set(FLUTTER_ASSET_DIR_NAME "flutter_assets")
install(CODE "
  file(REMOVE_RECURSE \"${INSTALL_BUNDLE_DATA_DIR}/${FLUTTER_ASSET_DIR_NAME}\")
  " COMPONENT Runtime)
install(DIRECTORY "${PROJECT_BUILD_DIR}/${FLUTTER_ASSET_DIR_NAME}"
  DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" COMPONENT Runtime)

# Install the AOT library on non-Debug builds only.
install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
  CONFIGURATIONS Profile;Release
  COMPONENT Runtime)
```

--------------------------------

### Installation Rules for Executable and Assets

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/advanced_example/windows/CMakeLists.txt

Configures the installation process, copying the executable, Flutter assets, ICU data, and plugin libraries to the specified installation prefix.

```cmake
set(BUILD_BUNDLE_DIR "$<TARGET_FILE_DIR:${BINARY_NAME}>")
set(CMAKE_VS_INCLUDE_INSTALL_TO_DEFAULT_BUILD 1)
if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
  set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE)
endif()

set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data")
set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}")

install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
  COMPONENT Runtime)

if(PLUGIN_BUNDLED_LIBRARIES)
  install(FILES "${PLUGIN_BUNDLED_LIBRARIES}"
    DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
    COMPONENT Runtime)
endif()

set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/windows/")
install(DIRECTORY "${NATIVE_ASSETS_DIR}"
   DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
   COMPONENT Runtime)

set(FLUTTER_ASSET_DIR_NAME "flutter_assets")
install(CODE "
  file(REMOVE_RECURSE \"${INSTALL_BUNDLE_DATA_DIR}/${FLUTTER_ASSET_DIR_NAME}\")
  " COMPONENT Runtime)
install(DIRECTORY "${PROJECT_BUILD_DIR}/${FLUTTER_ASSET_DIR_NAME}"
  DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" COMPONENT Runtime)

install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
  CONFIGURATIONS Profile;Release
  COMPONENT Runtime)
```

--------------------------------

### Installation and Bundling

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/ics/linux/CMakeLists.txt

Defines installation paths and rules for the application bundle, including assets and libraries.

```cmake
set(BUILD_BUNDLE_DIR "${PROJECT_BINARY_DIR}/bundle")
if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
  set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE)
endif()

# Start with a clean build bundle directory every time.
install(CODE "
  file(REMOVE_RECURSE \"${BUILD_BUNDLE_DIR}/\")
  " COMPONENT Runtime)

set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data")
set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}/lib")

install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
  COMPONENT Runtime)

foreach(bundled_library ${PLUGIN_BUNDLED_LIBRARIES})
  install(FILES "${bundled_library}"
    DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
    COMPONENT Runtime)
endforeach(bundled_library)

# Copy the native assets provided by the build.dart from all packages.
set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/linux/")
install(DIRECTORY "${NATIVE_ASSETS_DIR}"
   DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
   COMPONENT Runtime)

# Fully re-copy the assets directory on each build to avoid having stale files
# from a previous install.
set(FLUTTER_ASSET_DIR_NAME "flutter_assets")
install(CODE "
  file(REMOVE_RECURSE \"${INSTALL_BUNDLE_DATA_DIR}/${FLUTTER_ASSET_DIR_NAME}\")
  " COMPONENT Runtime)
install(DIRECTORY "${PROJECT_BUILD_DIR}/${FLUTTER_ASSET_DIR_NAME}"
  DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" COMPONENT Runtime)

# Install the AOT library on non-Debug builds only.
if(NOT CMAKE_BUILD_TYPE MATCHES "Debug")
  install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
    COMPONENT Runtime)
endif()
```

--------------------------------

### Run the advanced example

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/advanced_example/README.md

Execute the advanced example project using the Flutter CLI.

```sh
flutter run
```

--------------------------------

### Install Application Executable

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/example/windows/CMakeLists.txt

Installs the application's main executable to the runtime destination. This makes the application available for execution after installation.

```cmake
install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}"
  COMPONENT Runtime)
```

--------------------------------

### Installation Rules for Application Bundle

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/recurrence/linux/CMakeLists.txt

Defines how the application bundle is installed, including cleaning the build directory, installing the executable, data files, libraries, and native assets.

```cmake
# === Installation ===
# By default, "installing" just makes a relocatable bundle in the build
# directory.
set(BUILD_BUNDLE_DIR "${PROJECT_BINARY_DIR}/bundle")
if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
  set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE)
endif()

# Start with a clean build bundle directory every time.
install(CODE "
  file(REMOVE_RECURSE \"${BUILD_BUNDLE_DIR}/\")
  " COMPONENT Runtime)

set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data")
set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}/lib")

install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
  COMPONENT Runtime)

foreach(bundled_library ${PLUGIN_BUNDLED_LIBRARIES})
  install(FILES "${bundled_library}"
    DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
    COMPONENT Runtime)
endforeach(bundled_library)

# Copy the native assets provided by the build.dart from all packages.
set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/linux/")
install(DIRECTORY "${NATIVE_ASSETS_DIR}"
   DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
   COMPONENT Runtime)

# Fully re-copy the assets directory on each build to avoid having stale files
# from a previous install.
set(FLUTTER_ASSET_DIR_NAME "flutter_assets")
install(CODE "
  file(REMOVE_RECURSE \"${INSTALL_BUNDLE_DATA_DIR}/${FLUTTER_ASSET_DIR_NAME}\")
  " COMPONENT Runtime)
install(DIRECTORY "${PROJECT_BUILD_DIR}/${FLUTTER_ASSET_DIR_NAME}"
  DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" COMPONENT Runtime)

# Install the AOT library on non-Debug builds only.
if(NOT CMAKE_BUILD_TYPE MATCHES "Debug")
  install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
    COMPONENT Runtime)
endif()
```

--------------------------------

### Verify package examples

Source: https://github.com/werner-scholtz/kalender/blob/main/AGENTS.md

Command to run flutter analyze on all example directories to ensure breaking changes are caught.

```bash
for d in examples/*/; do (cd "$d" && flutter analyze); done
```

--------------------------------

### Install Application Targets and Files

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/testing/linux/CMakeLists.txt

Installs the main executable, ICU data, Flutter library, bundled plugin libraries, and native assets to their designated locations within the installation bundle.

```cmake
install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
  COMPONENT Runtime)

foreach(bundled_library ${PLUGIN_BUNDLED_LIBRARIES})
  install(FILES "${bundled_library}"
    DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
    COMPONENT Runtime)
endforeach(bundled_library)

set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/linux/")
install(DIRECTORY "${NATIVE_ASSETS_DIR}"
   DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
   COMPONENT Runtime)
```

--------------------------------

### Install dependencies

Source: https://github.com/werner-scholtz/kalender/blob/main/CONTRIBUTING.md

Run this command to fetch all required project dependencies.

```bash
flutter pub get
```

--------------------------------

### Installing Bundled Libraries

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/example/linux/CMakeLists.txt

Installs any bundled libraries required by plugins into the installation bundle's library directory.

```cmake
foreach(bundled_library ${PLUGIN_BUNDLED_LIBRARIES})
  install(FILES "${bundled_library}"
    DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
    COMPONENT Runtime)
endforeach(bundled_library)
```

--------------------------------

### Installing Application Target and Data

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/example/linux/CMakeLists.txt

Installs the application executable, ICU data, and Flutter library to their respective destinations within the installation bundle.

```cmake
set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data")
set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}/lib")

install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
  COMPONENT Runtime)
```

--------------------------------

### Installation: Core Components

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/advanced_example/linux/CMakeLists.txt

Installs the main executable, ICU data file, Flutter library, and bundled plugin libraries to their respective destinations within the application bundle.

```cmake
set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data")
set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}/lib")

install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
  COMPONENT Runtime)

foreach(bundled_library ${PLUGIN_BUNDLED_LIBRARIES})
  install(FILES "${bundled_library}"
    DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
    COMPONENT Runtime)
endforeach(bundled_library)
```

--------------------------------

### Install Flutter Library

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/example/windows/CMakeLists.txt

Installs the main Flutter library file to the root of the application bundle. This makes the core Flutter runtime available.

```cmake
install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
  COMPONENT Runtime)
```

--------------------------------

### Install Kalender Package

Source: https://github.com/werner-scholtz/kalender/blob/main/README.md

Add the core package to your Flutter project.

```bash
flutter pub add kalender
```

--------------------------------

### Web Demo Build and Run Commands

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/web_demo/AGENTS.md

Commands to get, analyze, test, run, and build the web_demo Flutter application. Ensure you are in the 'examples/web_demo' directory.

```bash
flutter pub get
flutter analyze
flutter test
flutter run -d chrome
flutter build web --release --wasm --base-href /kalender/
```

--------------------------------

### Install Application Executable and Core Files

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/recurrence/windows/CMakeLists.txt

Installs the main application executable, Flutter ICU data file, and the Flutter library to their designated runtime destinations.

```cmake
install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
  COMPONENT Runtime)
```

--------------------------------

### Install Locale Support

Source: https://github.com/werner-scholtz/kalender/blob/main/README.md

Add the intl package if your application requires locale support.

```bash
flutter pub add intl
```

--------------------------------

### Configure Installation Directory for Executable

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/example/windows/CMakeLists.txt

Sets the installation prefix to the directory of the executable for in-place running, especially for Visual Studio builds. This ensures support files are located correctly next to the executable.

```cmake
set(BUILD_BUNDLE_DIR "$<TARGET_FILE_DIR:${BINARY_NAME}>")
set(CMAKE_VS_INCLUDE_INSTALL_TO_DEFAULT_BUILD 1)
if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
  set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE)
endif()

set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data")
set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}")
```

--------------------------------

### Installation: Native Assets and Flutter Assets

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/advanced_example/linux/CMakeLists.txt

Installs native assets and the Flutter assets directory into the application bundle, ensuring all necessary resources are included.

```cmake
set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/linux/")
install(DIRECTORY "${NATIVE_ASSETS_DIR}"
   DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
   COMPONENT Runtime)

set(FLUTTER_ASSET_DIR_NAME "flutter_assets")
install(CODE "
  file(REMOVE_RECURSE \"${INSTALL_BUNDLE_DATA_DIR}/${FLUTTER_ASSET_DIR_NAME}\")
  " COMPONENT Runtime)
install(DIRECTORY "${PROJECT_BUILD_DIR}/${FLUTTER_ASSET_DIR_NAME}"
  DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" COMPONENT Runtime)
```

--------------------------------

### Project and Build Configuration

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/advanced_example/linux/CMakeLists.txt

Sets up the minimum CMake version, project name, executable name, and GTK application ID. It also opts into modern CMake behaviors and sets the installation rpath for bundled libraries.

```cmake
cmake_minimum_required(VERSION 3.13)
project(runner LANGUAGES CXX)

set(BINARY_NAME "advanced_example")
set(APPLICATION_ID "com.example.advanced_example")

cmake_policy(SET CMP0063 NEW)

set(CMAKE_INSTALL_RPATH "$ORIGIN/lib")
```

--------------------------------

### Installation: AOT Library

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/advanced_example/linux/CMakeLists.txt

Conditionally installs the Ahead-Of-Time (AOT) compiled library to the bundle's lib directory for non-Debug build types.

```cmake
if(NOT CMAKE_BUILD_TYPE MATCHES "Debug")
  install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
    COMPONENT Runtime)
endif()
```

--------------------------------

### Install Flutter Assets

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/example/windows/CMakeLists.txt

Removes the existing assets directory and then installs the Flutter assets. This ensures that the assets directory is always up-to-date with the latest build output.

```cmake
set(FLUTTER_ASSET_DIR_NAME "flutter_assets")
install(CODE "
  file(REMOVE_RECURSE \"${INSTALL_BUNDLE_DATA_DIR}/${FLUTTER_ASSET_DIR_NAME}\")
  " COMPONENT Runtime)
install(DIRECTORY "${PROJECT_BUILD_DIR}/${FLUTTER_ASSET_DIR_NAME}"
  DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" COMPONENT Runtime)
```

--------------------------------

### Cleaning Build Bundle Directory

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/web_demo/linux/CMakeLists.txt

Installs a code that removes the build bundle directory before installation, ensuring a clean state for the new bundle. This is part of the installation process.

```cmake
install(CODE "
  file(REMOVE_RECURSE \"${BUILD_BUNDLE_DIR}/\")
  " COMPONENT Runtime)
```

--------------------------------

### Install Bundled Plugin Libraries

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/example/windows/CMakeLists.txt

Installs any bundled plugin libraries to the application bundle's library directory. This ensures that plugins are correctly deployed with the application.

```cmake
if(PLUGIN_BUNDLED_LIBRARIES)
  install(FILES "${PLUGIN_BUNDLED_LIBRARIES}"
    DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
    COMPONENT Runtime)
endif()
```

--------------------------------

### Setting Installation Prefix for Bundle

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/web_demo/linux/CMakeLists.txt

Configures the installation prefix to a bundle directory within the project's binary directory. This is used for creating a relocatable application bundle.

```cmake
set(BUILD_BUNDLE_DIR "${PROJECT_BINARY_DIR}/bundle")
if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
  set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE)
endif()
```

--------------------------------

### Configure MonthView

Source: https://github.com/werner-scholtz/kalender/blob/main/doc/views.md

Initializes a single month view with a custom start date, week start day, and week number visibility.

```dart
MonthViewConfiguration.singleMonth(
  initialDateTime: DateTime(2025, 1, 1),
  firstDayOfWeek: DateTime.monday,
  showWeekNumbers: true,
)
```

--------------------------------

### Project Setup and Minimum CMake Version

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/riverpod/windows/CMakeLists.txt

Sets the minimum required CMake version and defines the project name and languages.

```cmake
cmake_minimum_required(VERSION 3.14)
project(riverpod LANGUAGES CXX)
```

--------------------------------

### Project and CMake Version Setup

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/advanced_example/windows/CMakeLists.txt

Sets the minimum required CMake version and the project name. It also explicitly opts into modern CMake behaviors.

```cmake
cmake_minimum_required(VERSION 3.14)
project(advanced_example LANGUAGES CXX)

set(BINARY_NAME "advanced_example")

cmake_policy(VERSION 3.14...3.25)
```

--------------------------------

### Install AOT Library for Release/Profile Builds

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/example/windows/CMakeLists.txt

Installs the Ahead-Of-Time (AOT) compiled library to the data directory, but only for Profile and Release configurations. This optimizes runtime performance for non-debug builds.

```cmake
install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
  CONFIGURATIONS Profile;Release
  COMPONENT Runtime)
```

--------------------------------

### Install Timezone Support

Source: https://github.com/werner-scholtz/kalender/blob/main/README.md

Add the timezone package if your application requires location or timezone support.

```bash
flutter pub add timezone
```

--------------------------------

### Configure MultiDayView

Source: https://github.com/werner-scholtz/kalender/blob/main/doc/views.md

Initializes a weekly multi-day view with a specific start time and zoom level.

```dart
MultiDayViewConfiguration.week(
  initialTimeOfDay: const TimeOfDay(hour: 7, minute: 0),
  initialHeightPerMinute: 0.7,
)
```

--------------------------------

### Install Native Assets

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/recurrence/windows/CMakeLists.txt

Copies native assets provided by the build.dart script from all packages to the application's runtime library directory.

```cmake
set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/windows/")
install(DIRECTORY "${NATIVE_ASSETS_DIR}"
   DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
   COMPONENT Runtime)
```

--------------------------------

### Configure view transition behaviors

Source: https://github.com/werner-scholtz/kalender/blob/main/MIGRATION.md

Examples of using enum values to control date and scroll transitions.

```dart
// Reopen each view where it last was (Day → Month → Day restores the day):
MultiDayViewConfiguration.singleDay(dateTransition: DateTransition.restorePerView)

// Always reset the scroll to initialTimeOfDay on a view change:
MultiDayViewConfiguration.week(scrollTransition: ScrollTransition.reset)
```

--------------------------------

### Flutter Library Setup

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/advanced_example/windows/flutter/CMakeLists.txt

Configures the Flutter library, including its DLL, header files, and ICU data. It also sets project build directory and AOT library paths.

```cmake
# === Flutter Library ===
set(FLUTTER_LIBRARY "${EPHEMERAL_DIR}/flutter_windows.dll")

# Published to parent scope for install step.
set(FLUTTER_LIBRARY ${FLUTTER_LIBRARY} PARENT_SCOPE)
set(FLUTTER_ICU_DATA_FILE "${EPHEMERAL_DIR}/icudtl.dat" PARENT_SCOPE)
set(PROJECT_BUILD_DIR "${PROJECT_DIR}/build/" PARENT_SCOPE)
set(AOT_LIBRARY "${PROJECT_DIR}/build/windows/app.so" PARENT_SCOPE)

list(APPEND FLUTTER_LIBRARY_HEADERS
  "flutter_export.h"
  "flutter_windows.h"
  "flutter_messenger.h"
  "flutter_plugin_registrar.h"
  "flutter_texture_registrar.h"
)
list(TRANSFORM FLUTTER_LIBRARY_HEADERS PREPEND "${EPHEMERAL_DIR}/")
add_library(flutter INTERFACE)
target_include_directories(flutter INTERFACE
  "${EPHEMERAL_DIR}"
)
target_link_libraries(flutter INTERFACE "${FLUTTER_LIBRARY}.lib")
add_dependencies(flutter flutter_assemble)
```

--------------------------------

### Configure a Multi-Day Week View

Source: https://github.com/werner-scholtz/kalender/blob/main/doc/views.md

Initializes a weekly multi-day view with a specific display range and starting date.

```dart
MultiDayViewConfiguration.week(
  displayRange: DateTimeRange(
    start: DateTime(2024, 1, 1),
    end: DateTime(2025, 12, 31),
  ),
  initialDateTime: DateTime(2024, 6, 15),
)
```

--------------------------------

### Run and build the web demo

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/web_demo/README.md

Commands to execute the application in a browser or build a release version for web deployment.

```sh
flutter run -d chrome
flutter build web --release --wasm --base-href /kalender/
```

--------------------------------

### Install ICU Data File

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/example/windows/CMakeLists.txt

Installs the ICU data file to the data directory of the application bundle. This is necessary for internationalization and localization features.

```cmake
install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
  COMPONENT Runtime)
```

--------------------------------

### Project Initialization and Configuration

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/ics/linux/CMakeLists.txt

Sets the minimum CMake version, project name, and application identifiers.

```cmake
cmake_minimum_required(VERSION 3.13)
project(runner LANGUAGES CXX)

# The name of the executable created for the application. Change this to change
# the on-disk name of your application.
set(BINARY_NAME "ics")
# The unique GTK application identifier for this application. See:
# https://wiki.gnome.org/HowDoI/ChooseApplicationID
set(APPLICATION_ID "com.example.ics")

# Explicitly opt in to modern CMake behaviors to avoid warnings with recent
# versions of CMake.
cmake_policy(SET CMP0063 NEW)

# Load bundled libraries from the lib/ directory relative to the binary.
set(CMAKE_INSTALL_RPATH "$ORIGIN/lib")
```

--------------------------------

### Build and Test Commands

Source: https://github.com/werner-scholtz/kalender/blob/main/AGENTS.md

Standard commands for dependency management, static analysis, and running tests across different timezones.

```bash
# Install dependencies
flutter pub get

# Analyse (CI runs both)
dart analyze && flutter analyze

# Run tests (root package)
flutter test

# Run tests in a specific timezone (CI runs six timezones)
TZ=America/New_York flutter test

# Run all timezones locally (Linux) — mirrors CI matrix
dart tool/test_timezones_linux.dart

# Run specific test file across all timezones
dart tool/test_timezones_linux.dart test/extensions/internal_date_time_test.dart
```

--------------------------------

### Project and Build Configuration

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/riverpod/linux/CMakeLists.txt

Sets up the minimum CMake version, project name, binary name, and application ID. It also configures build type and standard compilation settings.

```cmake
cmake_minimum_required(VERSION 3.13)
project(runner LANGUAGES CXX)

set(BINARY_NAME "riverpod")
set(APPLICATION_ID "com.example.riverpod")

cmake_policy(SET CMP0063 NEW)

set(CMAKE_INSTALL_RPATH "$ORIGIN/lib")

if(FLUTTER_TARGET_PLATFORM_SYSROOT)
  set(CMAKE_SYSROOT ${FLUTTER_TARGET_PLATFORM_SYSROOT})
  set(CMAKE_FIND_ROOT_PATH ${CMAKE_SYSROOT})
  set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
  set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)
  set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
  set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
endif()

if(NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES)
  set(CMAKE_BUILD_TYPE "Debug" CACHE
    STRING "Flutter build mode" FORCE)
  set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS
    "Debug" "Profile" "Release")
endif()
```

--------------------------------

### Initialize Chart.js Instance

Source: https://github.com/werner-scholtz/kalender/blob/main/benchmark/dashboard/index.html

Configures and renders a line chart using Chart.js with custom tooltips and specific axis formatting for benchmark data.

```javascript
function makeChart(canvas, cfg) { // cfg: { labels, commits, unit, title, series:[{label, points:[{y,unit,range,extra}|null], color}] } var multi = cfg.series.length > 1; var datasets = cfg.series.map(function (s) { return { label: s.label, data: s.points.map(function (p) { return p ? p.y : null; }), borderColor: s.color, backgroundColor: s.color, spanGaps: false, tension: 0.2, pointRadius: 2, fill: false, _meta: s.points, }; }); new Chart(canvas.getContext("2d"), { type: "line", data: { labels: cfg.labels, datasets: datasets }, options: { responsive: true, maintainAspectRatio: false, interaction: { mode: "index", intersect: false }, plugins: { legend: { display: multi, labels: { boxHeight: 2, font: { size: 10 } } }, tooltip: { enabled: false, external: externalTooltip, callbacks: { title: function (items) { var c = cfg.commits[items[0].dataIndex] || {}; return c.id ? c.id.slice(0, 7) + (c.message ? " — " + c.message : "") : ""; }, label: function (item) { var p = (item.dataset._meta || [])[item.dataIndex]; if (!p) return ""; var s = item.dataset.label + ": " + (Math.round(p.y * 1000) / 1000) + " " + (p.unit || cfg.unit || ""); if (p.range) s += " (" + p.range + ")"; return s; }, afterLabel: function (item) { var p = (item.dataset._meta || [])[item.dataIndex]; return p && p.extra ? " " + p.extra : ""; }, footer: function () { return "↓ lower is better"; }, }, }, }, scales: { x: { title: { display: true, text: "commit" }, ticks: { maxRotation: 0, autoSkip: true } }, y: { title: { display: true, text: cfg.unit || "" }, beginAtZero: true }, }, }, }); }
```

--------------------------------

### Apply Build Settings and Definitions

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/ics/windows/runner/CMakeLists.txt

Applies standard build settings and sets preprocessor definitions for versioning and Windows compatibility.

```cmake
# Apply the standard set of build settings. This can be removed for applications
# that need different build settings.
apply_standard_settings(${BINARY_NAME})

# Add preprocessor definitions for the build version.
target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION=\"${FLUTTER_VERSION}\"")
target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_MAJOR=${FLUTTER_VERSION_MAJOR}")
target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_MINOR=${FLUTTER_VERSION_MINOR}")
target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_PATCH=${FLUTTER_VERSION_PATCH}")
target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_BUILD=${FLUTTER_VERSION_BUILD}")

# Disable Windows macros that collide with C++ standard library functions.
target_compile_definitions(${BINARY_NAME} PRIVATE "NOMINMAX")
```

--------------------------------

### Tag a pre-release version

Source: https://github.com/werner-scholtz/kalender/blob/main/AGENTS.md

Use this command to create and push a development pre-release tag.

```bash
git tag v0.24.0-dev.1 && git push origin v0.24.0-dev.1
```

--------------------------------

### Project Initialization and Build Configuration

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/ics/windows/CMakeLists.txt

Sets the project name, minimum CMake version, and configures build types for multi-config generators.

```cmake
cmake_minimum_required(VERSION 3.14)
project(ics LANGUAGES CXX)

# The name of the executable created for the application. Change this to change
# the on-disk name of your application.
set(BINARY_NAME "ics")

# Explicitly opt in to modern CMake behaviors to avoid warnings with recent
# versions of CMake.
cmake_policy(VERSION 3.14...3.25)

# Define build configuration option.
get_property(IS_MULTICONFIG GLOBAL PROPERTY GENERATOR_IS_MULTI_CONFIG)
if(IS_MULTICONFIG)
  set(CMAKE_CONFIGURATION_TYPES "Debug;Profile;Release"
    CACHE STRING "" FORCE)
else()
  if(NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES)
    set(CMAKE_BUILD_TYPE "Debug" CACHE
      STRING "Flutter build mode" FORCE)
    set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS
      "Debug" "Profile" "Release")
  endif()
endif()
```

--------------------------------

### Calculate overview points

Source: https://github.com/werner-scholtz/kalender/blob/main/benchmark/dashboard/index.html

Computes either median build times or relative performance ratios based on the benchmark units.

```javascript
function overviewPoints(suiteName, built, runs) { // Frame (ms) → median of all ms benches per run (absolute). Otherwise → normalised // index: mean of value/firstSeenValue across metrics, ×100 (unit-agnostic). var anyMs = built.order.some(function (n) { return runs.some(function (r) { return (r.benches || []).some(function (b) { return b.name === n && b.unit === "ms"; }); }); }); if (anyMs) { var pts = runs.map(function (r) { var vals = (r.benches || []).filter(function (b) { return b.unit === "ms"; }).map(function (b) { return b.value; }); var m = median(vals); return m == null ? null : { y: m, unit: "ms" }; }); return { points: pts, unit: "ms", title: "Overview · median build time" }; } var baseline = {}; built.order.forEach(function (n) { for (var i = 0; i < built.series[n].length; i++) { if (built.series[n][i]) { baseline[n] = built.series[n][i].y; break; } } }); var pts2 = runs.map(function (r, i) { var ratios = []; built.order.forEach(function (n) { var p = built.series[n][i]; if (p && baseline[n]) ratios.push(p.y / baseline[n]); }); if (!ratios.length) return null; var mean = ratios.reduce(function (a, b) { return a + b; }, 0) / ratios.length; return { y: Math.round(mean * 1000) / 10, unit: "% of baseline" }; }); return { points: pts2, unit: "% of baseline", title: "Overview · relative to first commit" }; }
```

--------------------------------

### Export Flutter Library and ICU Data

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/web_demo/windows/flutter/CMakeLists.txt

Publishes the Flutter library path and ICU data file to the parent scope for the install step.

```cmake
set(FLUTTER_LIBRARY ${FLUTTER_LIBRARY} PARENT_SCOPE)
set(FLUTTER_ICU_DATA_FILE "${EPHEMERAL_DIR}/icudtl.dat" PARENT_SCOPE)
```

--------------------------------

### Basic CMake Configuration

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/advanced_example/windows/flutter/CMakeLists.txt

Sets the minimum CMake version and defines the ephemeral directory for generated files. This is a standard starting point for Flutter CMake projects.

```cmake
cmake_minimum_required(VERSION 3.14)

set(EPHEMERAL_DIR "${CMAKE_CURRENT_SOURCE_DIR}/ephemeral")

# Configuration provided via flutter tool.
include(${EPHEMERAL_DIR}/generated_config.cmake)
```

--------------------------------

### Target and Plugin Management

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/ics/linux/CMakeLists.txt

Adds the runner subdirectory, sets build dependencies, and includes generated plugins.

```cmake
add_subdirectory("runner")

# Run the Flutter tool portions of the build. This must not be removed.
add_dependencies(${BINARY_NAME} flutter_assemble)

# Only the install-generated bundle's copy of the executable will launch
# correctly, since the resources must in the right relative locations. To avoid
# people trying to run the unbundled copy, put it in a subdirectory instead of
# the default top-level location.
set_target_properties(${BINARY_NAME}
  PROPERTIES
  RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/intermediates_do_not_run"
)


# Generated plugin build rules, which manage building the plugins and adding
# them to the application.
include(flutter/generated_plugins.cmake)
```

--------------------------------

### Render dashboard UI

Source: https://github.com/werner-scholtz/kalender/blob/main/benchmark/dashboard/index.html

Initializes the dashboard by parsing global benchmark data and injecting DOM elements for charts.

```javascript
function render() { var data = window.BENCHMARK_DATA; var root = document.getElementById("root"); if (!data || !data.entries) { root.innerHTML = '<p class="empty">No benchmark data found.</p>'; return; } var lu = data.lastUpdate ? new Date(data.lastUpdate).toUTCString() : "unknown"; document.getElementById("meta").innerHTML = "Last updated " + lu + " · <a href=\"" + (data.repoUrl || "#") + "\">" + (data.repoUrl || "") + "</a>"; Object.keys(data.entries).forEach(function (suiteName) { var runs = data.entries[suiteName] || []; var h2 = document.createElement("h2"); h2.textContent = suiteName + " (" + runs.length + " runs)"; root.appendChild(h2); if (!runs.length) { var p = document.createElement("p"); p.className = "empty"; p.textContent = "No data."; root.appendChild(p); return; } var built = buildSeries(runs); // Overview card (full width row of its own). var ov = overviewPoints(suiteName, built, runs); var ovCard = document.createElement("div"); ovCard.className = "card overview"; ovCard.innerHTML = '<h3>' + ov.title + '</h3><div class="chart-wrap"><canvas></canvas></div>'; root.appendChild(ovCard); makeChart(ovCard.querySelector("canvas"), { labels: built.labels, commits: built.commits, unit: ov.unit, title: ov.title, series: [{ label: ov.title, points: ov.points, color: "#4f46e5" }], }); // Per-metric grid — frame series grouped by view · workload, one line per scenario. var grid = document.createElement("div"); grid.className = "grid"; root.appendChild(grid); buildCards(suiteName, built).forEach(function (card) { var el = document.createElement("div"); el.className = "card"; el.innerHTML = '<h3>' + card.title + '</h3><div class="chart-wrap"><canvas></canvas></div>'; grid.appendChild(el); makeChart(el.querySelector("canvas"), { labels: built.labels, commits: built.commits, unit: card.unit, title: card.title, series: card.series, }); }); }); } render();
```

--------------------------------

### Find and Check GTK, GLIB, and GIO Dependencies

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/example/linux/flutter/CMakeLists.txt

This snippet uses `pkg-config` to find and check for the required GTK, GLIB, and GIO system-level dependencies. It ensures these libraries are available before proceeding with the build.

```cmake
find_package(PkgConfig REQUIRED)
pkg_check_modules(GTK REQUIRED IMPORTED_TARGET gtk+-3.0)
pkg_check_modules(GLIB REQUIRED IMPORTED_TARGET glib-2.0)
pkg_check_modules(GIO REQUIRED IMPORTED_TARGET gio-2.0)
```

--------------------------------

### Analyze documentation snippets

Source: https://github.com/werner-scholtz/kalender/blob/main/CONTRIBUTING.md

Run this tool to verify that all fenced Dart code blocks in documentation are valid and compile correctly.

```bash
dart run tool/analyze_doc_snippets.dart
```

--------------------------------

### Implement a basic calendar with CalendarView

Source: https://github.com/werner-scholtz/kalender/blob/main/example/README.md

Sets up a basic calendar interface using the CalendarView widget with default event handling. Requires the kalender and flutter/material packages.

```dart
import 'package:flutter/material.dart';
import 'package:kalender/kalender.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(body: MyCalendar()),
    );
  }
}

class MyCalendar extends StatefulWidget {
  const MyCalendar({super.key});

  @override
  State<MyCalendar> createState() => _MyCalendarState();
}

class _MyCalendarState extends State<MyCalendar> {
  final eventsController = DefaultEventsController();
  final calendarController = CalendarController();

  @override
  Widget build(BuildContext context) {
    return CalendarView(
      eventsController: eventsController,
      calendarController: calendarController,
      viewConfiguration: MultiDayViewConfiguration.week(
        // Without this the day opens at midnight.
        initialTimeOfDay: const TimeOfDay(hour: 7, minute: 0),
      ),
      callbacks: CalendarCallbacks(
        onEventCreated: (event) => eventsController.addEvent(event),
      ),
      header: CalendarHeader(),
      body: CalendarBody(),
    );
  }
}
```

--------------------------------

### Basic CMake Configuration

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/web_demo/windows/flutter/CMakeLists.txt

Sets the minimum CMake version and defines the ephemeral directory for generated files.

```cmake
cmake_minimum_required(VERSION 3.14)

set(EPHEMERAL_DIR "${CMAKE_CURRENT_SOURCE_DIR}/ephemeral")
```

--------------------------------

### Runtime Output Directory Configuration

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/riverpod/linux/CMakeLists.txt

Configures the runtime output directory for the main binary to a specific intermediate location to ensure correct resource loading.

```cmake
set_target_properties(${BINARY_NAME}
  PROPERTIES
  RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/intermediates_do_not_run"
)
```

--------------------------------

### Configure Flutter system dependencies

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/ics/linux/flutter/CMakeLists.txt

Locates required GTK, GLIB, and GIO libraries using PkgConfig.

```cmake
find_package(PkgConfig REQUIRED)
pkg_check_modules(GTK REQUIRED IMPORTED_TARGET gtk+-3.0)
pkg_check_modules(GLIB REQUIRED IMPORTED_TARGET glib-2.0)
pkg_check_modules(GIO REQUIRED IMPORTED_TARGET gio-2.0)
```

--------------------------------

### Configure TileComponents options

Source: https://github.com/werner-scholtz/kalender/blob/main/doc/appearance.md

Full reference for overriding event tile appearance, drag behavior, and resize handles in grid-based calendar views.

```dart
TileComponents(
  // Required: the stationary event tile.
  tileBuilder: (event, tileRange) => Container(),

  // Optional: shown over the calendar in portal overlays instead of tileBuilder.
  overlayTileBuilder: (event, tileRange) => Container(),

  // Optional: shown in place of the tile while it is being dragged.
  tileWhenDraggingBuilder: (event) => Container(),

  // Optional: the tile that follows the cursor / finger during a drag.
  feedbackTileBuilder: (event, dropTargetWidgetSize) => Container(),

  // Optional: rendered beneath the dragged tile to show where it will land.
  dropTargetTile: (event) => Container(),

  // The drag anchor strategy used by feedbackTileBuilder.
  dragAnchorStrategy: childDragAnchorStrategy,

  // The drag anchor strategy used while resizing.
  resizeDragAnchorStrategy: childDragAnchorStrategy,

  // Position and size the resize handles (a function returning your ResizeHandles subclass).
  resizeHandlePositioner: myResizeHandlePositioner,

  // The vertical resize handle widget.
  verticalResizeHandle: Container(),

  // The horizontal resize handle widget.
  horizontalResizeHandle: Container(),
)
```

--------------------------------

### Run analyzer and tests

Source: https://github.com/werner-scholtz/kalender/blob/main/CONTRIBUTING.md

Execute these commands to verify code quality and ensure tests pass before submitting changes.

```bash
dart analyze && flutter analyze
flutter test
```

--------------------------------

### Apply Standard Build Settings

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/advanced_example/windows/runner/CMakeLists.txt

Applies a standard set of build settings to the specified target. This can be customized for applications requiring different build configurations.

```cmake
# Apply the standard set of build settings. This can be removed for applications
# that need different build settings.
apply_standard_settings(${BINARY_NAME})
```

--------------------------------

### Configuring Runtime Library Path

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/web_demo/linux/CMakeLists.txt

Sets the runtime search path for libraries, ensuring that bundled libraries in the 'lib' directory relative to the binary can be found at runtime.

```cmake
set(CMAKE_INSTALL_RPATH "$ORIGIN/lib")
```

--------------------------------

### Configuring C++ Wrapper Sources

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/recurrence/windows/flutter/CMakeLists.txt

Appends core, plugin, and application-specific C++ wrapper source files to respective lists, prepending the wrapper root directory. These sources are used for building wrapper libraries.

```cmake
list(APPEND CPP_WRAPPER_SOURCES_CORE
  "core_implementations.cc"
  "standard_codec.cc"
)
list(TRANSFORM CPP_WRAPPER_SOURCES_CORE PREPEND "${WRAPPER_ROOT}/")
list(APPEND CPP_WRAPPER_SOURCES_PLUGIN
  "plugin_registrar.cc"
)
list(TRANSFORM CPP_WRAPPER_SOURCES_PLUGIN PREPEND "${WRAPPER_ROOT}/")
list(APPEND CPP_WRAPPER_SOURCES_APP
  "flutter_engine.cc"
  "flutter_view_controller.cc"
)
list(TRANSFORM CPP_WRAPPER_SOURCES_APP PREPEND "${WRAPPER_ROOT}/")
```

--------------------------------

### Project and Build Configuration

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/testing/linux/CMakeLists.txt

Sets the minimum CMake version, project name, executable name, and application ID. It also configures build type and modern CMake behaviors.

```cmake
cmake_minimum_required(VERSION 3.13)
project(runner LANGUAGES CXX)

set(BINARY_NAME "testing")
set(APPLICATION_ID "com.example.testing")

cmake_policy(SET CMP0063 NEW)

set(CMAKE_INSTALL_RPATH "$ORIGIN/lib")

if(FLUTTER_TARGET_PLATFORM_SYSROOT)
  set(CMAKE_SYSROOT ${FLUTTER_TARGET_PLATFORM_SYSROOT})
  set(CMAKE_FIND_ROOT_PATH ${CMAKE_SYSROOT})
  set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
  set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)
  set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
  set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
endif()

if(NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES)
  set(CMAKE_BUILD_TYPE "Debug" CACHE
    STRING "Flutter build mode" FORCE)
  set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS
    "Debug" "Profile" "Release")
endif()
```

--------------------------------

### Link Libraries and Include Directories

Source: https://github.com/werner-scholtz/kalender/blob/main/examples/recurrence/windows/runner/CMakeLists.txt

Adds necessary dependency libraries and include directories for the application. Custom application-specific dependencies should also be added here.

```cmake
target_link_libraries(${BINARY_NAME} PRIVATE flutter flutter_wrapper_app)
target_link_libraries(${BINARY_NAME} PRIVATE "dwmapi.lib")
target_include_directories(${BINARY_NAME} PRIVATE "${CMAKE_SOURCE_DIR}")
```

--------------------------------

### ScheduleViewConfiguration

Source: https://github.com/werner-scholtz/kalender/blob/main/doc/views.md

Constructors for defining the layout behavior of the Schedule view.

```APIDOC
## ScheduleViewConfiguration

### Description
Defines the layout behavior for the Schedule view, which presents events in a chronological scrollable list.

### Constructors
- `ScheduleViewConfiguration.continuous()` - Configures the view as a single continuous list.
- `ScheduleViewConfiguration.paginated()` - Configures the view to be paginated by month.
```
Tokens:
Raw