flutter_utils_extensions 0.0.2
A comprehensive set of handy Dart and Flutter extensions to make your code cleaner, shorter, and more expressive.
🧰 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 nearestFormStateusingcontext.form. -
navigator– Shorthand forNavigator.of(context). -
overlay– Access the currentOverlayStatefrom the context. -
scaffold– Retrieve the nearestScaffoldStatewithcontext.scaffold.
ScaffoldMessenger
-
scaffoldMessenger– Quickly get theScaffoldMessengerStatefor 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– AccessMediaQueryDatafrom context. -
platformBrightness– Get the system's brightness setting (Brightness.darkorBrightness.light). -
platformInDarkMode– Returnstrueif 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 (portraitorlandscape). -
isLandscape/isPortrait– Easy checks for current orientation. -
widgetShortestSide– Useful for responsive layouts based on the device's shortest screen edge. -
isPhone– Returnstrueif 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)– Returnstrueif the date is the same calendar day asother. -
isInPast()/isInFuture()– Check if the datetime is before or after now. -
isExpired()– A semantic shortcut forisInPast(). -
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 usingintl. -
toTimeAgoString()– Human-readable "time ago" format (e.g. "2 days ago"). -
toTimeString()– Convert to time only (e.g.14:35or14: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>()– Returnsnullonly in debug mode; retains value in release/profile. Useful for testing nullable flows. -
onlyOnDebug<T>()– Returns the value only in debug mode, otherwisenull. -
maybe<T>({double probability = 0.5})– Randomly returnsnullbased 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 anImageProviderto aCircleAvatarwidget 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)– Returnstrueif the number is greater. -
isLessThan(otherNum)– Returnstrueif 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})– Forintordouble, generates a random value less than the current one, starting from themin. -
randomMore(max)– Generates a random value greater than the current one, up tomax.
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 aDateTimeobject. -
toRegExp()– Converts the string into aRegExp. -
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 aCenter. -
expanded([flex = 1])– Wraps widget in anExpanded. -
flexible({flex = 1, fit = FlexFit.loose})– Wraps widget in aFlexible. -
opacity(opacity)– Wraps widget with anOpacitywidget. -
sizedBox({width, height})– Wraps widget with aSizedBox. -
constrained({maxHeight, maxWidth, minHeight, minWidth})– Wraps widget with aConstrainedBox.
✂️ 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 usingAlign. -
positionedFill()– Fills parent constraints usingPositioned.fill.
👻 Visibility Helpers
-
hideIf(condition)– Hides widget (returnsSizedBox.shrink()) ifconditionis true. -
hideUnless(condition)– Hides widget unlessconditionis true. -
showIf(condition)– Shows widget ifconditionis true, otherwise hides. -
showUnless(condition)– Shows widget unlessconditionis 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 anInkWellfor tap detection. -
onTap()– Wraps child withInkWellfor tap gesture. -
onDoubleTap()– Wraps child withInkWellfor double-tap gesture. -
onLongPress()– Wraps child withInkWellfor long-press gesture.
Tip: Used alongside the
inkWellManagerextension 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! 🚀💙