Advanced Countdown Timer

Description

AdvancedCountdownTimer is a highly customizable countdown timer widget for Flutter apps. It provides an easy way to implement a countdown timer with features like start, pause, reset, and customizable text styles and progress indicator colors.

Features

Start, pause, and reset functionality
Customizable countdown duration
Circular progress indicator
Customizable text style and progress bar color
Callback functions for start, pause, and completion events

Installation

Add the following line to your pubspec.yaml under the dependencies section:

dependencies:
  advanced_countdown_timer: ^0.0.2

Then run:

flutter pub get

Usage

Import the package:

import 'package:advanced_countdown_timer/advanced_countdown_timer.dart';

Basic Usage

Here’s a simple example of how to use the AdvancedCountdownTimer widget:

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Advanced Countdown Timer'),
        ),
        body: Center(
          child: AdvancedCountdownTimer(
            duration: Duration(seconds: 10),
            textStyle: TextStyle(
              fontSize: 24,
              fontWeight: FontWeight.bold,
            ),
            progressColor: Colors.blue,
            onStart: () {
              print('Countdown started!');
            },
            onPause: () {
              print('Countdown paused!');
            },
            onComplete: () {
              print('Countdown complete!');
            },
          ),
        ),
      ),
    );
  }
}

Customizing the Timer

You can easily customize the timer's appearance and behavior by passing optional parameters:

AdvancedCountdownTimer(
  duration: Duration(seconds: 60), // Countdown duration
  textStyle: TextStyle(fontSize: 30, color: Colors.red), // Custom text style
  progressColor: Colors.green, // Custom progress bar color
  onStart: () => print("Timer started!"), // On start callback
  onPause: () => print("Timer paused!"), // On pause callback
  onComplete: () => print("Timer complete!"), // On completion callback
)

Example

For a complete example, check the /example folder in this repository.

API