cupertino_native_plus library
cupertino_native_plus — native Cupertino widgets for Flutter.
Import this library to access all public components, styles, and utilities:
import 'package:cupertino_native_plus/cupertino_native_plus.dart';
Components
- CNButton — native push button with Liquid Glass support
- CNIconView — native SF Symbol / custom image renderer
- CNSlider — native UISlider / NSSlider
- CNSwitch — native UISwitch / NSSwitch
- CNTabBar — native tab bar with optional search tab
- CNTabBarNative — iOS 26+ UITabBarController integration
- CNPopupMenuButton — native popup/context menu
- CNPopupGesture — long-press popup gesture wrapper
- CNSegmentedControl — native UISegmentedControl / NSSegmentedControl
- CNGlassButtonGroup — unified Liquid Glass button group
- LiquidGlassContainer — Liquid Glass effect container
- CNSearchBar — native search bar with expand/collapse
- CNSearchScaffold — full-screen native tab bar + search scaffold
- CNToast — lightweight toast notifications
- CNFloatingIsland — floating pill with compact/expanded states
- CNLiquidText — text with native Liquid Glass effect
- CNGlassCard — EXPERIMENTAL glass card with spotlight
Styles & Configuration
- CNButtonStyle, CNButtonConfig, CNButtonTheme (
labelStylefor typography), CNButtonData - CNIcon (icon model), CNIconView (widget), CNSymbol, CNSymbolRenderingMode
- CNImagePlacement, CNGlassEffect, CNGlassEffectShape
- CNButtonGlassMaterial, LiquidGlassConfig
- CNSpotlightMode, CNTabBarSearchItem, CNTabBarSearchStyle
Utilities
- PlatformVersion — cached OS version detection (auto-initializes)
- ThemeHelper — brightness and primary-color helpers
- LiquidGlassExtension —
.liquidGlass()extension on Widget
Classes
- CNButton
- A Cupertino-native push button.
- CNButtonConfig
- Configuration for CNButton with default values.
- CNButtonData
- Data model for button configuration in CNGlassButtonGroup.
- CNButtonDataConfig
- Configuration options for CNButtonData.
- CNButtonTheme
- Unified color and material theme for glass buttons.
- CNFloatingIsland
- A floating pill widget inspired by Apple's Dynamic Island.
- CNFloatingIslandController
- Controller for imperatively managing CNFloatingIsland state.
- CNGlassButtonGroup
- A group of buttons that can be rendered together for proper Liquid Glass blending effects.
- CNGlassCard
- EXPERIMENTAL: A card widget with Liquid Glass effects, breathing animation, and spotlight effect that follows touch or responds to device tilt.
- CNIcon
- Describes an image or icon asset for native rendering.
- CNIconView
- A platform-rendered SF Symbol icon, custom image asset, or IconData.
- CNLiquidText
- A native text widget with a Liquid Glass effect applied.
- CNLoadingToastHandle
- Handle for dismissing a loading toast.
- CNPopupGesture
- A widget that wraps a child and shows a popup menu on long press.
- CNPopupMenuButton
- A Cupertino-native popup menu button.
- CNPopupMenuDivider
- A visual divider between popup menu items.
- CNPopupMenuEntry
- Base type for entries in a CNPopupMenuButton menu.
- CNPopupMenuItem
- A selectable item in a popup menu.
- CNSearchBar
- A native expandable search bar with Liquid Glass effects.
- CNSearchBarController
- Controller for imperatively managing CNSearchBar state.
- CNSearchScaffold
- A full-screen scaffold with native iOS 26 tab bar and search support.
- CNSearchScaffoldItem
- A search scaffold item configuration.
- CNSegmentedControl
- A Cupertino-native segmented control.
- CNSlider
- A Cupertino-native slider rendered by the host platform.
- CNSliderController
- Controller for a CNSlider allowing imperative changes to the native NSSlider/UISlider instance.
- CNSwitch
- A Cupertino-native switch rendered by the host platform.
- CNSwitchController
- Controller for a CNSwitch that allows imperative updates from Dart to the underlying native UISwitch/NSSwitch instance.
- CNSymbol
- Describes an SF Symbol to render natively.
- CNTab
- Configuration for a native tab in CNTabBarNative.
- CNTabBar
- A Cupertino-native tab bar. Uses native UITabBar/NSTabView style visuals.
- CNTabBarItem
- Immutable data describing a single tab bar item.
- CNTabBarNative
- iOS 26+ Native Tab Bar with Search Support
- CNTabBarSearchController
- Controller for programmatically managing the search tab state.
- CNTabBarSearchItem
- Configuration for a search tab in CNTabBar.
- CNTabBarSearchStyle
- Visual styling options for the search tab in CNTabBar.
- CNToast
- A native toast notification widget.
- CupertinoNative
- Top-level facade for simple plugin interactions.
- CupertinoNativePlatform
- The platform interface that platform implementations of this plugin must extend.
- LiquidGlassConfig
- Configuration for Liquid Glass effects.
- LiquidGlassContainer
- A container that applies Liquid Glass effects to its child widget.
- MethodChannelCupertinoNative
- An implementation of CupertinoNativePlatform that uses method channels.
- PlatformVersion
- Utility class for checking OS version with caching and auto-initialization.
- PlatformViewGuard
- Guards platform-view creation during app startup / hot-restart.
- ThemeHelper
- Utility class for accessing theme data with fallback support.
Enums
- CNButtonGlassMaterial
- Glass material for button glass effects on iOS 26+.
- CNButtonStyle
- Visual styles for CNButton and related controls.
- CNFloatingIslandPosition
- Position for the floating island.
- CNGlassEffect
- Liquid Glass effect variants for iOS 26+.
- CNGlassEffectShape
- Shapes for Liquid Glass effects.
- CNImagePlacement
- Image placement options for buttons with both image and label.
- CNSpotlightMode
- Defines the input mode for spotlight effects on glass components.
- CNSymbolRenderingMode
- Rendering modes for SF Symbols.
- CNToastDuration
- Duration presets for toasts.
- CNToastPosition
- Position for the toast on screen.
- CNToastStyle
- Style presets for toasts.
Extensions
- LiquidGlassExtension on Widget
- Extension on Widget to apply Liquid Glass effects.