u 1.0.4

The only package you need, a complete set of packages and utilities you need in every single project.

Everything that Every Project might need in a Single Package

To get started we need to initialize the package in main.dart

main.dart

Future<void> main() async {
  await initUtilities();
  runApp(
    UMaterialApp(
      localizationsDelegates: const <LocalizationsDelegate<dynamic>>[
        GlobalMaterialLocalizations.delegate,
        GlobalWidgetsLocalizations.delegate,
        GlobalCupertinoLocalizations.delegate,
        S.delegate,
      ],
      supportedLocales: const <Locale>[Locale("en")],
      locale: Locale(ULocalStorage.getString(UConstants.locale) ?? "en"),
      lightTheme: AppThemes.lightTheme,
      darkTheme: AppThemes.darkTheme,
      home: const SplashPage(),
    ),
  );
}

InitUtilities

Here you can pass some optional parameters to initUtilities function

apiKey: for adding ApiKey header to HttpInterceptor of the u package.

firebaseOptions: for adding the firebase options.

safeDevice: for having some security checks on Android and iOS safe_device

protectDataLeaking and preventScreenShot: screen protector for preventing user from getting screenshots screen_protector

deviceOrientations: for supporting different Device orientations.

UMaterialApp

UMaterialApp is a wrapper on top of GetMaterialApp of Getx package with some default implementations.

for simplicity all the parameters are required, and everything about having dark/light theme, localizations, loading dialogs and... are handled.

Basic Utilities

UClipboard

setting and getting string data from Clipboard.

UClipboard.set("some text");

UClipboard.getText();

UFile

File Picker file_picker

UFile.showFilePicker(
  allowCompression: true,
  allowedExtensions: <String>["png", "jpg", "JPEG"],
  allowMultiple: true,
  dialogTitle: "Pick Some Awesome Image",
  fileType: FileType.image,
  ...
  action: (final List<FileData> files) {},
);

File Picker image_cropper

UFile.cropImage(
  filePath: "filePath",
  toolbarColor: Colors.purple,
  cropAspectRatio: const CropAspectRatio(ratioX: 1, ratioY: 2),
  cropStyle: CropStyle.circle,
  androidUiSettings: AndroidUiSettings(hideBottomControls: true),
  action: (final FileData file) {},
);

http_interceptor

httpRequest(
  url: "${AppConstants.baseUrlPractino}GetReportsByMobile/$nationalCode",
  httpMethod: EHttpMethod.get,
  action: (final Response<dynamic> response) {
    if ((response.bodyString ?? "").length >= 50) action(LifeReportItemsResponse.fromJson('{"items": ${response.bodyString!}}'));
    else action(null);
  },
  error: (final Response<dynamic> response) {},
  cacheExpireDate: cacheExpireDate,
);

'ULaunch'

need to share text, image, widgets, or want to open someone's Telegram, whatsapp.

ULaunch.email("[e-mail]", "hello");
ULaunch.call("1234567890");
ULaunch.sms("1234567890", "some text");
ULaunch.launchInstagram("sinamn75");
ULaunch.launchTelegram("sinamn75");
ULaunch.launchWhatsApp("1234567890");
ULaunch.launchURL("https://sinamn75.com");
ULaunch.shareText("some text");
ULaunch.shareWidget(widget: const CircleAvatar());
ULaunch.launchMap(35.37651, 55.753325);
ULaunch.shareWithTelegram("some text");
ULaunch.shareWithWhatsapp("some text");
ULaunch.shareWithEmail("some text");

ULoading

A very simple loading dialog from anywhere. flutter_easyloading

ULoading.showLoading();
ULoading.dismissLoading();
ULoading.showError();
ULoading.isLoadingShow();

ULocalAuth

Authentication with biometric local_auth

final bool canAuthenticate = await ULocalAuth.canAuthenticate();

final List<BiometricType> availableBiometrics = await ULocalAuth.availableBiometrics();

await ULocalAuth.authenticate(
  biometricOnly: true,
  localizedReason: "just for fun",
  sensitiveTransaction: true,
  stickyAuth: true,
  useErrorDialogs: true,
);

ULocalStorage

Easiest Local Storage management with shared_preferences

  ULocalStorage.set("key1", "value");
  ULocalStorage.set("key2", 1);
  ULocalStorage.set("key3", 4.5);
  ULocalStorage.set("key4", true);

  final String? key1 = ULocalStorage.getString("key1");
  final int? key2 = ULocalStorage.getInt("key2");
  final double? key3 = ULocalStorage.getDouble("key3");
  final bool? key4 = ULocalStorage.getBool("key4");

ULocation

Get User's location geolocator

final Position? position = await ULocation.getUserLocation();

UNavigator

Navigation Between Pages without context.

  UNavigator.push(const ProfilePage());
  UNavigator.off(const ProfilePage(), preventDuplicates: false);
  UNavigator.offAll(const ProfilePage(), milliSecondDelay: 100, transition: Transition.fadeIn);
  UNavigator.dialog(const ProfilePage());
  UNavigator.dialogAlert(const ProfilePage());
  UNavigator.back();