swiftuikit 0.1.3

iOS-style page transitions, sheet routes, and routing adapters for Flutter. Provides SwiftPage and SwiftSheet with swipe-back gestures, drag-to-dismiss, and custom transitions for go_router and auto_route.

swiftuikit

iOS-style page transitions and sheet routes for Flutter.

Provides two routing adapters: go_router / Navigator 2.0 and auto_route.

Quick start

pub.dev:

dependencies:
  swiftuikit: ^latest

GitHub (latest):

dependencies:
  swiftuikit:
    git:
      url: https://github.com/exeshka/swiftuikit

Setup

Call ScreenRadiusService.instance.initialize() before runApp() to enable device-aware corner radius clipping:

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await ScreenRadiusService.instance.initialize();
  runApp(MyApp());
}

Route types

Route	Description
SwiftPage / SwiftPageAutoRoute	Full-screen page with iOS swipe-back gesture and parallax/scale transition
SwiftSheetPage / SwiftSheetAutoRoute	Modal bottom sheet with drag-to-dismiss

Usage with go_router

Use the page classes in a pageBuilder:

GoRoute(
  path: '/detail',
  pageBuilder: (context, state) {
    return SwiftPage<void>(
      key: state.pageKey,
      name: state.name,
      child: DetailScreen(),
    );
  },
);

GoRoute(
  path: '/compose',
  pageBuilder: (context, state) {
    return SwiftSheetPage<void>(
      key: state.pageKey,
      child: ComposeScreen(),
    );
  },
);

Usage with auto_route

Use the auto route classes in your @AutoRouterConfig:

@AutoRouterConfig(replaceInRouteName: 'Screen|Page,Route')
class AppRouter extends RootStackRouter {
  @override
  List<AutoRoute> get routes => [
    SwiftPageAutoRoute(page: HomeRoute.page, initial: true),
    SwiftPageAutoRoute(page: DetailRoute.page),
    SwiftSheetAutoRoute(
      page: SheetRoute.page,
      showDragHandle: true,
      animateBackground: true,
    ),
  ];
}

Run codegen from the example/ directory:

cd example && dart run build_runner build --delete-conflicting-outputs

SwiftPage / SwiftPageAutoRoute

Full-screen page transition with iOS-style swipe-back gesture.

SwiftPage<void>(
  child: MyScreen(),
  canSwipe: true,              // enable swipe-back gesture (default: true)
  canOnlySwipeFromEdge: false, // restrict swipe to screen edge (default: false)
  minScale: 0.95,              // scale of the outgoing page during push (default: 0.95)
  transitionDuration: Duration(milliseconds: 500),
)

Property	Type	Default	Description
canSwipe	bool	true	Enable swipe-back gesture
canOnlySwipeFromEdge	bool	false	Restrict swipe detection to the screen edge
minScale	double	0.95	Scale of the outgoing page during a push transition
pageOverlapFraction	double	0.40	How much the incoming page overlaps the outgoing page
clipWithScreenRadius	bool	true	Clip with physical device screen corners
radius	double?	—	Custom corner radius
borderRadius	BorderRadius?	—	Custom border radius geometry
transitionDuration	Duration	500ms	Transition animation duration

SwiftSheetPage / SwiftSheetAutoRoute

Modal bottom sheet with drag-to-dismiss.

SwiftSheetPage<void>(
  child: ComposeScreen(),
  showDragHandle: true,     // show drag indicator at the top (default: false)
  enableDrag: true,         // allow drag-to-dismiss (default: true)
  animateBackground: true,  // animate the previous page (default: true)
  sheetRadius: 38.0,        // corner radius
)

Property	Type	Default	Description
showDragHandle	bool	false	Show a drag handle indicator at the top of the sheet
enableDrag	bool	true	Allow drag-to-dismiss gesture
animateBackground	bool	true	Animate (scale, slide, round corners of) the previous page when the sheet appears
sheetRadius	double?	—	Corner radius of the sheet
sheetB orderRadius	BorderRadius?	—	Custom border radius geometry for the sheet
transitionDuration	Duration	500ms	Transition animation duration

Roadmap

What's planned for future releases:

• Sheets & modals from SwiftUI 26 — pull-down menus, confirmation sheets, and other presentation styles currently available in native SwiftUI. Note: Liquid Glass implementations in the Flutter community are not production-ready for these use cases. We're waiting for the Flutter team to provide proper support.

• SwiftUI components without Liquid Glass — Header, Bottom Navigation Bar, and other UI elements that can be reliably implemented today.

We're hoping for community contributions to help close the gap between what Flutter offers natively and what SwiftUI provides out of the box.

License

See LICENSE for details.