cupertino_native_better

Native iOS 26+ Liquid Glass widgets for Flutter with pixel-perfect fidelity. This package renders authentic Apple UI components using native platform views, providing the genuine iOS/macOS look and feel that Flutter's built-in widgets cannot achieve.

⚠️ REQUIRED: Initialize Before Use

You MUST call PlatformVersion.initialize() before using any widgets!

Without initialization, the package cannot detect your iOS/macOS version and will always fall back to old Cupertino buttons - even on iOS 26+ devices.

import 'package:cupertino_native_better/cupertino_native_better.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // REQUIRED: Initialize platform version detection
  await PlatformVersion.initialize();

  runApp(MyApp());
}

Why is this required? The package needs to detect your OS version to decide whether to use native Liquid Glass (iOS 26+) or fallback widgets (iOS < 26). Without initialization, PlatformVersion.shouldUseNativeGlass always returns false.

Performance Best Practices

⚠️ LiquidGlassContainer & Lists

LiquidGlassContainer uses a Platform View (UiKitView / AppKitView) under the hood. While powerful, platform views are more expensive than standard Flutter widgets.