Veneer

pub package CI pub points likes Platform License: MIT

Real native iOS 26 UI for Flutter apps — Liquid Glass, UIKit bars, sheets, menus and composers — driven by your Flutter widget tree, with matching Flutter UI on Android and older iOS.

Wander, the example app: a place page, Explore with glass over photos, and a native booking sheet

Veneer puts real UIKit on screen where your Flutter widgets say it should be. The tab bar is a real UITabBarController, the navigation bar a real UINavigationBar, sheets are real UISheetPresentationController sheets, and glass is real UIGlassEffect bending your Flutter pixels — with UIKit's own animations, gestures and accessibility. You write ordinary Flutter widgets; on Android and iOS 15–25 the same tree renders Flutter replicas, so one codebase serves every platform.

Components · Example app · How it works · Changelog

Scrolling Explore under a pinned glass bar, opening a place and booking a stay in a native sheet
Full-quality video
What you're watching — the example app on the iOS 27 simulator, in real time:
  • Photos scroll under a glass segment bar that pins below the native navigation bar, and under glass labels laid out by Flutter.
  • A pushed page runs its photo under the bar; the glass bar buttons sit right on it.
  • “Book a stay” opens a real UIKit sheet with a medium and a large detent, holding Flutter content with a native segmented control, slider and switches.
  • The tab bar slides away under the pushed page and comes back with it.
Every frame, native views move with the Flutter pixels under them: one synchronous dart:ffi call after Flutter paints.

Why Veneer

  • The real thing, not a look-alike. Flutter's Cupertino widgets imitate iOS; Veneer is iOS. Bars, sheets, menus, alerts, banners, controls and Liquid Glass come from UIKit, so they look, move and feel exactly like the system — including what Apple changes next.
  • One widget tree. NativeNavigationBar, NativeComposer, GlassShape and friends are plain widgets. No platform checks, no second UI for Android.
  • In sync with Flutter. Glass follows scrolling, clips and route transitions in the same frame as the content under it, and merges and morphs the way native glass does.
  • Ready for big screens. Split layouts give each column its own navigation bar, and the tab bar becomes a side column on the unfolded iPhone Duo.

Status: pre-1.0. The API may still change between minor versions; every change is in the changelog. Verified on the iOS 26 and 27 simulators (iPhone and the iPhone Duo, folded and unfolded) and the Android emulator; real-device performance measurements are still to come.

Native and Flutter, side by side

Explore on iOS 26: native navigation bar, tab bar and Liquid Glass
iOS 26+ — UIKit and Liquid Glass
The same screen as Flutter replicas
Android, iOS 15–25 — Flutter replicas

The same widget tree, with no platform checks. The replicas match the native layout, sizes and corner radii, with solid surfaces instead of glass. The example app has a Flutter replicas switch to flip between the two at runtime.

Glass bar buttons on a full-bleed photo
Navigation bar
Glass buttons over content
A native sheet with native controls
Sheets and controls
A UIKit sheet with Flutter inside
A native menu from a glass button
Menus
From glass, bars and any widget
The composer above the keyboard
Composer
Morphs with the keyboard
An assistant with the prompt composer
Prompt composer
An assistant in a sheet
An in-app banner
Banners
Above bars and sheets
Glass over scrolling photos
Glass
Laid out by Flutter, refracting it
A native alert
Alerts
UIAlertController, tinted
Trips with the native tab bar
Tab bar
With a trailing action

Built for the iPhone Duo

Trips on the unfolded iPhone Duo: the list and the selected trip side by side, each with its own native navigation bar, and the tab bar as a side column

Unfold an iPhone Duo and the same widget tree becomes a two-column app. NativeChromePane gives each column its own UINavigationBar and scroll edge effects; the tab bar moves to a glass column at the trailing edge and reports its inset, so content stays clear of it. See Split layouts.

Installation

flutter pub add veneer

Or track the repository directly:

dependencies:
  veneer:
    git:
      url: https://github.com/troyvnit/veneer.git
      ref: main

Requirements:

  • Flutter 3.47 or later (Dart 3.13).
  • iOS deployment target 15.0 or later. The native layer turns on at runtime on iOS 26+. Build with Xcode 26 or later so the iOS 26 SDK is available. Xcode 27 adds the parts that need the iOS 27 SDK: the tab bar's prominent action tab and selected tab icons.
  • Works with CocoaPods and Swift Package Manager. No Android setup.

Quick start

Wrap your pages in a NativeChromeScope for the tab bar, and register the navigator observer so native chrome steps aside for Flutter dialogs and bottom sheets:

import 'package:veneer/veneer.dart';

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

  @override
  Widget build(BuildContext context) => MaterialApp(
    navigatorObservers: [VeneerNavigatorObserver()],
    home: const Home(),
  );
}

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

  @override
  State<Home> createState() => _HomeState();
}

class _HomeState extends State<Home> {
  int _tab = 0;

  @override
  Widget build(BuildContext context) => NativeChromeScope(
    tabs: const [
      NativeTabItem(title: 'Home', icon: NativeIcon.symbol('house'), selectedIcon: NativeIcon.symbol('house.fill')),
      NativeTabItem(title: 'Inbox', icon: NativeIcon.symbol('tray'), badge: '3'),
    ],
    selectedIndex: _tab,
    onTabSelected: (i) => setState(() => _tab = i),
    child: IndexedStack(index: _tab, children: const [HomePage(), InboxPage()]),
  );
}

Pages add a navigation bar by wrapping their content. Content gets MediaQuery padding for the bars, so it starts below them and scrolls underneath:

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

  @override
  Widget build(BuildContext context) => Scaffold(
    body: NativeNavigationBar(
      title: const NativeBarTitle(title: 'Inbox'),
      trailing: [NativeBarButton(icon: const NativeIcon.symbol('square.and.pencil'), title: 'New', onPressed: () {})],
      child: Builder(
        builder: (context) => ListView(padding: MediaQuery.paddingOf(context), children: const [/* … */]),
      ),
    ),
  );
}

Components

Widget What it is
NativeChromeScope A real UITabBarController: the floating Liquid Glass bar, selection morph, badges and a detached trailing action. Slides away when another screen covers it.
NativeNavigationBar A real UINavigationBar: glass bar buttons, title capsules, grouped buttons, native menus and iOS 26's scroll edge effect over Flutter content.
NativeChromePane Split layouts: a navigation bar per column, and routes that show in one pane.
NativeComposer A messaging composer that morphs into a card above the keyboard, with mentions and voice recording.
NativePromptComposer An assistant composer: attachments, a voice button that becomes send, and a voice session.
showNativeSheet Real UIKit sheets hosting Flutter: detents, grabber, Liquid Glass at partial heights.
NativeMenuAnchor, NativeContextMenu UIMenus from any Flutter widget, and context menus on long-pressed widgets.
GlassShape, GlassGroup, GlassBackground UIGlassEffect laid out by Flutter: merging, clipped, interactive, or behind Flutter content.
NativeSearchField, NativeSearchToolbar A glass search field, and the system search bar at the bottom of the screen.
GlassSegmentBar A row of icons on one glass capsule with a sliding highlight.
NativeSwitch, NativeSlider, NativeSegmentedControl, showNativeAlert UIKit's controls and alerts, laid out by Flutter.
showNativeBanner In-app notification banners on Liquid Glass, above the app's bars and sheets.
NativeIcon SF Symbols, any IconData, SVG and images, all rendered natively.

The full reference, with every option and an example for each, is in doc/components.md.

Platform support

Platform What renders
iOS 26+ The native layer: UIKit bars, sheets and composers, Liquid Glass, scroll edge effects
iOS 15–25, Android Flutter replicas of the same UI, matching layout, sizes, positions, colours and corner radii, with solid surfaces instead of glass
Web, desktop Not supported (the bridge uses dart:ffi)

Veneer.isSupported tells you which path is active. You rarely need it: every widget picks its own path, so app code needs no Platform.isIOS checks.

Android and older iOS

Where the native layer isn't available, every widget renders a Flutter replica with the native layout, sizes, positions and corner radii, iOS system colours, and solid surfaces instead of glass. It follows light and dark mode.

To preview the replicas on an iOS 26 device, set Veneer.debugForceFallback = true before runApp (the example's Flutter replicas switch does this at runtime, remounting the app). Wrap any subtree in VeneerFallbackScope to force its replicas.

To match your design system, add a VeneerFallbackStyle to your theme's extensions (one per brightness); the replicas read their surfaces, labels, accent, badge colours and shadows from it:

ThemeData(extensions: [
  VeneerFallbackStyle.iosLight.copyWith(accent: brand, surface: card, shadows: brandShadow),
])

A Flutter sheet given a backgroundColor stays solid at every detent; pass a CupertinoDynamicColor to have it follow light and dark mode while it's open.

Limitations

  • Z-order: native glass and chrome always draw above Flutter content, so their content has to be native. Flutter popups are handled (chrome steps aside); arbitrary Overlays aren't.
  • Clips: one rounded clip per shape is exact; ClipPath counts as its bounding box. Shapes under different clips don't merge. Opaque Flutter widgets painted over glass don't hide it.
  • Route transitions: the tab bar slides away under pushed routes, but the navigation bar and composer switch at the start of a push instead of sliding with the page.
  • Sheets: the sheet's Flutter content runs in its own isolate (see Sheets).
  • Gestures: a touch that starts on an interactive glass shape belongs to UIKit and can't start a Flutter scroll.
  • Context menus: the lifted preview is a still snapshot, so animated content freezes while the menu is up.
  • Accessibility: not yet audited with VoiceOver.
  • Not yet native: toolbars.

Example app

The example is Wander, a travel journal that uses every component:

cd example
flutter run
  • Explore: featured places on glass cards, a glass category bar that pins under the navigation bar, and a grid of photos with glass labels and native context menus. Search opens the native search toolbar.
  • Place pages: the photo runs under the bar; glass buttons open a native menu of trips and a Book a stay sheet with native controls, an alert and a banner.
  • Trips: a list and its detail; side by side on wide screens like the unfolded iPhone Duo.
  • Journal: the native composer with a toolbar, mentions and voice notes.
  • Components: each component on its own, merging and clipped glass, the Lab (icon types, sync timing) and the Flutter replicas switch.
  • Assistant (the tab bar's trailing button): a trip planner in a native sheet with the prompt composer.

Photos are from Unsplash (credits in the example's README); icons are Phosphor Icons (MIT).

How it works

Veneer adds one transparent native view above the FlutterView. Flutter widgets register anchors; once per frame, after Flutter lays out and paints, Veneer collects every anchor's rect, visibility and clip and hands them to UIKit in a single synchronous dart:ffi call, so native views move in the same frame as the Flutter pixels under them. Bars, composers and sheets are UIKit components configured from Dart. Touches pass through to Flutter except where they land on native controls.

See doc/architecture.md for the design, the per-frame path, measured results and the rules learned along the way.

Contributing

Issues and pull requests are welcome. CI checks formatting, analysis and the Dart tests on the oldest supported Flutter and the latest stable, builds the example for iOS with Xcode 26 and Xcode 27 (which compiles the Swift code against both SDKs) and runs the Swift tests. Before sending a change:

dart format lib test example/lib
tool/analyze.sh            # the package and the example
flutter test
cd example && flutter build ios --simulator --debug
cd ios && xcodebuild test -workspace Runner.xcworkspace -scheme Runner \
  -destination 'platform=iOS Simulator,name=iPhone 17' -only-testing:RunnerTests

tool/analyze.sh fails on any analyzer issue except Flutter's notice that material.dart and cupertino.dart are moving to the material_ui and cupertino_ui packages; veneer keeps the framework imports while it supports Flutter releases from before that move.

License

MIT — see LICENSE.

Libraries

veneer
Veneer: real native iOS 26 UI for Flutter apps.