oh_my_flutter 0.3.1

Empower Flutter with utilities that make development 10x faster.

oh_my_flutter

Small, strongly typed utilities for common Flutter application tasks.

Installation

Add the latest compatible release from pub.dev:

flutter pub add oh_my_flutter

Or add it directly to your pubspec.yaml:

dependencies:
  oh_my_flutter: ^0.3.1

Import the public library wherever you need it:

import 'package:oh_my_flutter/oh_my_flutter.dart';

Quick start

Extensions make common transformations concise while preserving Flutter and Dart types:

import 'package:flutter/material.dart';
import 'package:oh_my_flutter/oh_my_flutter.dart';

final accent = const Color(0xFFFF4A4B);
final lighterAccent = accent.lighten(0.12);
final hex = lighterAccent.toHex();
final oklch = lighterAccent.toOklch();

Utilities

Present relative time

Use DateTime.timeAgo when presentation depends on elapsed time but the package should not own your wording or localization. Callbacks determine both the result type and the text shown to the user.

final label = publishedAt.timeAgo<String>(
  onNow: () => 'now',
  onMinutesAgo: (count) => '$count min ago',
  onHoursAgo: (count) => '$count hr ago',
  onDaysAgo: (count) => '$count days ago',
  onMiss: () => 'a while ago',
);

Time is read through package:clock, so applications and tests can pin the current instant without changing production code. See the API reference for bucketing and fallback behavior.

Transform colors and work with OKLCH

Use the color extensions for direct Flutter Color transformations. Convert to OKLCH when you need perceptually uniform lightness, chroma, and hue values.

final base = const Color(0xFFFF4A4B);

final lighter = base.lighten(0.12);
final darker = base.darken(0.12);
final hex = base.toHex();

final oklch = base.toOklch();
final restored = oklch.toColor();

The API reference documents supported color spaces, gamut mapping, clamping, and alpha behavior.

Classify gesture velocity

Use the Velocity extension at a drag boundary when release speed and direction should help decide whether an interaction completes.

void handleDragEnd(DragEndDetails details) {
  final shouldDismiss = details.velocity.isSwipeDown();

  if (shouldDismiss) {
    dismiss();
  }
}

The methods classify velocity only. The consuming interaction remains responsible for distance, progress, and whether the action is allowed.

Control widget visibility

Use ControlledVisibility when parent code should show or hide a child while the application retains control of its visual transition. Without a transition, visibility changes immediately.

final visibilityController = ControlledVisibilityController();

ControlledVisibility(
  controller: visibilityController,
  showDuration: const Duration(milliseconds: 240),
  hideDuration: const Duration(milliseconds: 120),
  showTransition: (child, animation) => FadeTransition(
    opacity: CurveTween(curve: Curves.easeOutCubic).animate(animation),
    child: child,
  ),
  hideTransition: (child, animation) => FadeTransition(
    opacity: animation,
    child: child,
  ),
  child: const Text('More details'),
);

visibilityController.show();
visibilityController.hide();

Set unmount: true when hidden content should be disposed instead of retaining its state and layout. Timing, lifecycle, callback, and reduced-motion behavior are documented in the API reference.

Wait for route motion to settle

Use RouteSettled for controls or route chrome that should appear only after the current route finishes moving and while no navigator gesture is active. It has no built-in visual treatment: provide either direction's transition only when the application needs one.

RouteSettled(
  showTransition: (child, animation) => FadeTransition(
    opacity: animation,
    child: child,
  ),
  child: const CloseButton(),
)

Showing takes 300 ms by default when a show transition exists. Hiding is immediate by default. Without an enclosing route, the child is treated as settled and shown.

Represent offline Dio failures

Add OfflineErrorDioInterceptor when callers need to distinguish typed offline failures from other Dio errors without scattering connectivity probes through application code.

final dio = Dio()
  ..interceptors.add(OfflineErrorDioInterceptor());

try {
  await dio.get('/jobs');
} on DioException catch (error) {
  if (error.isOfflineConnectionDioException) {
    showOfflineState();
  }
}

The original error remains available as the cause of the typed offline exception. Probe rules and timeout behavior are documented in the API reference.

Launch phone calls and WhatsApp chats

Use Telephony and Whatsapp at the boundary where application data becomes an external URI. Both utilities sanitize commonly formatted international phone numbers and report whether the platform accepted the launch.

await Telephony().call(number: '[phone]');

await Whatsapp().launchChat(
  number: '[phone]',
  message: 'Hello! I would like more information.',
);

Always include the country code. These utilities sanitize URI input; they do not verify that a phone number exists.

Documentation

• Run the complete public-API example.
• Read the generated API reference for contracts, defaults, exceptions, and focused examples.

Scope

oh_my_flutter provides portable utility APIs. It intentionally does not own application state, routing, localization, design components, or application-specific domain logic.