extensionresoft 1.2.0

Boost your Flutter development with reusable widgets, utilities, and extensions for advanced image handling, secure PIN entry, internet connectivity checks, and more.

ExtensionResoft

A comprehensive toolkit of extensions, widgets, and utilities to accelerate Flutter development with less code. ExtensionResoft optimizes common tasks, enhances UI components, and provides robust architecture patterns.

Features

🖼️ Advanced Image Handling

Create robust image components with minimal effort:

• Multi-source Support: Handle network URLs, asset paths, and file objects through a unified API
• AppImage: Rectangular images with custom border radius, intelligent error handling, and fallbacks
• AppCircleImage: Circular avatar images with placeholder and error states
• Performance Optimized: Device pixel ratio-aware caching for memory efficiency
• Decoration Support: Use as BoxDecoration background images easily

🔐 Secure PIN Authentication

Build secure user authentication flows:

• PinEntry Widget: Customizable PIN entry with multiple security configurations
• Visual Customization: Style input fields and keyboard components separately
• Validation Support: Custom handlers for completion and validation events

🌐 Internet Connectivity Management

Detect and respond to network changes reliably:

• Real-time Monitoring: Observe detailed connectivity state changes through streams
• Granular Control: Monitor specific connectivity aspects with dedicated streams
• Simplified API: Check network status with straightforward methods
• Resilient Applications: Build offline-ready features with minimal effort

🧰 UI Extension Toolkit

Write less code for common UI patterns:

• Spacing Extensions: Clean spacer syntax with both method and getter options
• Custom Cards: Create styled cards with simple radius-based extensions
• Text Styling: Format text with fluent extensions for improved readability
• Image Path Extensions: Convert asset paths to image widgets directly

🧠 Logic & Functional Extensions

Enhance code clarity and maintainance:

• Conditional Functions: Widget-friendly alternatives to ternary operators
• Path Extensions: Apply transformations to values with clean syntax
• Value Management: Robust value retrieval with fallback handling

📦 Storage Utilities

Manage persistent data efficiently:

• SharedPreferencesService: Type-safe storage for app settings and user preferences
• Support for Multiple Types: Store and retrieve booleans, strings, integers, and doubles

Getting Started

Installation

Add the package to your pubspec.yaml:

dependencies:
  extensionresoft: ^1.2.0

Then run:

flutter pub get

Basic Usage

Import the package:

import 'package:extensionresoft/extensionresoft.dart';

Usage Examples

Image Handling

// Network image with fallback and border radius
AppImage(
  'https://example.com/profile.jpg',
  width: 150,
  height: 150,
  fit: BoxFit.cover,
  borderRadius: BorderRadius.circular(8),
  backgroundColor: Colors.grey[200],
  errorWidget: Icon(Icons.broken_image),
  fallbackImage: 'assets/default_image.png',
)

// Circle avatar from network or asset
AppCircleImage(
  'assets/profile_photo.jpg', // or network URL or File object
  radius: 40,
  fit: BoxFit.cover,
  placeholder: CircularProgressIndicator(strokeWidth: 2),
  errorWidget: Icon(Icons.person),
)

// As decoration image
Container(
  decoration: BoxDecoration(
    image: AppImage('https://example.com/bg.jpg')
        .toDecorationImage(
      decorationFit: BoxFit.cover,
      fallbackImage: 'assets/default_bg.png',
    ),
  ),
)

// Path-based image extensions
'assets/image.png'.img(width: 100, height: 100)
'assets/avatar.png'.circleImage(fit: BoxFit.cover)

Internet Connectivity

// Create a checker instance
final connectionChecker = InternetConnectionChecker();

// Check current connection status
final isConnected = await connectionChecker.isInternetConnected;
print('Internet connected: $isConnected');

// Listen to detailed connectivity changes
connectionChecker.onInternetConnectivityChanged.listen((result) {
  print('Connection Status: ${result.hasInternetAccess}');
  print('Connection Type: ${result.connectionType}');
  
  // Update UI based on connectivity
  if (result.hasInternetAccess) {
    // Load online data
  } else {
    // Show offline mode UI
  }
});

// Simplified boolean stream for quick status checks
connectionChecker.onIsInternetConnected.listen((isConnected) {
  print('Internet status changed: $isConnected');
});

PIN Authentication

PinEntry(
  pinLength: 6,
  onInputComplete: (pin) {
    // Handle PIN validation
  },
  inputFieldConfiguration: InputFieldConfiguration(
    obscureText: true,
    fieldFillColor: Colors.grey[200],
    focusedBorderColor: Colors.blue,
  ),
  keyboardConfiguration: KeyboardConfiguration(
    keyBackgroundColor: Colors.white,
    keyTextStyle: TextStyle(fontSize: 24, fontWeight: FontWeight.bold),
  ),
)

UI Extensions

// Spacing utilities
16.spaceX()  // SizedBox(width: 16)
24.spaceY()  // SizedBox(height: 24)
32.spaceXY() // SizedBox(width: 32, height: 32)

// Getters for even cleaner code
20.spX  // SizedBox(width: 20)
30.spY  // SizedBox(height: 30)

// Custom card with styling
12.radius(
  child: Padding(
    padding: EdgeInsets.all(16),
    child: Text('Rounded Card Example'),
  ),
  elevation: 2,
  color: Colors.blue[50],
  strokeColor: Colors.black12,
)

// Text styling
'Hello Flutter'.edit(
  textStyle: TextStyle(
    fontSize: 20,
    fontWeight: FontWeight.bold,
    color: Colors.teal,
  ),
  textAlign: TextAlign.center,
)

Logic & Functional Extensions

// Path extension to transform values
final doubled = 16.p((n) => n * 2);  // 32

// Widget-friendly conditional logic
final result = condition(isActive, 'Active', 'Inactive');

// Function-based conditionals (lazy evaluation)
final message = conditionFunction(
  hasPermission,
  () => 'Access granted',
  () => 'Access denied: ${getErrorMessage()}',
);

// Safe value retrieval with fallback
final displayName = get(user.name, 'Guest User');

Shared Preferences

// Initialize service
await SharedPreferencesService.init();

// Store values
await SharedPreferencesService.setBool('isDarkMode', true);
await SharedPreferencesService.setString('username', 'flutter_dev');

// Retrieve values
final isDarkMode = SharedPreferencesService.getBool('isDarkMode');
final username = SharedPreferencesService.getString('username', 'guest');

Advanced Usage

See the API Reference for comprehensive documentation of all available extensions and utilities.

Migration from 1.0.0 to 1.1.0

While version 1.1.0 maintains backward compatibility, we recommend the following changes:

• Replace assetFallback with fallbackImage parameter in image widgets for improved naming consistency
• Take advantage of the new File object support in image widgets
• Utilize new borderRadius and backgroundColor parameters for enhanced customization

Screenshots

(None applicable in this current release)

Contributing

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

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/amazing-feature)
3. Commit your Changes (git commit -m 'Add some amazing feature')
4. Push to the Branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the BSD 3-Clause License - see the LICENSE file for details.