🧩 Context Helpers #

A lightweight Flutter utility package providing expressive and powerful extensions on BuildContext.

Simplify access to MediaQuery, Theme, Navigation, Localization, and Responsive utilities — making your UI code cleaner, faster, and more readable.

✨ Features #

🚀 Getting Started #

Installation #

Add context_helpers to your pubspec.yaml:

dependencies:
  context_helpers: ^1.0.0

Then run:

flutter pub get

Import #

import 'package:context_helpers/context_helpers.dart';

💡 Usage Examples #

Basic Example #

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

class HomePage extends StatelessWidget {
  const HomePage({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Width: ${context.width.toStringAsFixed(0)}'),
        backgroundColor: context.colorScheme.primary,
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            // Locale Access
            Text(
              'Locale: ${context.locale.languageCode.toUpperCase()}',
              style: context.textTheme.headlineMedium,
            ),
            
            const SizedBox(height: 20),
            
            // Responsive Detection
            Text(
              'Device Type: ${context.isMobile ? "📱 Mobile" : context.isTablet ? "📱 Tablet" : "💻 Desktop"}',
              style: context.textTheme.titleLarge,
            ),
            
            const SizedBox(height: 30),
            
            // SnackBar Helper
            ElevatedButton(
              onPressed: () => context.showSnackBar('Hello from Context Helpers! 👋'),
              child: const Text('Show Snackbar'),
            ),
            
            const SizedBox(height: 10),
            
            // Navigation Helper
            ElevatedButton(
              onPressed: () => context.push(const SecondPage()),
              child: const Text('Navigate to Second Page'),
            ),
          ],
        ),
      ),
    );
  }
}

class SecondPage extends StatelessWidget {
  const SecondPage({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Second Page')),
      body: Center(
        child: ElevatedButton(
          onPressed: () => context.pop(),
          child: const Text('⬅️ Go Back'),
        ),
      ),
    );
  }
}

Responsive Layout Example #

Widget build(BuildContext context) {
  return Container(
    width: context.width,
    height: context.height * 0.5,
    child: Center(
      child: Text(
        context.isMobile
            ? '📱 Mobile Layout'
            : context.isTablet
                ? '📱 Tablet Layout'
                : '💻 Desktop Layout',
        style: context.textTheme.headlineSmall?.copyWith(
          color: context.colorScheme.primary,
        ),
      ),
    ),
  );
}

Theme Access Example #

Container(
  color: context.colorScheme.primaryContainer,
  child: Text(
    'Styled with Theme Colors',
    style: context.textTheme.bodyLarge?.copyWith(
      color: context.colorScheme.onPrimaryContainer,
    ),
  ),
)

Localization Example #

Column(
  children: [
    Text('Language: ${context.languageCode}'),
    Text('Country: ${context.countryCode}'),
    Text('Full Locale: ${context.locale}'),
  ],
)

⚙️ Complete API Reference #

📏 Size & Dimensions #

🎨 Theme Access #

🧭 Navigation #

🌍 Localization #

📱 Responsive Utilities #

⚡ UI Helpers #

🔧 Setup for Localization #

To use localization features, configure your MaterialApp:

import 'package:flutter/material.dart';
import 'package:flutter_localizations/flutter_localizations.dart';
import 'package:context_helpers/context_helpers.dart';

void main() => runApp(const MyApp());

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Context Helpers Demo',
      
      // Add localization delegates
      localizationsDelegates: const [
        GlobalMaterialLocalizations.delegate,
        GlobalWidgetsLocalizations.delegate,
        GlobalCupertinoLocalizations.delegate,
      ],
      
      // Define supported locales
      supportedLocales: const [
        Locale('en', 'US'),
        Locale('hi', 'IN'),
        Locale('es', 'ES'),
      ],
      
      home: const HomePage(),
    );
  }
}

🔧 Platform Support #

🐛 Troubleshooting #

Error: Undefined name 'GlobalWidgetsLocalizations' #

Solution: Add the import at the top of your file:

import 'package:flutter_localizations/flutter_localizations.dart';

Error: No MaterialLocalizations found #

Solution: Ensure you've added localizationsDelegates and supportedLocales in your MaterialApp:

MaterialApp(
  localizationsDelegates: const [
    GlobalMaterialLocalizations.delegate,
    GlobalWidgetsLocalizations.delegate,
  ],
  supportedLocales: const [Locale('en', 'US')],
  // ...
)

🤝 Contributing #

Contributions are welcome! If you'd like to add new helpers or improve existing ones:

1. Fork this repository
2. Create a feature branch (git checkout -b feature/amazing-helper)
3. Commit your changes (git commit -m 'Add amazing helper')
4. Push to the branch (git push origin feature/amazing-helper)
5. Open a Pull Request

Ideas for Contributions #

• context.deviceType - Enhanced device detection
• context.safePadding - Safe area padding access
• context.responsive() - Widget builder for responsive layouts
• context.textScale - Text scaling factor
• More theme shortcuts and utilities

📄 License #

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

🧑‍💻 Author #

Rahul Sharma

• 🐙 GitHub: @rahulk3sharmadev
• 📧 Email: rahulk3sharmadev@gmail.com
• 💼 LinkedIn: Rahul Sharma

💖 Support This Package #

If you find Context Helpers useful:

• ⭐ Star this repo on GitHub
• 👍 Like it on pub.flutter-io.cn
• 🐞 Report issues or request features here
• 📢 Share with the Flutter community

🗺️ Roadmap #

• ❌ Add context.responsive() widget builder
• ❌ Add context.textScale shortcut
• ❌ Add context.safeArea and context.inset helpers
• ❌ Add context.appTheme for theme extensions
• ❌ Add context.mediaQuery for full MediaQueryData access
• ❌ Comprehensive unit tests for all helpers
• ❌ Add more navigation helpers (pushReplacement, pushAndRemoveUntil)

📈 Changelog #

See CHANGELOG.md for a detailed version history.

🙏 Acknowledgments #

Inspired by community-driven context extensions from:

• flutter_hooks
• velocity_x
• get

Special thanks to the Flutter community for continuous inspiration and excellent open-source practices.

Made with ❤️ by Rahul Sharma

Happy Coding! 🚀