https://github.com/vkashegde/smart_utils
A comprehensive Flutter utility package providing essential helper classes for date/time manipulation, string operations, device information, logging, and widget utilities. https://pub.dev/packages/smart_utils_plus
https://github.com/vkashegde/smart_utils
datetime-format flutter internet-connection package packages utility utility-library utils
Last synced: 26 days ago
JSON representation
A comprehensive Flutter utility package providing essential helper classes for date/time manipulation, string operations, device information, logging, and widget utilities. https://pub.dev/packages/smart_utils_plus
- Host: GitHub
- URL: https://github.com/vkashegde/smart_utils
- Owner: vkashegde
- License: mit
- Created: 2025-11-09T10:06:34.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-03-12T17:51:30.000Z (3 months ago)
- Last Synced: 2026-03-12T22:46:49.374Z (3 months ago)
- Topics: datetime-format, flutter, internet-connection, package, packages, utility, utility-library, utils
- Language: Dart
- Homepage:
- Size: 164 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Smart Utils Plus
A comprehensive Flutter utility package providing essential helper classes for date/time manipulation, string operations, device information, logging, widget utilities, number formatting, and responsive design.
## Features
- 📅 **DateUtilsPlus** - Human-readable date & time formatting
- 🔤 **StringUtilsPlus** - String manipulation and validation utilities
- 📱 **DeviceUtilsPlus** - Device, platform, and connectivity information
- 🎨 **WidgetUtilsPlus** - Common widget helpers (snackbars, loaders, dialogs, bottom sheets)
- 📝 **LoggerPlus** - Colorful console logger for Flutter & Dart
- 📏 **ContextSizeHelper** - Context extensions for layout helpers
- 📊 **NumberUtilsPlus** - Number formatting, currency, percentages, and math utilities
- 📐 **ResponsiveUtilsPlus** - Breakpoint-based responsive design utilities
## Getting Started
Add this package to your `pubspec.yaml`:
```yaml
dependencies:
smart_utils_plus: ^0.0.1
```
Then run:
```bash
flutter pub get
```
## Usage
### DateUtilsPlus
```dart
import 'package:smart_utils_plus/smart_utils_plus.dart';
// Human-readable time ago
DateUtilsPlus.timeAgo(DateTime.now().subtract(Duration(hours: 3)));
// Returns: "3 hours ago"
// Smart date time format
DateUtilsPlus.smartDateTime(DateTime.now());
// Returns: "Today 6:00 PM"
// Format date
DateUtilsPlus.format(DateTime.now(), pattern: 'yyyy-MM-dd');
// Returns: "2025-01-09"
// Check if today
DateUtilsPlus.isToday(someDate);
// Difference summary
DateUtilsPlus.diffSummary(startDate, endDate);
// Returns: "2d 5h 10m"
```
### StringUtilsPlus
```dart
import 'package:smart_utils_plus/smart_utils_plus.dart';
// Capitalize first letter
StringUtilsPlus.capitalize('hello'); // "Hello"
// Create URL-friendly slug
StringUtilsPlus.slugify('Hello World!'); // "hello-world"
// Truncate string
StringUtilsPlus.truncate('Long text here', 7); // "Long te..."
// Validate email
StringUtilsPlus.isEmail('test@example.com'); // true
// Validate URL
StringUtilsPlus.isUrl('https://flutter.dev'); // true
```
### DeviceUtilsPlus
```dart
import 'package:smart_utils_plus/smart_utils_plus.dart';
// Platform detection
DeviceUtilsPlus.isAndroid; // true/false
DeviceUtilsPlus.isIOS; // true/false
DeviceUtilsPlus.isWeb; // true/false
DeviceUtilsPlus.isDesktop; // true/false
DeviceUtilsPlus.isMobile; // true/false
// Get device info
final info = await DeviceUtilsPlus.getDeviceInfo();
// Returns: {'platform': 'Android', 'brand': 'Samsung', ...}
// Check connectivity
final hasConnection = await DeviceUtilsPlus.hasInternetConnection();
// Screen dimensions
final width = DeviceUtilsPlus.screenWidth(context);
final height = DeviceUtilsPlus.screenHeight(context);
// Orientation
DeviceUtilsPlus.isPortrait(context);
DeviceUtilsPlus.isLandscape(context);
```
### WidgetUtilsPlus
```dart
import 'package:smart_utils_plus/smart_utils_plus.dart';
// Snackbars
WidgetUtilsPlus.showSuccessSnackbar(context, "Operation successful!");
WidgetUtilsPlus.showErrorSnackbar(context, "Something went wrong!");
WidgetUtilsPlus.showInfoSnackbar(context, "Info message");
// Custom snackbar
WidgetUtilsPlus.showSnackbar(
context,
message: "Custom message",
backgroundColor: Colors.blue,
duration: Duration(seconds: 3),
);
// Toast
WidgetUtilsPlus.showToast(context, message: "Toast message");
// Loader
WidgetUtilsPlus.showLoader(context, message: "Loading...");
WidgetUtilsPlus.hideLoader(context);
// Confirm dialog
final confirmed = await WidgetUtilsPlus.showConfirmDialog(
context,
title: "Confirm",
message: "Are you sure?",
);
// Bottom sheet
await WidgetUtilsPlus.showBottomSheetPlus(
context,
child: YourWidget(),
maxHeightFraction: 0.8,
);
// Message sheet
await WidgetUtilsPlus.showMessageSheet(
context,
title: "Title",
message: "Message content",
);
```
### ContextSizeHelper
```dart
import 'package:smart_utils_plus/smart_utils_plus.dart';
// Get parent width/height as fraction
final width = context.parentWidth(0.5); // 50% of parent width
final height = context.parentHeight(0.3); // 30% of parent height
// Get remaining space
final remainingWidth = context.remainingParentWidth(usedWidth: 100);
final remainingHeight = context.remainingParentHeight(usedHeight: 200);
// Get constraints
final constraints = context.getParentConstraints();
final aspectRatio = context.parentAspectRatio();
// Get widget position and sizei have readme and everthink
final position = context.getGlobalPosition();
final size = context.getWidgetSize();
final parentPosition = context.getPositionInParent();
```
### LoggerPlus
```dart
import 'package:smart_utils_plus/smart_utils_plus.dart';
// Log messages with colors
LoggerPlus.info('Information message');
LoggerPlus.success('Success message');
LoggerPlus.warning('Warning message');
LoggerPlus.error('Error message');
LoggerPlus.debug('Debug message');
// Configure logger
LoggerPlus.isEnabled = true; // Enable/disable logging
LoggerPlus.showTimestamp = true; // Show/hide timestamp
```
### NumberUtilsPlus
```dart
import 'package:smart_utils_plus/smart_utils_plus.dart';
// Format currency
NumberUtilsPlus.formatCurrency(1234.56); // "$1,234.56"
NumberUtilsPlus.formatCurrency(1234.56, symbol: '€', decimals: 0); // "€1,235"
// Format compact numbers
NumberUtilsPlus.formatCompact(1200); // "1.2K"
NumberUtilsPlus.formatCompact(1500000); // "1.5M"
// Format percentage
NumberUtilsPlus.formatPercentage(0.1234); // "12.3%"
// Random numbers
NumberUtilsPlus.randomInt(1, 10); // Random integer between 1 and 10
NumberUtilsPlus.randomDouble(0.0, 1.0); // Random double between 0.0 and 1.0
// Rounding
NumberUtilsPlus.roundTo(3.14159, 2); // 3.14
NumberUtilsPlus.floorTo(3.14159, 2); // 3.14
NumberUtilsPlus.ceilTo(3.14159, 2); // 3.15
```
### ResponsiveUtilsPlus
```dart
import 'package:smart_utils_plus/smart_utils_plus.dart';
// Breakpoint detection
if (ResponsiveUtilsPlus.isMobile(context)) {
// Mobile-specific code
}
if (context.isTablet) {
// Tablet-specific code
}
// Responsive value selection
final padding = ResponsiveUtilsPlus.responsiveValue(
context,
mobile: 16.0,
tablet: 24.0,
desktop: 32.0,
);
// Or using extensions
final padding = context.responsivePadding(mobile: 16.0);
final fontSize = context.responsiveFontSize(mobile: 14.0, tablet: 18.0, desktop: 24.0);
final columns = context.responsiveColumns(mobile: 1, tablet: 2, desktop: 3);
// Responsive widgets
final widget = ResponsiveUtilsPlus.responsiveValue(
context,
mobile: MobileLayout(),
tablet: TabletLayout(),
desktop: DesktopLayout(),
);
// Responsive spacing and max width
final spacing = context.responsiveSpacing(mobile: 8.0, tablet: 12.0, desktop: 16.0);
final maxWidth = context.responsiveMaxWidth(
mobile: double.infinity,
tablet: 800.0,
desktop: 1200.0,
);
```
## Example
See the [example](example) directory for a complete working example.
```bash
cd example
flutter run
```
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Additional Information
For more information about the package, check out the source code and example app in this repository.