Skip to content
CAI
Software that uses CAICheck a score

yako-dev/flutter-settings-ui

69.1

Adequate · 5 November 2026

19.3k

lines of production code

Dart

primary language

4

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

This system is a Flutter library that renders platform-native settings interfaces for Android, iOS, macOS, Windows, Linux, and Web. It provides a unified API to display settings lists and split-view layouts that automatically adapt their visual style and behavior to match the host operating system's design language. The package includes comprehensive test coverage and an example application to demonstrate these cross-platform rendering capabilities.

How it got here

2019 — Flutter 3 SDK upgrade and platform UI modernization

6 changes.

The project upgraded its dependencies to Flutter 3.44 and Dart 3.12, requiring migration of the example app to the v2 Android embedding and iOS UIScene lifecycle. A new consolidated public API was introduced to expose platform-specific switch implementations and settings components, while the example app was refactored to demonstrate these new platform-aware UI features.

2021 — platform-native UI redesign

9 changes.

The library underwent a major architectural overhaul to render platform-specific settings interfaces for iOS, Android, Windows, macOS, and GNOME, replacing standard Flutter widgets with dedicated \material\_ui\ and \cupertino\_ui\ packages. This period introduced native tile and section styles, split-view support, and updated example apps to showcase these platform-accurate designs.

2022–2026 — Desktop platform expansion and settings UI testing

8 changes.

The project expanded the example application to support native desktop environments by adding runners for Windows, Linux, and macOS, alongside platform-specific widget implementations. Concurrently, comprehensive integration and widget tests were introduced to validate the settings UI, split view layouts, and platform-specific styling across all supported targets.

Features

Add Linux desktop runner for the example app

The example application now includes a native Linux desktop implementation, enabling users to build and run the app on Linux systems. This change introduces the necessary CMake build configuration, GTK-based application entry points, and Flutter Linux bindings to support the desktop platform.

example/linux · high confidence

Add Windows platform support to the example app

The example application now includes the necessary CMake configuration and C++ runner code to build and run on Windows. This addition enables the example to be opened and tested in Visual Studio, providing a complete desktop experience alongside existing mobile and web targets.

example/windows · high confidence

Added launch options and navigation utilities for the example app

The example app now includes utility classes to control initial screen display and navigation styling. LaunchOptions allows users to specify the initial screen, platform style, page, tab, and theme via URL query parameters, initial routes, or dart-define flags, enabling direct navigation to specific settings views (e.g., GNOME Power, Windows Display) for testing or screenshots. Navigation provides a helper to push screens using either Material or Cupertino route styles based on the selected platform, ensuring the correct visual transition is used for the target UI framework.

example/lib/utils · high confidence

Added macOS System Settings replica widgets and iOS leading widget

The example application now includes new widget components to support a macOS System Settings replica and iOS styling. Specifically, \macos\_widgets.dart\ introduces \MacosIconBadge\ for rendering the colored rounded-square icons used in settings rows, and \MacosPopupValue\ for displaying pop-up button values with chevron indicators, both utilizing the \material\_ui\ package. Additionally, \leading\_ios\_widget.dart\ adds a new \LeadingIosWidget\ for iOS-style leading icons, leveraging the \cupertino\_ui\ package.

example/lib/widgets · high confidence

Added macOS platform support for the example app

The example application now includes a native macOS runner, enabling users to build and run the app on macOS. This change adds the complete Xcode project structure, including the \Runner\ target, \AppDelegate\, and \MainFlutterWindow\ to host the Flutter engine, along with standard macOS resources like the main menu, app icons, and entitlements for sandboxing and JIT execution.

example/macos · high confidence

Native platform-specific settings tiles and switches for iOS, Android, Windows, macOS, and Linux

The settings list now renders platform-native UI components for each supported operating system. iOS and macOS tiles and switches now match the latest iOS 26+ and macOS 26/27 System Settings designs, including the new iOS 'Liquid Glass' switch with its glass lens effect and macOS's dual-size switches. Android tiles now use Material 3 styling with check/cross icons for switches. Windows tiles adopt the Windows 11 'Fluent' card style with a native ToggleSwitch, and Linux tiles implement the GNOME (libadwaita) boxed list style with a custom GtkSwitch and symbolic icons. These changes ensure that settings behave and look exactly like the host platform's native settings apps.

lib/src/tiles/platforms · high confidence

The example app now includes a GalleryScreen that serves as a central hub for exploring various settings UI implementations. This screen introduces new demo sections including Material 3 theme demonstrations, a split-view layout for wider screens, and a showcase of a fictional app's settings. It also provides direct access to replicas of native settings interfaces for iOS, Android, macOS, Windows, GNOME, and web browsers, allowing users to see how the library renders on different platforms and styles.

example/lib/screens · high confidence

New example app entry point with platform-specific settings demos

The example application now uses a new main entry point that integrates \material\_ui\ and \cupertino\_ui\ packages to render platform-appropriate settings interfaces. Users can launch specific demo screens—such as Android native settings, iOS developer settings, macOS notifications, Windows display settings, GNOME power settings, and web Chrome settings—via launch options or URL routes, replacing the previous default behavior with a gallery-based navigation system.

example/lib · high confidence

The example gallery now includes dedicated screens that replicate the native settings interfaces of Android, iOS, macOS, and GNOME, alongside a cross-platform settings demo and a Material 3 theme integration showcase. These new screens demonstrate the \settings\_ui\ library's ability to render platform-specific styles (via \DevicePlatform\ settings) and support complex interactions like split views, custom theming, and deep linking within the gallery context.

example/lib/screens/gallery · high confidence

New platform-specific settings section styles for GNOME, Windows, macOS, iOS, Android, and Web

The settings sections now render with distinct, platform-native aesthetics. GNOME (Adwaita) sections use a boxed-list card with soft shadows; Windows (Fluent) sections display individual setting cards with borders and specific header spacing; macOS sections group tiles into cards with continuous corners and handle section footers (descriptions) by starting new cards; iOS sections use grouped rows with rounded corners and specific sidebar insets; Android sections place each tile on its own card with large corner radii; and Web sections wrap tiles in a single card with dividers, or render flat rows in a split view. These changes ensure the settings UI matches the visual language of each target platform.

lib/src/sections/platforms · high confidence

New public API entry point and platform-specific switch exports

The library now exposes a consolidated public entry point in \lib/settings\_ui.dart\ that re-exports core components (settings list, sections, tiles) and utility utilities. Crucially for users, this file now explicitly exports platform-specific switch implementations for Adwaita (Linux), Cupertino (iOS), Fluent (Windows), and macOS, along with the new \SettingsSplitView\ and \SettingsDestination\ components, making these platform-aware UI elements directly accessible from the main package import.

lib · high confidence

Platform-specific split view styles for macOS, Windows, and GNOME

The split view now supports distinct visual styles for macOS, Windows, and GNOME, allowing the settings interface to match the native look and feel of each platform. This includes macOS-style sidebars with active window tracking, Windows-style navigation panes with sliding selection indicators and compact rails, and GNOME-style flat header bars with symbolic icons. A new \SettingsDestination\ class enables tiles to open pages within the split view's detail pane, and \SettingsSplitView\ provides a controller to manage navigation and layout modes.

lib/src/split · high confidence

Behavioural changes

Migrate iOS example app to UIScene lifecycle

The iOS example app has been updated to use the modern UIScene lifecycle, replacing the legacy AppDelegate-based window management with a dedicated SceneDelegate and corresponding Info.plist configurations. This ensures the example app aligns with current iOS development standards and supports multiple scenes if enabled.

example/ios · high confidence

Migrate to \`material\_ui\` and \`cupertino\_ui\` packages

The library has switched its underlying UI dependencies from the standard Flutter Material and Cupertino widgets to the new \material\_ui\ and \cupertino\_ui\ packages. This change enables the \SettingsList\ and \SettingsSplitView\ to render with platform-accurate styles for Windows 11 (Fluent), macOS System Settings, GNOME (libadwaita), and updated iOS/Android/Chrome looks, while also fixing issues such as disabled tiles appearing enabled on the web.

lib/src/utils · high confidence

Migrate to external material\_ui and cupertino\_ui packages for theming

The SettingsList widget now derives its colors, brightness, and style from the \material\_ui\ and \cupertino\_ui\ packages instead of the standard Flutter Material/Cupertino themes. This change introduces a new \ApplicationType\ configuration to specify the source of the theme and adds a debug warning if no compatible theme is found, ensuring users are aware that apps must use the new theme packages or remain on settings\_ui version 3.x.

lib/src/list · high confidence

Migrated example app to Flutter v2 Android embedding

The Android example app has been updated to use the Flutter v2 Android embedding, which is required for compatibility with newer Flutter versions. This change includes adding the necessary AndroidManifest.xml files for debug and profile builds, updating the MainActivity to extend FlutterActivity, and configuring the Android themes and launch backgrounds to support the v2 embedding lifecycle.

example/android · high confidence

Redesigned tile architecture with platform-specific styles and split-view support

The tile system has been refactored to support distinct visual styles for Android, iOS, macOS, Windows (Fluent), and GNOME (libadwaita), along with a new \SettingsSplitView\ for desktop layouts. \SettingsTile\ now accepts a \titleDescription\ for secondary text and \trailing\ widgets, while switch tiles without an \onToggle\ callback are now tappable to toggle state on Android and web. Accessibility is improved by ensuring every tile is its own semantics node and switch tiles include the title in their label. The implementation uses a shared \SettingsTileData\ model and dedicated row widgets for each platform style.

lib/src/tiles · high confidence

Refactored settings sections with platform-specific rendering and split-view support

The settings section rendering logic has been restructured to support distinct visual styles for macOS, Windows, and GNOME in split-view layouts, while maintaining platform-specific appearances (such as card-per-tile for Android/Windows and single-card for iOS/macOS/GNOME) in standard views. This change introduces new internal components like \AbstractSettingsSection\, \CustomSettingsSection\, and \sectionHeader\ to standardize section composition and accessibility, ensuring that sections with no tiles render nothing and that split-view sidebars correctly reflect the active platform theme.

lib/src/sections · high confidence

Test coverage

Added comprehensive test coverage for the settings UI; Added integration tests for settings UI and split view flows; Full test coverage for the settings UI styles and split view.

Dependencies

Upgrade to Flutter 3.44 and Dart 3.12 with new platform UI dependencies

The package and its example app now require Flutter 3.44+ and Dart 3.12+, reflecting a significant SDK upgrade. To support the new platform-specific UI implementations (such as the new iOS and Android styles), the package dependencies have been updated to use \cupertino\_ui\ ^1.0.2 and \material\_ui\ ^1.1.1, replacing older UI packages. The example app's Android build configuration has also been modernized to use the new Gradle plugin management syntax and Java 17.

(dependencies) · high confidence

Housekeeping

Package publish exclusions and agent documentation added

A \.pubignore\ file is introduced to control the contents of the published package, explicitly excluding build artifacts, IDE files, coverage data, and internal agent documentation files (\AGENTS.md\, \CLAUDE.md\) while retaining \llms.txt\. The \AGENTS.md\ file itself is added to the repository to provide instructions for coding agents working on the project, and \CLAUDE.md\ is created as a single-line import of that file. The \.gitignore\ is updated to track \example/.flutter-plugins-dependencies\ and explicitly list coverage and IDE directories.

(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 71 → 69 (-1.7)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

Lenses

  • Code Health 95 → 95 (+0.0)
  • Architecture 97 → 97 (+0.0)
  • Maturity 60 → 57 (-3.7)
  • Readiness 65 → 65 (+0.0)
  • Security 90 → 90 (+0.0)
  • Performance 100 → 100 (+0.0)

Resolved (1)

  • Off-boarding risk: anonymized user #1

New (1)

  • Off-boarding risk: anonymized user #1

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

Survey your own repository

yako-dev/flutter-settings-ui 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 5 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 6b1599310647683230ce7924811d6836fe323d70 — the exact code this score is about.
  • Scored under rubric-2026.11.2 — 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.2+preprod-5c4e66d9318b.