This is a simple countdown timer widget built with Flutter. It displays the remaining time until a specified end date and time, and triggers a callback function when the countdown finishes.

Features

Displays remaining time in days, hours, minutes, and seconds.
Multiple animation styles: fadeIn, basic, slideUp, scale, flip, rotation, and blur.
Customizable text styles and colors.
Callback function for when the countdown finishes.
Lightweight and easy to use.

Installation

Add the dependency to your pubspec.yaml file:

  simple_count_down_timer: ^1.0.9 # Replace with the latest version

Run flutter pub get to install the package.

Usage

import 'package:simple_count_down_timer/simple_count_down_timer.dart' as timer;

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

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

 @override
 State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
 @override
 void initState() {
   super.initState();
 }

 @override
 Widget build(BuildContext context) {
   return MaterialApp(
     home: Scaffold(
       appBar: AppBar(
         title: const Text('Plugin example app'),
       ),
       body: Center(
         child: timer.SimpleCountDownTimer(
           duration: const Duration(days: 1, seconds: 5),
           animationStyle: timer.AnimationStyle.fadeIn,
         ),
       ),
     ),
   );
 }
}

Animation Styles

Set the animationStyle property to change how the timer digits animate. Available values from AnimationStyle:

Style	Description
`fadeIn`	Digits fade in on change (default).
`basic`	No animation, plain text update.
`slideUp`	Digits slide upward on change.
`scale`	Digits scale in/out on change.
`flip`	Digits flip on change.
`rotation`	Digits rotate on change.
`blur`	Digits blur transition on change.

timer.SimpleCountDownTimer(
  duration: const Duration(days: 1, seconds: 5),
  animationStyle: timer.AnimationStyle.flip,
)

See the example app for a live picker that previews every style.

Customization

TextStyle: You can customize the text style of the countdown timer by setting the style property of the child widget.
Colors: You can change the colors of the text and background by using a ThemeData with your desired colors.

Additional Notes

This package is for simple countdown timers. For more advanced features like pausing, resuming, and complex formatting, consider exploring other timer packages available on pub.dev. Make sure to replace ^1.0.8 with the latest version of the countdown_timer package in your pubspec.yaml file.

Flutter Countdown Timer Widget