flutter_timer_countdown is a Flutter package for a Timer. ✨

It is a simple customizable timer for counting down a given time with any Custom TextStyle.

Supporting Android, iOS & WebApp.


We build this package because we wanted to:

  • have simple timer
  • customize timer textstyles
  • choose the timer description
  • be able to unable the timer description

❗NEW Features ❗

Customizable space between number units and colons

With the parameter spacerWidth you can now define the size of the space between number units and colons. The default is set to 10 (double).

Show Cases

Show only the time units you want to...

Show only days, hours, minutes, seconds...


Create a new project with the command

flutter create MyApp


flutter_timer_countdown: ...

to your pubspec.yaml of your flutter project. OR run

flutter pub add flutter_timer_countdown

in your project's root directory.

In your library add the following import:

import 'package:flutter_timer_countdown/flutter_timer_countdown.dart';

For help getting started with Flutter, view the online documentation.


You can place your TimerCountdown inside of a Scaffold or CupertinoPageScaffold like we did here. Optional parameters can be defined to enable different features. See the following example..

import 'package:flutter_timer_countdown/flutter_timer_countdown.dart';
import 'package:flutter/cupertino.dart';

class Example extends StatelessWidget {
  Widget build(BuildContext context) {
    return CupertinoPageScaffold(
      child: TimerCountdown(
          format: CountDownTimerFormat.daysHoursMinutesSeconds,
          endTime: DateTime.now().add(
              days: 5,
              hours: 14,
              minutes: 27,
              seconds: 34,
          onEnd: () {
            print("Timer finished");



endtime-Defines the time when the timer is overtrue
formatDaysHoursMinutesSecondsFormat for the timer coundtown, choose between different CountDownTimerFormatsfalse
onEnd-Function to call when the timer is overfalse
enableDescriptions-Toggle time units descriptionsfalse
timeTextStyle-TextStyle for the time numbersfalse
colonsTextStyle-TextStyle for the colons betwenn the time numbersfalse
descriptionTextStyle-TextStyle for the timer descriptionfalse
daysDescriptionDaysDays unit descriptionfalse
hoursDescriptionHoursHours unit descriptionfalse
minutesDescriptionMinutesMinutes unit descriptionfalse
secondsDescriptionSecondsSeconds unit descriptionfalse
spacerWidth10Defines the width between the colons and the unitsfalse

Made with ❤ by Flutter team at Appinio GmbH