soundsliced_dart_extensions

A comprehensive collection of Dart & Flutter extensions to simplify everyday development tasks and enhance code readability. It includes rich utilities for time, formatting, collections, UI layout, JSON, colors, and more.

Features

This package provides extensive extensions for:

DateTime & Duration

  • Duration shortcuts: 5.seconds, 2.minutes, 1.hours, 3.days
  • DateTime utilities: Convert to date, adjust time, round to nearest minute
  • String parsing: Convert time strings to DateTime
  • Formatting: Easy string conversions with customizable formats

String Extensions

  • Type conversion: Parse booleans, convert to lists
  • Formatting: Capitalize sentences, beautify JSON
  • JSON utilities: Decode and beautify JSON strings

List Extensions

  • Safe access: Null-safe element access with index checking
  • Chunking: Split lists into smaller chunks
  • Sorting: Alphanumeric sorting for string lists

Color Extensions

  • Manipulation: Lighten and darken colors
  • Conversion: Convert to hex strings

EdgeInsets Extensions

  • Fluent API: Chain padding modifications
  • Smart padding: Apply first non-zero padding value
  • Modification: Add to existing padding values

TimeOfDay Extensions

  • JSON support: Serialize/deserialize
  • Conversion: Convert to Duration, DateTime, formatted strings
  • Manipulation: Add/subtract minutes, round to intervals

Additional Utilities

  • Offset utilities: Calculate distance, check direction
  • Map extensions: Convert to lists
  • Scroll controller: Animate to bottom
  • Type conversions: String to URI, various type parsers

Installation

Add this to your package's pubspec.yaml file:

dependencies:
  soundsliced_dart_extensions: ^1.0.1

Then run:

flutter pub get

Usage

Import the package:

import 'package:soundsliced_dart_extensions/soundsliced_dart_extensions.dart';

Duration Examples

// Create durations with intuitive syntax
final duration1 = 5.seconds;
final duration2 = 2.minutes;
final duration3 = 1.hours;
final duration4 = 3.days;

// Convert Duration to easy-read string
final formatted = duration1.convertToEasyReadString(); // "05 sec"

DateTime Examples

// Round datetime to nearest interval
final now = DateTime.now();
final rounded = now.toNearestMinute(nearestMinute: 15);

// Convert to date only (remove time)
final dateOnly = now.convertToDate();

// Get month name
final monthName = now.convertToMonthString(); // "JAN", "FEB", etc.

String Extensions

// Capitalize sentences
final text = "hello world. how are you?";
final capitalized = text.capitalizeFirstLetterOfEverySentence();
// "Hello world. How are you?"

// Parse boolean
final boolValue = "true".parseBool(); // true

// Convert string to list
final listString = "[item1, item2, item3]";
final list = listString.convertToListString();

Color Extensions

// Lighten/darken colors
final color = Colors.blue;
final lighter = color.lighten(0.2); // 20% lighter
final darker = color.darken(0.3);   // 30% darker

// Convert to hex
final hexColor = toHex(Colors.red); // "#FFFF0000"

EdgeInsets & Layout Extensions

Fluent & tuple based syntaxes:

final p1 = 12.leftPad; // EdgeInsets.only(left: 12)
final p2 = (8, 16).leftPad.rightPad; // left=8, right=16
final p3 = (5, 10, 15).leftPad.topPad.rightPad; // left=5, top=10, right=15
final p4 = (4, 8, 12, 16).leftPad.topPad.rightPad.bottomPad; // left=4, top=8, right=12, bottom=16

final fluent = EdgeInsets.all(10)
  .addToTop(5)
  .leftPad // copies first non-zero to left
  .rightPad; // copies that same value to right

// Fluent padding API
final padding = EdgeInsets.all(10.0)
    .withLeft(20.0)
    .addToTop(5.0);

// Smart padding (use first non-zero value)
final base = EdgeInsets.only(left: 10.0);
final samePadding = base.rightPad; // Uses left value for right

TimeOfDay Extensions

// Convert to Duration
final time = TimeOfDay(hour: 14, minute: 30);
final duration = time.convertToDuration(); // 14h 30min

// Format as string
final formatted = time.convertToStringTime(); // "14:30"

// Add/subtract minutes
final later = time.addMinutes(45); // 15:15
final earlier = time.subtractMinutes(30); // 14:00

// Round to interval
final rounded = time.toNearestMinute(nearestMinute: 15);

List & Iterable Extensions

final list = [1,2,3];
final safeValue = list.safe[10]; // null (out of range)
final firstEven = list.findFirstWhereOrNull((e) => e.isEven); // 2

// Safe element access
final list = [1, 2, 3];
final element = list.safe[10]; // null instead of error

// Check if index exists
if (list.doesIndexExist(5)) {
  print(list[5]);
}

// Split into chunks
final letters = ['a', 'b', 'c', 'd', 'e'];
final chunks = letters.splitInChunks(2); // [[a, b], [c, d], [e]]

JSON Beautifier & Parsing

Beautify maps & lists with embedded JSON strings:

final raw = {
  'id': '123',
  'payload': '{"value":42,"inner":"{\\"x\\":1}"}'
};
final pretty = raw.beautifiedJson; // formatted, nested JSON decoded

final jsonString = '{"id":"123","payload":{"value":42,"inner":{"x":1}}}';
final decoded = jsonString.decodeBeautifiedJsonMap; // nested structure recovered

BorderRadius Helpers

final circle = 12.allRad; // BorderRadius.circular(12)
final topCorners = 8.topRad; // Only top corners 8

Requirements

  • Dart SDK: >=3.0.0 <4.0.0
  • Flutter: >=3.0.0

Dependencies

  • fpdart: ^1.2.0
  • intl: ^0.20.2
  • sizer: ^3.1.3
  • xid: ^1.2.1
  • collection: ^1.19.1

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Issues

Please file issues on the GitHub repository.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Repository

https://github.com/SoundSliced/soundsliced_dart_extensions

Example Project

See example/lib/main.dart for a concise runnable showcase of the core extensions.

Libraries

soundsliced_dart_extensions