adaptive_ui_kit 0.0.6

Platform-adaptive Flutter UI kit with automatic Glass (iOS/macOS) and Material (Android) design — adaptive dialogs, pickers, and more.

Adaptive UI Kit

A powerful Flutter package for building beautiful **platform-adaptive user interfaces** with a single API.

---

✨ Overview

Adaptive UI Kit automatically renders the correct UI for each platform.

Platform	Design
iOS	Apple-inspired Glass UI
macOS	Apple-inspired Glass UI
Android	Material 3
Web	Material
Windows	Material
Linux	Material

No platform checks. No duplicate widgets.

---

🎬 Demo

---

Features

• Automatic platform adaptation
• Adaptive Dialog
• Adaptive Action Sheet
• Adaptive Date Picker
• Adaptive Time Picker
• Adaptive Multi Select
• Global theme configuration
• Force UI Kit support
• Custom resolver support
• Pure Flutter (no GetX required)

---

Installation

dependencies:
  adaptive_ui_kit: ^0.0.6

flutter pub get

---

Quick Start

import 'package:adaptive_ui_kit/adaptive_ui_kit.dart';

await AdaptiveDialog.showConfirm(
  context: context,
  title: 'Delete Item',
  message: 'Are you sure?',
);

await AdaptiveActionSheet.show(
  context: context,
  title: 'Actions',
  items: [
    ActionSheetItem(
      label: 'Edit',
      icon: Icons.edit,
      onTap: () {},
    ),
  ],
);

## Passing full widgets and styles

You can pass full widgets instead of plain text for titles, messages, and items. Dialogs also support an optional secondary message with style control.

```dart
await AdaptiveDialog.showConfirm(
  context: context,
  title: 'Delete',
  titleWidget: Row(children: [Icon(Icons.delete), SizedBox(width:8), Text('Delete')]),
  messageWidget: Text('Are you sure?'),
  secondaryMessage: 'This cannot be undone',
  secondaryMessageStyle: TextStyle(color: Colors.red),
);

await AdaptiveActionSheet.show(
  context: context,
  title: 'Options',
  items: [
    ActionSheetItem(label: 'Share', icon: Icons.share, onTap: () {}, child: Row(children: [Icon(Icons.share), SizedBox(width:8), Text('Share via...')])),
  ],
);

Project Status

• Latest changes: dialogs, action-sheets, multi-selects, date & time pickers now accept full-widget overrides (titleWidget, messageWidget, child, etc.) and optional TextStyle parameters. The adaptive wrappers (AdaptiveDialog, AdaptiveActionSheet, AdaptiveMultiSelect, AdaptiveDateTimePicker, AdaptiveTimePicker) propagate these options to both Glass and Material implementations.
• Example app updated: example/lib/main.dart includes widget-only examples and demos of the new APIs.
• Static analysis: flutter analyze reports no issues after the updates.

Integration Guide

To integrate Adaptive UI Kit into your Flutter project:

1. Add the package to pubspec.yaml:

dependencies:
  adaptive_ui_kit: any

2. Import the package:

import 'package:adaptive_ui_kit/adaptive_ui_kit.dart';

3. Optionally configure global theming before runApp:

AdaptiveUiKitConfig.glass = AdaptiveUiKitConfig.glass.copyWith(
  tintColor: Colors.indigo,
  destructiveColor: Colors.red,
);

4. Replace or add UI calls using the adaptive API. Examples:

await AdaptiveDialog.showConfirm(
  context: context,
  // either pass plain text:
  title: 'Confirm',
  message: 'Proceed?'
  // or pass widgets instead:
  titleWidget: Row(children: [Icon(Icons.info), Text('Confirm')]),
);

await AdaptiveActionSheet.show(
  context: context,
  titleWidget: Text('Options'),
  items: [ActionSheetItem(label: 'Edit', icon: Icons.edit, onTap: () {})],
);

final selected = await AdaptiveMultiSelect.show(
  context: context,
  titleWidget: Text('Choose'),
  options: [MultiSelectOption(id: '1', label: 'One', child: Text('One'))],
);

Notes:

• For Material date/time pickers you can pass helpText, cancelText, confirmText, and a builder for custom theme wrapping.
• Widgets take precedence: if titleWidget/messageWidget/child are provided they'll be used instead of string fallbacks.

---

Components

Component	Description
AdaptiveDialog	Platform adaptive dialog
AdaptiveActionSheet	Adaptive action sheet
AdaptiveDateTimePicker	Adaptive date picker
AdaptiveTimePicker	Adaptive time picker
AdaptiveMultiSelect	Adaptive multi select

---

Global Configuration

AdaptiveUiKitConfig.glass =
    AdaptiveUiKitConfig.glass.copyWith(
      tintColor: Colors.indigo,
      blurSigma: 12,
);

AdaptiveUiKitConfig.forceUiKit = AdaptiveUiKit.glass;

---

Architecture

Adaptive Widgets
        │
        ▼
 Platform Resolver
        │
 ┌───────────────┐
 │               │
 ▼               ▼
Glass UI   Material UI
        │
        ▼
 Shared Themes

---

📸 Screenshots

Overview

Adaptive Dialog

iOS (Glass)	Android (Material)

Date Picker

| | |

Time Picker

| | |

---

Example

cd example
flutter run

---

Roadmap

• Adaptive Snackbar
• Adaptive Toast
• Adaptive Dropdown
• Adaptive Navigation Components
• Adaptive Form Controls
• Adaptive Search Bar

---

Why Adaptive UI Kit?

Instead of maintaining separate widgets for every platform, write your UI once and let Adaptive UI Kit deliver the native experience automatically.

---

Contributing

Contributions, bug reports and feature requests are always welcome.

---

License

MIT License

---

Made with ❤️ using Flutter.