ios_adaptive_context_menu #

Flutter plugin for showing adaptive single-tap context menus on iOS and Android.

Features #

• Opens the iOS system context menu with a single tap.
• Opens a Material popup context menu on Android with the same API.
• Supports actions, dividers, and nested submenus.
• Supports SF Symbols (iconSystemName) and SVG asset icons (iconAssetPath).
• Uses a unified action model across iOS and Android.

Requirements #

• Flutter >=3.13.0
• iOS 14.0+

Installation #

dependencies:
  ios_adaptive_context_menu: ^0.1.0

Run Example App #

cd example
flutter pub get
flutter run -d ios

Usage #

import 'package:flutter/material.dart';
import 'package:ios_adaptive_context_menu/ios_adaptive_context_menu.dart';

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

  @override
  Widget build(BuildContext context) {
    return IosSingleTapContextMenu(
      actions: const [
        IosContextMenuAction(
          id: 'share',
          title: 'Share',
          iconSystemName: 'square.and.arrow.up',
        ),
        IosContextMenuDivider(),
        IosContextMenuAction(
          id: 'delete',
          title: 'Delete',
          iconSystemName: 'trash',
          destructive: true,
        ),
      ],
      onSelected: (id) {
        debugPrint('Selected action: $id');
      },
      child: const ListTile(
        title: Text('Tap me'),
        subtitle: Text('Shows iOS native context menu'),
      ),
    );
  }
}

API #

• IosSingleTapContextMenu
• IosContextMenuAction
• IosContextMenuDivider
• IosContextMenuSubmenu

Why this approach is stable in Flutter UI #

When UIKit content is kept permanently embedded in the Flutter view hierarchy, it can cause rendering and interaction issues in some layouts.

This package avoids that by using an on-demand native bridge:

• The user taps a Flutter widget.
• The tap is forwarded to native iOS code.
• Native creates a temporary invisible UIKit anchor (UIButton) only for menu presentation.
• The system context menu is shown from that temporary anchor.
• The anchor is cleaned up after selection/dismissal (and also on widget dispose).

Because no persistent UIKit view is mounted inside Flutter for normal rendering, this approach prevents common Flutter UI breakage caused by long-lived UIKit embedding.

Screenshots #

iOS	Android