kickin_utilities 0.0.1-dev.4

A modular Flutter utilities package useful utilities such as constants, extensions, helpers, mixins, and state management.

kickin_utilities

Kickin Utilities is a modular Flutter toolkit for common app code: constants, extensions, helpers, mixins, and Riverpod utilities.

It is organized by folder, and each folder represents a feature area. Nested folders are treated as subfeatures, so the docs below follow the source tree.

---

✨ What's in the box

Feature	Description
constants/	Shared UI values such as KSpacing and KCurves
extensions/	Flutter and Dart extensions for strings, numbers, colors, context, duration, and Riverpod providers
helpers/	Reusable helper types like KResult, isolate utilities, and logger starter code
mixins/	Stateful mixins for scrolling, paging, and provider warm-up behavior
state_mgmt/	State-management helpers organized by subfeature folders such as riverpod/

---

Constants

Shared values for motion and layout.

src/constants/src/spacing.dart

KSpacing provides common spacing tokens for Flutter layouts.

Container(padding: const EdgeInsets.all(KSpacing.md));

Available sizes: xxs, xs, sm, md, lg, xl, xxl, xxxl, huge, and massive.

src/constants/src/curves.dart

KCurves provides a set of spring-based and easing curves for consistent motion.

Examples include:

• instantSpring
• defaultIosSpring
• bouncySpring
• snappySpring
• interactiveSpring
• fastInSlowOut
• linear, ease, decelerate, fastSlowInOut
• bounceOut, bounceIn
• easeOutSine, easeInOutSine, easeOutCirc, easeInOutCirc

---

Extensions

Small convenience extensions for Flutter and Dart APIs.

src/extensions/src/extension_on_string.dart

String.decodeJson decodes a JSON string into a Map or list-like structure.

final data = '{"name":"Ada"}'.decodeJson;

src/extensions/src/extension_on_num.dart

Numeric helpers for durations and widget gaps.

• inMicroseconds
• inMs
• inMilliseconds
• inSeconds
• inMinutes
• inHours
• inDays
• toHBox
• toVBox
• toHSliverBox
• toVSliverBox

await 500.inMs.delay();
final gap = 16.toVBox;

src/extensions/src/extension_on_color.dart

Color.lightenColor() returns a lighter color using HSL lightness.

src/extensions/src/extension_on_context.dart

BuildContext helpers for theme, media query, and layout values.

• theme
• scaffoldBackgroundColor
• platformBrightness
• isDarkMode
• mediaQuery
• screenSize
• deviceWidth
• deviceHeight
• viewInsets
• padding
• topPadding
• bottomPadding

src/extensions/src/extension_on_duration.dart

Duration.delay() is a small wrapper over Future.delayed.

src/extensions/src/extension_on_providers.dart

Riverpod provider shortcuts for ProviderListenable, AsyncProviderListenable, Ref, WidgetRef, NotifierProvider, and AsyncNotifierProvider.

• read / watch / readX / watchX
• emptyListenMany
• keepAliveFor
• not, notX, watchNot, watchNotX
• expand, expandX

---

Helpers

Utility types for results and isolate execution.

src/helpers/src/result.dart

KResult<T> wraps loading, success, and error states.

Use it when you want to avoid repeating try/catch blocks around asynchronous work.

final result = await KResult.tryRunAsync(() async => fetchUser());
if (result.isSuccess) {
  print(result.value);
}

Key helpers:

• KResult.loading()
• KResult.success()
• KResult.error()
• tryRunAsync()
• tryRun()
• tryRunEither()
• doNext()
• then()
• onError()

src/helpers/src/isolate.dart

Isolate utilities for one-shot work and persistent workers.

KIsolate<TArg, TProgress, TResult>

Runs a single task in a dedicated isolate and supports progress callbacks.

KIsolateContinuous<TArg, TResult>

Runs sequential tasks inside one long-lived isolate with priority queueing and backpressure.

KIsolateAccess mixin

Convenience mixin that exposes isolateRun() and isolateSpawn().

KIsolateException

Exception type thrown when isolate spawn or execution fails.

src/helpers/src/logger.dart

This file currently contains commented-out logger starter code. It is part of the source tree, but it does not currently contribute active exported behavior.

---

Mixins

State helpers that wire controllers and provider warm-up behavior.

src/mixins/src/is_scrolled_notifier_mixin.dart

KIsScrolledNotifierMixin gives a ScrollController and a ValueNotifier<bool> that flips when the scroll offset passes the toolbar-height threshold.

src/mixins/src/scroll_offset_notifier_mixin.dart

KScrollOffsetNotifierMixin exposes the current scroll offset in a ValueNotifier<double>.

src/mixins/src/page_controller_mixin.dart

KPageControllerMixin owns and disposes a PageController.

---

Usage

Import the package from one place:

import 'package:kickin_utilities/kickin_utilities.dart';

Minimal example:

final Map profile = '{"name":"Alice"}'.decodeJson;
final wait = 500.inMs;

final result = await KResult.tryRunAsync(() async => profile['name']);

class Example extends ConsumerWidget {
  @override
  Widget build(BuildContext context, WidgetRef ref) {
    return KAbsorber.watch(counterProvider, builder: (r, count, _) {
      return Text('Count: $count');
    });
  }
}

---

Tests & Example App

The repository includes:

• test/kickin_utilities_test.dart for core package validation
• example/ for a minimal Flutter app that uses KSpacing and Riverpod notifiers

Run tests:

flutter test

Run the example app:

cd example
flutter pub get
flutter run

---

Installation

Add the package to your app:

dependencies:
  kickin_utilities:
    ^0.0.1-dev.4

Or install it with the standard command:

flutter pub add kickin_utilities

---

License

See the repository LICENSE file.