flutter_utils_project

License: MIT

Getting Started

This project is a starting point for a Flutter plug-in package, Set of methods/extensions for flutter that makes using framework in a much easier and clean way also adds additional functionality, and provide the tools and parts needed to build your project faster.

Platform Support

Android iOS MacOS Web Linux Windows
✔️ ✔️ ✔️ ✔️ ✔️ ✔️

What's in the box

  • SnapHelperWidget
  • AppTheme Dark-light.
  • AutoSizeText.
  • ContextExtensions.
  • ErrorHandler.
  • IntExtensions.
  • TextStyle.
  • StringExtension.
  • Spacing.
  • WidgetExtension.
  • Button (Type) => rounded - small - medium - text - block - outlined - large.
  • Container (Type) => none - bordered - roundBordered - rounded.
  • SharedPreferences.
  • TextFormField (Type) => none - bordered - roundBordered - rounded.
  • Text => There are mainly 13 types of Text widgets.
  • Patterns for url - phone - image - audio - text - document - excel - ppt - apk - pdf .
  • CustomLog
  • countryCode
  • ErrorResponse
  • Decoration
  • Header =>There are mainly 2 types of Header utils. headerWithoutToken and headerWithToken.

first

Future<void> main() async {
//You will need to initialize AppThemeNotifier class for theme changes.
WidgetsFlutterBinding.ensureInitialized();
FlutterUtilsProject.init();}

Examples

1 -SnapHelperWidget

SnapHelperWidget makes easy implementation for future or stream builder

 SnapHelperWidget<List<YOURMODEL>>(

  future: getData(context),
  defaultErrorMessage: 'default Error Message',
  errorWidget: const Text('error Widget').center(),
  loadingWidget: const CircularProgressIndicator().center(),
  ///useConnectionStateForLoader: ,
  ///initialData: ,this is initial Data
  onSuccess: (List<YOURMODEL> snap) {
  return ListView.builder(
  itemCount: snap.length,
  physics: const BouncingScrollPhysics(
  parent: AlwaysScrollableScrollPhysics()),
  itemBuilder: (BuildContext context, int index) {
  var data = snap[index];

  return Text(data.name);

  },
  );
  }),

2- FuLog


Future<void> main() async {
//You will need to initialize AppThemeNotifier class for theme changes.
WidgetsFlutterBinding.ensureInitialized();
FlutterUtilsProject.init();
///if you want enable log console, do it.
FlutterUtilsProject.enableLog();
///If you don't want to show the log consol, do it.
FlutterUtilsProject.disableLog();
/// default log consol equal enable
}

3- Use the AppTheme

import 'package:provider/provider.dart';
import 'package:flutter/material.dart';
import 'package:flutter_utils_project/flutter_utils_project.dart';
Future<void> main() async {
runApp(
  MultiProvider(
      providers: [
     ChangeNotifierProvider<FuAppThemeNotifier>( 
     create: (_) => FuAppThemeNotifier(),), ],
     child: const MyApp()
 ) );
}

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return Consumer<FuAppThemeNotifier>(
        builder: (BuildContext context, FuAppThemeNotifier value, Widget? child) {
      return MaterialApp(
      debugShowCheckedModeBanner: false,
      title: "Flutter Utils Project",
      theme: FuAppTheme.getThemeFromThemeMode(),
      home: const HomeScreen()//navigator to your HomeScreen
      );
    });
  }
}

4- Use AutoSizeText

group You can synchronize the font size of multiple AutoSizeText. They will fit their boundaries and all AutoSizeText in the same group have the same size. That means they adjust their font size to the group member with the smallest effective font size.

Note: If a AutoSizeText cannot adjust because of constraints like minFontSize, it won't have the same size as the other group members.

An instance of AutoSizeGroup represents one group. Pass this instance to all AutoSizeText you want to add to that group. You don't have to care about disposing the group if it is no longer needed.

Important: Please don't pass a new instance of AutoSizeGroup every build. In other words, save the AutoSizeGroup instance in a StatefulWidget.

var myGroup = AutoSizeGroup();

AutoSizeText(
  'Text 1',
  group: myGroup,
);

AutoSizeText(
  'Text 2',
  group: myGroup,
);



Demo

stepGranularity The AutoSizeText will try each font size, starting with TextStyle.fontSize until the text fits within its bounds. stepGranularity specifies how much the font size is decreased each step. Usually, this value should not be below 1 for best performance.

AutoSizeText(
  'A really long String',
  style: TextStyle(fontSize: 40),
  minFontSize: 10,
  stepGranularity: 10,
  maxLines: 4,
  overflow: TextOverflow.ellipsis,
)



AutoSizeText behaves exactly like a Text. The only difference is that it resizes text to fit within its bounds.

AutoSizeText(
  'A really long String',
  style: TextStyle(fontSize: 30),
  maxLines: 2,
)

maxLines

The maxLines parameter works like you are used to with the Text widget. If there is no maxLines parameter specified, the AutoSizeText only fits the text according to the available width and height.


AutoSizeText(
  'A really long String',
  style: TextStyle(fontSize: 30),
  maxLines: 2,
)

5- Context Extensions

Are you still typing MediaQuery.of(context).size... or Navigator.of(this).push.. ? Let's change that 🤩

❌ Navigator.of(context).push(MaterialPageRoute(
    builder: (_) => HomeScreen(),
  ));

✅ context.push(HomeScreen());

❌  MediaQuery.of(context).size.width;

✅ context.width;
✅ context.height;

bool get isSmallTablet => (mediaQueryShortestSide >= 600); can you get found context Extensions `mediaQueryPadding` - `mediaQuery` - `textTheme` - `mediaQueryViewPadding` - `orientation` - `textScaleFactor` - `mediaQueryShortestSide` and

Responsive ui `isPhone` - `isSmallTablet` - `isLargeTablet` - `isTablet`

and the a lot Extensions


 Container(
  color: context.textTheme.bodyText2!.color,//can yuo get found Context Extensions theme
  height: context.height / 2,//can yuo get found Context Extensions height (mediaQuerySize height)
  width: context.width / 1.5,
  child: const Center( child: Text( 'wellCome', style: TextStyle(color: Colors.white), ),
  ),
),

6- Error Handler

can you handler error Exception. Handling for Error Exception Example (No Internet Connection 😑 or Bad response format 👎 or Couldn't find the post 😱 ) And if nothing happens, he'll return the default mistake.


  Future<List<YOURMODEL>?> getProfile(BuildContext context) async {
  try {
  List<YOURMODEL> profile = [];//your model class
  http.Response response = await http.get(
  Uri.parse('YOUR URI'),
  headers: YourHeader()
  );
  if (response.statusCode == 200) {
  List list = json.decode(response.body);
  profile = list.map((model) => YOURMODEL.fromJson(model)).toList();
  return profile;
  } else {
  var massages = jsonDecode(response.body);
  String error = massages['Error'];
  // return showSnackBar(); //can you return anything
  print(error)
  }
  } catch (err) {
  /*
  Handling for Error Exception Example  (No Internet Connection 😑
  or Bad response format 👎
  or Couldn't find the post 😱 )
  And if nothing happens, he'll return the default mistake.
  */
  ApiErrorHandler.parseError(err, context,);
  print("$err Error");
  }
  return null;
  }


7- Int Extensions

height => Leaves given height of space


Container(child:Text('Example1')),
❌SizedBox(height:12),
or
❌SizedBox(width:12),
Container(child:Text('Example2')),



Container(child:Text('Example1')),
✅ 12.height,
✅ 12.width,
Container(child:Text('Example2')),

width => Leaves given width of space

Row(children:[
Text('width1'),
5.width,
Text('width2'),
])

isSuccessful =>HTTP status code

if(response.statusCode=isSuccessful){
  print(' statusCode Successful')
}

microseconds

Returns microseconds duration

 5.microseconds

milliseconds

Returns milliseconds duration

5.milliseconds

seconds

Returns minutes duration

5.seconds

minutes

Returns hours duration

5.minutes

hours

Returns hours duration

 5.hours

days

Returns days duration

 5.days

8- TextStyle

FuTextStyle - gives 13 different type of styles to the text on the basis of size


 FuText.h1(
'TextStyle h1',
color: Colors.white,
),

 FuText.b1(
'TextStyle b1',
color: Colors.white,
),
FuText.button(
'TextStyle button',
color: Colors.white,
),


9-Strings Extensions, Methods

/// Returns True/False

String example = "";

/// Check URL validation
example.validateURL();

/// Check email validation
example.validateEmail();

/// Check phone validation
example.validatePhone();

/// Return true if given String is Digit
example.isDigit();

/// Check weather String is alpha or not
example.isAlpha();

/// Check weather String is Json or not
example.isJson();

/// Copy String to Clipboard
example.copyToClipboard();

/// for ex. add comma in price
example.formatNumberWithComma();

/// Get Color from HEX String
example.toColor();

/// It reverses the String
example.reverse;

/// It return list of single character from String
example.toList();

/// Returns true if given String is null or isEmpty
example.isEmptyOrNull;

/// Check null string, return given value if null
example.validate();

/// Capitalize First letter of a given String
example.capitalizeFirstLetter();

/// Returns if its type image
example.isImage;

/// Returns if its type Audio
example.isAudio;

/// Returns if its type Video
example.isVideo;

/// Returns if its type Txt
example.isTxt;

/// Returns if its type Doc
example.isDoc;

/// Returns if its type Excel
example.isExcel;

/// Returns if its type PPT
example.isPPT;

/// Returns if its type Apk
example.isApk;

/// Returns if its type Pdf
example.isPdf;

/// Returns if its type Html
example.isHtml;

/// Pass the Pattern

/// Splits from a [pattern] and returns remaining String after that
example.splitAfter(Patterns.apk);

/// Splits from a [pattern] and returns String before that
example.splitBefore(Patterns.audio);

/// It matches the String and returns between [startPattern] and [endPattern]
example.splitBetween("d", "g");

/// Return int value of given string
example.toInt();

/// Get YouTube Video ID
example.toYouTubeId();

/// Returns YouTube thumbnail for given video id
example.getYouTubeThumbnail();

/// Removes white space from given String
example.removeAllWhiteSpace();

/// Returns only numbers from a string
example.getNumericOnly(example);

/// Return average read time duration of given String in seconds
example.calculateReadTime();

/// Return number of words in a given String
example.countWords();

/// Generate slug of a given String
example.toSlug();

/// returns searchable array for Firebase Database
example.setSearchParam();

/// replace From number English To Arabic
Text(''. replaceFarsiNumber('1234567');

10- Spacing

FuSpacing - provides spacing of various types.

const Text('First Text'),
FuSpacing.height(30),

const Text('Next Text'),
FuSpacing.width(30),
Container(padding:FuSpacing.all(12) ,),
Container(padding:FuSpacing.bottom(12) ,),
Container(padding:FuSpacing.fromLTRB(12, 1, 12, 8) ,),
Container(padding:FuSpacing.horizontal(2) ,),
Container(padding:FuSpacing.vertical(2) ,),
Container(padding:FuSpacing.left(2) ,),

///padding from all direction except Right
❌ Container(padding: EdgeInsets.only(left: 12,top:12 ,bottom: 12),child: EnyWidget(),),
✅ Container(padding:FuSpacing.noRight(12),child: EnyWidget(),),

///padding from all direction except Bottom
❌ Container(padding: EdgeInsets.only(left: 12,top:12 ,right: 12),child: EnyWidget(),),
✅ Container(padding:FuSpacing.noBottom(12),child: EnyWidget(),),

///padding from all direction except Left
❌ Container(padding: EdgeInsets.only(bottom: 12,top:12 ,right: 12),child: EnyWidget(),),
✅ Container(padding:FuSpacing.noLeft(12),child: EnyWidget(),),

///padding from all direction except Top
❌ Container(padding: EdgeInsets.only(bottom: 12,left:12 ,right: 12),child: EnyWidget(),),
✅ Container(padding:FuSpacing.noTop(12),child: EnyWidget(),),

Container(padding:FuSpacing.only(bottom: 12) ,),
Container(padding:FuSpacing.symmetric(horizontal: 1) ,),
Container(padding:FuSpacing.only(bottom: 12) ,),

getYouTubeThumbnail

Text('Text1234567'. getYouTubeThumbnail(),
style: TextStyle(color: context.theme.primaryColor,fontSize: 20),
),

11- Widget Extensions

  //Padding piece from the height 
  Text('withHeight').withHeight(20),

  //Padding piece from the width and height 
  Text('widthAndHeight').widthAndHeight(height: 12, width: 11),

  //hide Widget if value equal false else equal true visible widget
  Text('visible').visible(false),

  //you can withTooltip for any widget
  Text('withTooltip').withTooltip(msg: 'Text'),
  
  //you can onTap for any widget
  ❌ InkWell( onTap: (){/*  do anything */},  child: Text('onTap'),)
  ✅ Text('onTap').onTap((){/*  do anything */}),

  //Padding piece from all directions
  ❌ Padding(padding: EdgeInsets.all(12),child: Text('paddingAll'),),
  ✅ Text('paddingAll').paddingAll(12),

  //Padding piece from the bottom
  Text('paddingBottom').paddingBottom(12),

  //Padding piece from the left 
  Text('paddingLeft').paddingLeft(12),

  //Padding piece from the right 
  Text('paddingRight').paddingRight(12),

  //Padding Widget form custom directions
  Text('paddingOnly').paddingOnly(bottom: 30,top: 50,left: 0,right: 12), 

 
 //you can expand for any widget
❌ Row(children: [Expanded(child: TextField())],),
✅ Row(children: [TextField()],).expand(),

  //you can center for any widget
  Text('center').center(),

  //you can fit for widget
  Text('fit').fit(),

  //you can flexible for widget
  Text('flexible').flexible(),

  //Padding Widget form custom directions  
  Text('paddingSymmetric').paddingSymmetric(),

  //this is same SizedBox()
  WidgetExtension.empty(),

        

Circle Button

 CircleButton(
  icon: const Icon(Icons.search),
  iconSize: 30.0,
  color:Colors.black,
  onPressed: () => print('Search'),
  ),


12- FuLog

 FuLog('Anything');

13- country Code

get all name and code all country

  Column(children: List<Widget>.generate(FxTextUtils. countryCode.length, (index) {
  FxTextUtils. countryCode.toList();
  var data= FxTextUtils. countryCode[index];
  return Row(
  children: [
  Text(data['name']),
  12.width,
  Text(data['code'],style: TextStyle(color: context.theme.primaryColor),),
  ],
  );
  },)),

14- How to use the SharedPreferences

set String


❌ SharedPreferences preference = await SharedPreferences.getInstance();
❌ var result = preference.setString('key', 'value');


 ✅ await FuSharedPreferences.setString('key', 'value');

get String


❌ SharedPreferences preference = await SharedPreferences.getInstance();
❌ var result = preference.getString('key');


 ✅ await FuSharedPreferences.getString('key');

delete


await FuSharedPreferences.deleteString('key');

clear


await FuSharedPreferences.clear();

You can also do a lot of operations with SharedPreferences`sitInt`-`getInt`-`sitBool`-`getBool`

15- FuWidgetErrorResponse

  FuErrorResponse.snackBarError(
  error: "Bad response format 👎",
  context: context,
  color: Colors.red,
  );

16- FuDashedDivider

this is same Divider but has Dashed Example this shape `- - - - - - - - - - - - `

FuDashedDivider( color:FuAppTheme.getThemeFromThemeMode().colorScheme.onBackground, ),

17- Decoration

boxDecorationDefault

Container(child: Text('boxDecorationDefault'),decoration: boxDecorationDefault(),),

boxDecorationWithShadow


Container(child: const Text('boxDecorationWithShadow'),decoration: boxDecorationWithShadow(shadowColor: context.theme.primaryColor),),

radius

❌Container(decoration: const BoxDecoration(borderRadius:BorderRadius.all( Radius.circular
❌(12)) ),child:const Text('radius')),

✅ Container(borderRadius: radius(),child:Text('radius'))

radiusOnly


FuContainer.none(borderRadius:  radiusOnly(),child:Text('radiusOnly'))

ShapeBorder dialogShape

18- Costume Transition

this is custom animation Navigator

  Navigator.push(context,CostumeTransition(HomePage));

Input Validation


validator:(String ?value){
      FuInputValidation.validationTextField(
      controller: _textController, 
      error: 'Enter Your Error', 
      lengthMin: 'The field must be at least tow characters long.',
      lengthMax: 'The field should not be more than eight letters long.',
      main: 2,
      max: 8);
      } ,


do `post or put or get or delete or patch` WithoutToken


  final response = await http.get(Uri.parse('Your URI'),
  headers: FuHeader.headerWithoutToken()),

do `post or put or get or delete or patch` WithToken


  final response = await http.get(Uri.parse('Your URI'),
  headers: FuHeader.headerWithToken('Your Token')),

Contribution

Of course the project is open source, and you can contribute to it repository link

  • If you found a bug, open an issue.
  • If you have a feature request, open an issue.

Contributors