License Platform

Pub Version Pub.dev Score Pub Likes Pub.dev Publisher Downloads

Build Status Issues Last Commit Contributors

🧰 Flutter Extension Utils

Extensions that just make sense.

A handy collection of Dart and Flutter extension methods to supercharge your development experience — clean syntax, reusable logic, and expressive code, all in one lightweight package.

Designed to save you time, reduce boilerplate, and improve readability across widgets, strings, numbers, booleans, and BuildContext.

🔌 Installation & Setup

The package can be installed using the command

flutter pub add flutter_utils_extensions

And can then be imported using

import 'package:flutter_utils_extensions/flutter_utils_extensions.dart';

🚀 Features

🧱 BuildContext Extensions

  • form – Easily access the nearest FormState using context.form.

  • navigator – Shorthand for Navigator.of(context).

  • overlay – Access the current OverlayState from the context.

  • scaffold – Retrieve the nearest ScaffoldState with context.scaffold.

ScaffoldMessenger

  • scaffoldMessenger – Quickly get the ScaffoldMessengerState for showing snackbars and more.

  • void showSnackBar(String content, {Duration? duration, SnackBarBehavior behavior = SnackBarBehavior.fixed}) - Quickly show a SnackBar without manually accessing ScaffoldMessenger.

Media Query

  • mediaQuery – Access MediaQueryData from context.

  • platformBrightness – Get the system's brightness setting (Brightness.dark or Brightness.light).

  • platformInDarkMode – Returns true if the app is currently in dark mode.

  • widgetSize – Get the rendered size of the widget associated with the context.

  • widgetHeight – Convenience getter for just the height of the widget.

  • widgetWidth – Convenience getter for just the width.

Media Query Orientation

  • orientation – Access the current screen orientation (portrait or landscape).

  • isLandscape / isPortrait – Easy checks for current orientation.

  • widgetShortestSide – Useful for responsive layouts based on the device's shortest screen edge.

  • isPhone – Returns true if the device is considered a phone.

  • isSmallTablet, isLargeTablet – Classify tablets based on width.

  • isTablet – Shortcut combining both small and large tablets.

  • isDesktop – Detects larger screens, typically desktops.

🗓️ DateTime Extensions

✅ Checkers

  • isAfternoon() – Checks if the time is between 12:00 PM and 5:59 PM.

  • isMorning() – Checks if the time is before 12:00 PM.

  • isEvening() – Checks if the time is between 6:00 PM and 8:59 PM.

  • isNight() – Checks if the time is after 9:00 PM.

  • isToday() / isTomorrow() / isYesterday() – Quickly check the relation to the current day.

  • isSameDay(DateTime other) – Returns true if the date is the same calendar day as other.

  • isInPast() / isInFuture() – Check if the datetime is before or after now.

  • isExpired() – A semantic shortcut for isInPast().

  • isAgeOlder(age) / isAgeYounger(age) / isAgeEqualTo(age) – Check against an age.

  • isAgeBetween(min, max) – Check if the age is within a given range.

🔧 Manipulators

  • addDays(int) / addMonths(int) / addYears(int) – Add to the datetime.

  • addHours(int) / addMinutes(int) / addSeconds(int) – Add smaller units.

  • subDays(int) / subMonths(int) / subYears(int) – Subtract from the datetime.

  • subHours(int) / subMinutes(int) / subSeconds(int) – Subtract smaller units.

🧠 Time to String

  • toAge() – Convert the date to an age in years.

  • toDateString({String format = "yyyy-MM-d"}) – Format as a custom date string.

  • toDateStringUK() – Format in British style (dd/MM/yyyy).

  • toDateStringUS() – Format in US style (MM/dd/yyyy).

  • toDateTimeString() – Full readable datetime string.

  • toFormat(String format) – Fully custom format using intl.

  • toTimeAgoString() – Human-readable "time ago" format (e.g. "2 days ago").

  • toTimeString() – Convert to time only (e.g. 14:35 or 14:35:59).

  • toShortDate() – Returns a short formatted date string (e.g. Apr 25, 2025).

  • toDayOrdinal() – Get the day of the month with ordinal (e.g. 1st, 22nd, 31st).

⏳ Duration Extensions

  • delay([callback]) – Delays execution for the given duration. Optionally accepts a callback to run after the delay.
// Example
await 2.seconds.delay(() {
  print('Delayed by 2 seconds');
});

🌀 Dynamic Extensions

  • nullOnDebug<T>() – Returns null only in debug mode; retains value in release/profile. Useful for testing nullable flows.

  • onlyOnDebug<T>() – Returns the value only in debug mode, otherwise null.

  • maybe<T>({double probability = 0.5}) – Randomly returns null based on the given probability (between 0.0 and 1.0). Great for simulating unreliable data in tests or dev mode.

final value = 'Simulate me'.maybe(probability: 0.3);
// Has a 30% chance of being null

🖼️ Image Extensions

  • circleAvatar({ ... }) – Quickly convert an ImageProvider to a CircleAvatar widget with full customisation options.
// Example
NetworkImage('https://example.com/pic.jpg').circleAvatar(radius: 40);

Parameters:

  • backgroundColor – Background colour of the avatar (default is transparent).
  • radius – Sets the circular radius of the avatar.
  • minRadius / maxRadius – Optional constraints.
  • foregroundColor – Colour for the foreground image.
  • onBackgroundImageError / onForegroundImageError – Handle image load failures.

🔢 Number Extensions

🧮 General Num Extensions

  • isEqual(otherNum) – Checks if two numbers are exactly equal.

  • isGreaterThan(otherNum) – Returns true if the number is greater.

  • isLessThan(otherNum) – Returns true if the number is less.

  • clampMin(min) – Clamps the number to a minimum value.

  • clampMax(max) – Clamps the number to a maximum value.

🎲 Random Generators

  • randomLess({min = 1.0}) – For int or double, generates a random value less than the current one, starting from the min.

  • randomMore(max) – Generates a random value greater than the current one, up to max.

10.randomLess(); // e.g. returns 3, 7, etc.
5.5.randomMore(10.0); // e.g. returns 6.23, etc.

💰 Number Formatting

  • formatAsCurrency({locale, symbol, decimalDigits}) – Formats the number as currency.

  • formatAsDecimal({locale, decimalDigits}) – Formats the number as a decimal with specified precision.

  • formatAsNumber({locale}) – Formats as a regular number string.

1234.5.formatAsCurrency(locale: 'en_NG', symbol: '₦'); // ₦1,234.50

⏱️ Number to Duration

  • days, hours, minutes, seconds, milliseconds, microseconds – Shorthand for converting numbers to Duration.
// Example
await 2.seconds.delay(); // Waits for 2 seconds

🔤 String Extensions

✅ Utilities

  • matchesRegExp(regex) – Checks if the string matches a given regular expression.

  • toBool – Converts "true" or "false" to a boolean.

  • toDateTime() – Parses the string into a DateTime object.

  • toRegExp() – Converts the string into a RegExp.

  • limit(maxLength, [overflow = "…"]) – Limits string length with optional overflow characters.

  • mask({start = 2, end = 2, maskChar = '*', maskLength}) – Masks the middle of the string, leaving edges visible.

'08012345678'.mask(); // 08*******78
'08012345678'.mask(maskLength: 2); // 08**78

🎀 Pretty Printing

  • prettyJson() – Formats a raw JSON string.

  • prettyXml() – Formats raw XML into readable indents.

  • prettyYaml() – Formats YAML strings prettily.

🔠 Casing

  • camelCase – Converts string to camelCase.

  • capitalised – Capitalises the first letter of each word.

  • kebabCase – Converts string to kebab-case.

  • pascalCase – Converts string to PascalCase.

  • snakeCase – Converts string to snake_case.

  • titleCase – Converts string to Title Case.

'the big brown fox'.camelCase; // theBigBrownFox
'the big brown fox'.capitalised; // The big brown fox
'the big brown fox'.pascalCase; // TheBigBrownFox
'the big brown fox'.kebabCase; // the-big-brown-fox
'the big brown fox'.snakeCase; // the_-_big_-_brown_-_fox
'the big brown fox'.titleCase; // The Big Brown Fox

🧪 Case and Pattern Checkers

Case Checkers

  • isCamelCase

  • isPascalCase

  • isSnakeCase

  • isKebabCase

  • isTitleCase

  • isCapitalised

  • isUpperCase

  • isLowerCase

Pattern Checkers

  • isEmail

  • isURL

  • isUlid

  • isUuid

  • isSlug

  • isHexColor

  • isIPAddress

  • isNum – Validates numeric string

  • isAlphabetOnly

  • isNumericOnly

🧩 Widget Extensions

🪄 Basic Transformations

  • center({heightFactor, widthFactor}) – Wraps widget in a Center.

  • expanded([flex = 1]) – Wraps widget in an Expanded.

  • flexible({flex = 1, fit = FlexFit.loose}) – Wraps widget in a Flexible.

  • opacity(opacity) – Wraps widget with an Opacity widget.

  • sizedBox({width, height}) – Wraps widget with a SizedBox.

  • constrained({maxHeight, maxWidth, minHeight, minWidth}) – Wraps widget with a ConstrainedBox.

✂️ Clipping

  • clipRect() – Clips widget to a rectangle.

  • clipRRect(borderRadius) – Clips widget with rounded corners.

  • clipRounded([radius = 12]) – Quickly clip widget with a uniform rounded border.

🧹 Padding

  • paddingAll(padding) – Adds equal padding on all sides.

  • paddingSymmetric({horizontal, vertical}) – Adds symmetric horizontal and vertical padding.

  • paddingOnly({left, top, right, bottom}) – Custom padding for specific sides.

  • paddingZero() – Adds zero padding.

🧭 Positioning

  • positionAlign(alignment) – Aligns widget using Align.

  • positionedFill() – Fills parent constraints using Positioned.fill.

👻 Visibility Helpers

  • hideIf(condition) – Hides widget (returns SizedBox.shrink()) if condition is true.

  • hideUnless(condition) – Hides widget unless condition is true.

  • showIf(condition) – Shows widget if condition is true, otherwise hides.

  • showUnless(condition) – Shows widget unless condition is true.

🔘 inkwellManager on Widget

A helper class for managing taps on a widget in a cleaner way.

  • inkWellManager(callback, {color = Colors.transparent}) – Wraps widget with an InkWell for tap detection.

  • onTap() – Wraps child with InkWell for tap gesture.

  • onDoubleTap() – Wraps child with InkWell for double-tap gesture.

  • onLongPress() – Wraps child with InkWell for long-press gesture.

Tip: Used alongside the inkWellManager extension to easily attach tap interactions without boilerplate.

Text('Click Me')
  .inkWellManager(() => print('Tapped'), color: Colors.black)
  .onTap();
💡 Why InkWellManager?

Normally, to make a widget respond to taps, you must manually wrap it inside an InkWell every time, setting colours and callbacks. InkWellManager simplifies this by providing quick .onTap(), .onDoubleTap(), and .onLongPress() methods — making your code shorter, cleaner, and more maintainable.

It also auto-applies the same splash, hover, and focus colours without extra setup.

Usage

To use, simply import the package into your project and you can then all of the extensions it provdes 🫶🏾

import 'package:flutter_utils_extensions/flutter_utils_extensions.dart';

📢 Additional Information

🤝 Contributing

Contributions are highly welcome! If you have ideas for new extensions, improvements, or fixes, feel free to fork the repository and submit a pull request.

Please make sure to:

  • Follow the existing coding style.
  • Write tests for new features.
  • Update documentation if necessary.

Let's build something amazing together!

🐛 Reporting Issues

If you encounter a bug, unexpected behaviour, or have feature requests:

  • Open an issue on the repository.
  • Provide a clear description and steps to reproduce (if it's a bug).
  • Suggest improvements if you have any ideas.

Your feedback helps make the package better for everyone!

📜 Licence

This package is licensed under the MIT License — which means you are free to use it for commercial and non-commercial projects, with proper attribution.

See the LICENSE file for more details.

🌟 Support

If you find this package helpful, please consider giving it a ⭐️ on GitHub — it motivates and helps the project grow!

You can also support by:

  • Sharing the package with your friends, colleagues, and tech communities.
  • Using it in your projects and giving feedback.
  • Contributing new ideas, features, or improvements.

Every little bit of support counts! 🚀💙

Libraries

flutter_utils_extensions