veneer 0.25.3
veneer: ^0.25.3 copied to clipboard
Real native iOS 26 UI for Flutter: Liquid Glass, UIKit bars, sheets, menus and composers driven by Flutter layout, with matching Flutter UI on Android.
Veneer #
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.
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
Full-quality video |
What you're watching — the example app on the iOS 27 simulator, in real time:
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,GlassShapeand 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 #
![]() iOS 26+ — UIKit and Liquid Glass |
![]() 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.
Gallery #
Built for the iPhone Duo #
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;
ClipPathcounts 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.











