universal_flutter_utils #

A production-ready Flutter UI toolkit and utilities package for building mobile, web, and desktop apps faster. It bundles reusable widgets, Dio API helpers, Firebase & push notifications, authentication, file/media pickers, maps & location, form validators, theming, Socket.io, and cross-platform helpers — all behind a single import.

Version: 0.0.11 · View on pub.flutter-io.cn · API docs

Why use this package? #

Most Flutter apps repeat the same building blocks: styled buttons, OTP inputs, bottom sheets, Dio interceptors, file upload flows, permission prompts, and Firebase setup. universal_flutter_utils packages those patterns so you can focus on business logic instead of boilerplate.

Designed for real production apps — the included example/ app shows how teams typically wire things up: configure UFUtils once at startup, theme via AppTheme, then use widgets and helpers throughout screens.

Single entry point — one import exposes widgets, utilities, models, theme, extensions, and networking:

import 'package:universal_flutter_utils/universal_flutter_utils.dart';

Cross-platform — Android, iOS, Web, macOS, Windows, and Linux.

Installation #

Add to your pubspec.yaml:

dependencies:
  universal_flutter_utils: ^0.0.11

Then run:

flutter pub get

App Setup (Recommended Pattern) #

Based on the included example app, configure global settings once in initState or before runApp:

void main() {
  runApp(const MyApp());
}

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();

    // App identity & API endpoints
    UFUtils.appName = "My App";
    UFUtils.baseUrl = "https://api.example.com/";
    UFUtils.socketBaseUrl = "wss://socket.example.com";

    // Optional: encryption, token refresh, navigation on 401
    UFUtils.applyEncryption = true;
    UFUtils.refreshToken = () async { /* refresh auth token */ };
    UFUtils.refreshDestination = "/login";

    // Brand colors — used across all UFU widgets automatically
    AppTheme.themeColors.primary = Color(0xff9381ff);
    AppTheme.themeColors.secondary = Color(0xffb8b8ff);
    AppTheme.themeColors.tertiary = Color(0xffffd8be);
  }

  @override
  Widget build(BuildContext context) {
    return GetMaterialApp(
      title: UFUtils.appName,
      theme: ThemeData(useMaterial3: true),
      home: HomePage(),
    );
  }
}

Quick Start #

UI widgets #

UFUButton(
  text: "Get Started",
  colorType: UFUButtonColorType.primary,
  textSize: UFUTextSize.heading2,
  fontWeight: UFUFontWeight.medium,
  radius: 12,
  onPressed: () {},
)

UFUInputBox(hintText: "Email", controller: emailController)

UFUOtpInputBox(onCompleted: (otp) => verifyOtp(otp))

ShowUFULoader(msg: "Loading...")

ShowUFUBottomSheet(
  child: (controller) => YourWidget(),
)

Form validators #

UFUtils.textValidator(text, isRequired: true, minCount: 3);
UFUtils.emailValidator(email, isRequired: true);
UFUtils.phoneValidator(phone, isRequired: true);
UFUtils.passwordValidator(password, isRequired: true);
UFUtils.confirmPasswordValidator(confirm, password: password);

File & media pickers #

List<XFile> images = await UFUtils.picker.selectImageFromGallery(selectMultiple: true);
List<XFile> photos = await UFUtils.picker.captureImageFromCamera();
String? docPath = await UFUtils.picker.selectDocument();
dynamic audio = await UFUtils.picker.recordAudio();
String? contact = await UFUtils.picker.selectContacts();
DateTime? date = await UFUtils.picker.selectDate();
TimeOfDay? time = await UFUtils.picker.selectTime();

API calls #

final api = UFApiConfig();
final data = await api.get('/users');
await api.post('/auth/login', data: {'email': email, 'password': password});
await api.uploadFile(path: '/upload', file: file, fileParam: 'file');

Firebase & notifications #

await UFUtils.firebaseUtils.initFirebase(
  options: DefaultFirebaseOptions.currentPlatform,
  notificationTap: (payload) => handleNotification(payload),
);
UFUtils.firebaseUtils.initFCMToken();

Socket.io #

await UFSocketConfig.initializeSocket(
  initListeners: ({required socket, required on}) {
    on('message', (data) => print(data));
  },
);
UFSocketConfig.send('event', {'key': 'value'});

Facilities Overview #

Everything below is available from the single package import.

UI Widgets #

Networking (UFApiConfig) #

Real-time (UFSocketConfig) #

Authentication & Security #

Firebase & Push Notifications #

File, Media & Device Pickers (UFUtils.picker) #

Maps & Location #

Form Validation & Data Helpers #

Permissions (UFUtils.permissionUtils) #

Handles request flows for: storage, camera, photos, notifications, location, contacts, audio, microphone, and videos — with individual or batch (getAllPermissions) request methods.

Theming (AppTheme) #

Extensions #

Models #

Common Services & Constants #

Package Structure #

lib/
 ├── api_config/          → UFApiConfig, AES encryption, Dio interceptors, retry
 ├── common/              → Constants, enums, cookies, Firebase, social login, notifications
 ├── extensions/          → String helpers, input formatters
 ├── models/              → Address, contact, local info, select list models
 ├── socket_config/       → UFSocketConfig, socket interceptors
 ├── theme/               → AppTheme, ThemeColors, typography, form UI helper
 ├── utils/               → UFUtils hub — validators, picker, permissions, preferences
 ├── widgets/             → 40+ UI components (buttons, inputs, lists, maps, media, etc.)
 └── universal_flutter_utils.dart → Single entry-point export

Example App #

The example/ project is the reference implementation. It demonstrates:

Run it:

cd example
flutter pub get
flutter run

Typical integration pattern from the example:

// Navigate to feature screens built with UFU widgets
UFUButton(text: "Widgets Sample", onPressed: () => Get.to(WidgetsSamples()));
UFUButton(text: "API Sample", onPressed: () => Get.to(APISampleCalls()));
UFUButton(text: "File Picker", onPressed: () => Get.to(FilePicker()));

Typical Production Workflows #

Paginated list with pull-to-refresh #

UFUListView(
  listCount: items.length,
  onRefresh: () => controller.fetchPage(reset: true),
  onLoadMore: () => controller.fetchPage(),
  isLoading: controller.isLoading,
  shimmerBuilder: (_, __) => UFUShimmer(...),
  noDataText: "No results found",
  itemBuilder: (context, index) => ItemTile(item: items[index]),
)

Network-backed multi-select filter #

UFUMultiSelect(
  title: 'Select categories',
  type: UFUMultiSelectType.network,
  mainList: categories,
  onSearch: (query) => controller.searchCategories(query),
  onLoadMore: () => controller.loadMoreCategories(),
  onDone: (selected) => applyFilter(selected),
)

Confirmation before destructive action #

ShowUFUConfirmationDialog(
  title: 'Delete item?',
  subTitle: 'This action cannot be undone.',
  prefixBtnText: 'Cancel',
  suffixBtnText: 'Delete',
  onTapSuffix: () => deleteItem(),
);

Image pick → crop → upload #

final images = await UFUtils.picker.captureImageFromCamera();
if (images.isNotEmpty) {
  final cropped = await Get.to(() => UFUImageCropper(
    imagePath: images.first.path,
    cropShape: UFUImageCropShape.circle,
    cropRatio: UFUImageCropRatio.ratio1x1,
  ));
  if (cropped != null) {
    await UFApiConfig().uploadFile(path: '/avatar', file: File(cropped), fileParam: 'file');
  }
}

Platform Support #

Search & Discoverability #

Pub.dev topics: widgets, utilities, ui, networking, authentication.

Common searches this package helps with:

flutter widgets · flutter ui kit · dio interceptor · flutter form validation · flutter file picker · flutter bottom sheet · flutter otp input · flutter multi select · flutter shimmer · firebase auth flutter · socket.io flutter · flutter theme · google maps place picker · flutter biometric auth · social login flutter · flutter utilities · flutter pagination list · flutter image cropper · flutter push notifications

License #

MIT License — see LICENSE.

Contributing #

Issues, feature requests, and pull requests are welcome on GitHub.

Made with care to save your time and keep Flutter code clean.