flutter_utils_code

A lightweight, zero-dependency Dart & Flutter utility and extension library. Designed to improve development efficiency with type-safe extensions and smart layout helpers.

🌐 简体中文文档 (Chinese Simplified)

---

Features

• ⚡ Extension Methods: Kotlin-like extensions on BuildContext, DateTime, num, Color, List?, String? and Widget.
• 🛠️ Safe Platform Check: Detect web, mobile, and desktop operating systems safely without crashing on Web platforms.
• 🎨 Smart Layout Helpers: Gap widget which automatically adapts to Row/Column orientation.
• ⏳ Lifecycle States: Track widget visible state easily with LifeState.
• 🔒 High Performance & Zero Dependency: No external package dependencies, clean codebase.

---

Installation

Add flutter_utils_code to your pubspec.yaml:

dependencies:
  flutter_utils_code: ^0.2.0

Or run:

flutter pub add flutter_utils_code

---

Usage Examples

1. BuildContext Extensions

import 'package:flutter_utils_code/extens.dart';

Widget build(BuildContext context) {
  // Theme & Colors
  final primaryColor = context.colorScheme.primary;
  final isDark = context.isDarkMode;

  // Media Query (Screen metrics)
  final width = context.screenWidth;
  final height = context.screenHeight;

  // Simple Navigation
  context.push(NextPage());
  context.pop();

  // Quick SnackBar
  context.showSnackBar("Success!");
}

2. num & Duration Extension

import 'package:flutter_utils_code/extens.dart';

final delay = 500.milliseconds; // Duration(milliseconds: 500)
final timeout = 5.seconds;       // Duration(seconds: 5)
final duration = 2.hours;        // Duration(hours: 2)

// Double formatting
print(1.2345.toMyStringAsFixed(2)); // "1.23"
print(1.0.toMyDouble(2));            // "1" (removes trailing .0)
print(1.2.toMyDouble(2));            // "1.20"

3. DateTime Extensions

import 'package:flutter_utils_code/extens.dart';

final date = DateTime.now();

if (date.isToday) { ... }
if (date.isYesterday) { ... }

final start = date.startOfDay; // 00:00:00.000
final end = date.endOfDay;     // 23:59:59.999

final leap = date.isLeapYear;   // Is leap year
final days = date.daysInMonth;  // Days in current month

final future = date.addDays(5);     // Date + 5 days
final past = date.subtractDays(2);  // Date - 2 days

4. Smart Gap Widget

import 'package:flutter_utils_code/widget.dart';

// In Column: acts as Vertical space (height: 16)
Column(
  children: [
    Text("Title"),
    Gap(16),
    Text("Subtitle"),
  ],
)

// In Row: acts as Horizontal space (width: 8)
Row(
  children: [
    Icon(Icons.star),
    Gap(8),
    Text("Rating"),
  ],
)

5. Color Extensions & Hex Parsing

import 'package:flutter_utils_code/extens.dart';

// Hex Parsing (Supports 3, 6, and 8 digit Hex format, with or without '#')
final color = ColorExt.fromHex('#FF5733');
final color2 = ColorExt.fromHex('FFF'); // #FFFFFF

// To Hex String
print(color.toHex()); // "#FF5733"

// Darken & Lighten shades
final darkColor = color.darken(0.2);
final lightColor = color.lighten(0.1);

6. Event Filter (Debounce & Throttle)

import 'package:flutter_utils_code/utils.dart';

// Throttle a button tap for 500ms
ElevatedButton(
  onPressed: () {
    EventFilter.execute("submit_btn", () {
      submitData();
    }, duration: Duration(milliseconds: 500), filterType: FilterType.throttle);
  },
  child: Text("Submit"),
)

7. Safe Platform Check

import 'package:flutter_utils_code/utils.dart';

// Safe check, will NOT crash on Web platform
if (PlatformUtils.isWeb) {
  print("Running in browser");
} else if (PlatformUtils.isAndroid || PlatformUtils.isIOS) {
  print("Running on mobile app");
}

---

APIs Reference

Extensions

• BuildContextExt: Quick access to Theme, MediaQuery, routing, and SnackBars.
• DateTimeExt: Today/Yesterday helper, start/end of day, days in month, and day arithmetic.
• NumDurationExt: Kotlin-like .seconds, .milliseconds, .hours duration syntax.
• ColorExt: Hex parsing/formatting, color shade adjustment.
• ListExt: Safe isNullOrEmpty, isNotNullOrEmpty, and list-to-comma string conversion.
• StringExt: Safe parsing to int and double with fallback default values, .trimAll(), .capitalizeFirst().
• WidgetExt: Tap throttle wrapping, layout wrapping (.padding(), .expand(), .center(), .align()).

Utilities & Widgets

• PlatformUtils: Secure and safe platform checking.
• FileUtils: Read human-readable file sizes (.renderSize()), filename extraction.
• RegexUtils: Formats validation (simple/exact mobile, emails).
• LifeState: Detect page visibility and lifecycle transitions (resumed/paused).
• Gap: Automatic layout spacer widget for Column/Row.

---

LICENSE

MIT License

Libraries

base

extens

flutter_utils_code

utils

widget