Adaptive Design Utils

A lightweight yet powerful Flutter package for creating adaptive and responsive applications. This package provides a rich set of utilities and widgets to help you build apps that look great on any device and screen size, with zero external dependencies.

Features

1. Device-Specific Utilities

• Automatic device type detection (phone, tablet, desktop)
• Platform-specific UI adaptations
• Dark mode detection
• Notch detection
• Safe area handling
• Platform-specific animations and styling

2. Advanced Layouts

• ResponsiveGrid for adaptive grid layouts
• ResponsiveMasonry for Pinterest-style layouts
• ResponsiveStaggeredGrid for dynamic grid layouts
• AdaptiveContainer for responsive containers

3. Advanced Typography

• Responsive text scaling
• Material 3 text theme support
• Custom font size constraints
• Adaptive text widget

4. Screen Utils

• Zero-dependency responsive measurements
• Adaptive sizing
• Screen size categories
• Orientation handling

4. Responsive Extensions

• Quick and easy responsive sizing
• Simplified widget creation
• Consistent design across devices

// Responsive SizedBox
20.height  // SizedBox(height: 20)
20.width   // SizedBox(width: 20)

// Responsive padding
Padding(padding: 10.p)   // All-side padding
Padding(padding: 10.ph)  // Horizontal padding
Padding(padding: 10.pv)  // Vertical padding

// Responsive font sizing
Text('Hello', style: TextStyle(fontSize: 16.sp))

5. Alert Utilities

• Responsive and customizable dialogs
• Easy-to-use snackbar methods
• Consistent styling across alerts

// Dialogs
Alert.showErrorDialog(
  context, 
  message: 'Something went wrong',
  onClose: () {
    // Optional callback after dialog closes
  }
);

Alert.showSuccessDialog(
  context, 
  message: 'Operation completed successfully'
);

// Confirmation Dialog
bool result = await Alert.showConfirmationDialog(
  context, 
  message: 'Do you want to proceed?'
);

// Snackbars
Alert.showErrorSnackBar(context, message: 'Error occurred');
Alert.showSuccessSnackBar(context, message: 'Success!');
Alert.showWarningSnackBar(context, message: 'Warning message');

6. Breakpoint Management

• Pre-defined breakpoints
• Custom breakpoint creation
• Device-specific layouts

Getting Started

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

dependencies:
  adaptive_design_utils: ^0.0.4

Usage

Initialization

import 'package:adaptive_design_utils/adaptive_design_utils.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Builder(
        builder: (context) {
          // Initialize the package
          AdaptiveDesignUtils.initialize(context);
          return HomePage();
        },
      ),
    );
  }
}

Responsive Grid Layout

ResponsiveGrid(
  children: [
    // Your grid items
  ],
  mobileCrossAxisCount: 1,
  tabletCrossAxisCount: 2,
  desktopCrossAxisCount: 4,
  spacing: 16.0,
  childAspectRatio: 1.0,
)

Masonry Layout

ResponsiveMasonry(
  children: [
    // Your masonry items
  ],
  mobileColumns: 1,
  tabletColumns: 2,
  desktopColumns: 3,
  spacing: 16.0,
)

Adaptive Container

AdaptiveContainer(
  child: YourWidget(),
  mobileWidth: double.infinity,
  tabletWidth: 680,
  desktopWidth: 1024,
  padding: EdgeInsets.all(16),
  backgroundColor: Colors.white,
  borderRadius: 8.0,
)

Screen Utils

// Get adaptive measurements
double width = ScreenUtils.adaptiveWidth(100);
double height = ScreenUtils.adaptiveHeight(50);
double fontSize = ScreenUtils.adaptiveFontSize(16);

// Get screen information
double screenWidth = ScreenUtils.screenWidth;
double screenHeight = ScreenUtils.screenHeight;
bool isLandscape = ScreenUtils.isLandscape;

Device Utils

// Check device type
final deviceType = await DeviceUtils.getDeviceType();

// Check dark mode
final isDark = DeviceUtils.isDarkMode(context);

// Get platform-specific styling
final cornerRadius = DeviceUtils.getPlatformRadius();
final animationDuration = DeviceUtils.getPlatformDuration();

Advanced Typography

// Using predefined styles
Text(
  'Headline',
  style: AdaptiveTypography.headline1(context),
)

// Using adaptive text widget
AdaptiveText(
  'Responsive Text',
  style: TextStyle(fontSize: 20),
  minFontSize: 14,
  maxFontSize: 24,
)

Example

Check out the example folder for a complete demo application showcasing all features.

Additional Information

• API Documentation
• GitHub Repository
• Bug Reports

Features and bugs

Please file feature requests and bugs at the issue tracker.

Author

Sheeraz Ali

Flutter Developer passionate about creating tools that make app development easier and more efficient.

• 📧 Email: sheerazali.dev@gmail.com
• 🌐 GitHub: @thesheerazali
• 💼 LinkedIn: Sheeraz Ali
• ☕ Buy me a coffee: thesheerazali

Support

If you find this package helpful, consider supporting its development:

• ⭐ Star the repository on GitHub
• 💖 Sponsor on GitHub Sponsors
• ☕ Buy me a coffee on Buy Me a Coffee

License

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