📸 Screenshots #

Timer Controls & Animations	Static Examples & Variations
Interactive timers with start/pause/reset controls	Different progress states and styling options

📱 Platform Support #

Pure Dart Implementation: This package contains only Dart code and custom painters, making it compatible with all Flutter platforms without any platform-specific dependencies.

✨ Key Features #

🎯 Use Cases #

Perfect for:

• 🍅 Pomodoro Timer Apps - Work/break session timers
• 📝 Quiz Applications - Question time limits with visual feedback
• 🏃 Fitness Apps - Workout timers, rest periods, intervals
• 🍳 Cooking Apps - Recipe timers, cooking stages
• 📚 Study Apps - Focus sessions, break reminders
• 🎮 Game Development - Countdown timers, turn limits
• 📢 Presentation Apps - Speaking time limits
• 🚑 Emergency Apps - Critical countdown timers

⚡ Quick Start #

// 1. Add to pubspec.yaml
dependencies:
  analog_timer: ^1.0.0

// 2. Import
import 'package:analog_timer/analog_timer.dart';

// 3. Use it!
AnalogTimer(
  progress: 0.75,
  remainingTimeText: '01:30',
  size: 200,
)

🚀 Installation #

1. Dependency #

Add this to your package's pubspec.yaml file:

dependencies:
  analog_timer: ^1.0.0

2. Install #

flutter pub get

3. Import #

import 'package:analog_timer/analog_timer.dart';

📖 Usage #

Simple Timer #

For basic usage with just a progress value:

AnalogTimer(
  progress: 0.75, // 75% time remaining
  remainingTimeText: '01:30',
)

Timer with Controller #

For full timer functionality with start/pause/reset:

class TimerPage extends StatefulWidget {
  @override
  _TimerPageState createState() => _TimerPageState();
}

class _TimerPageState extends State<TimerPage> with TickerProviderStateMixin {
  late AnalogTimerController _controller;

  @override
  void initState() {
    super.initState();
    
    // Initialize timer controller
    _controller = AnalogTimerController(
      duration: const Duration(minutes: 5),
      warningThreshold: 0.3, // Warning at 30% remaining
      criticalThreshold: 0.1, // Critical at 10% remaining
    );
    
    // Initialize animation (required for glow effects)
    _controller.initializeAnimation(this);
    
    // Set up callbacks
    _controller.onWarning = () => print('Warning: Time running low!');
    _controller.onCritical = () => print('Critical: Very little time left!');
    _controller.onExpired = () => print('Time expired!');
  }

  @override
  void dispose() {
    _controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            // Animated timer widget
            AnimatedBuilder(
              animation: _controller,
              builder: (context, child) {
                return AnalogTimer(
                  progress: _controller.progress,
                  isRunning: _controller.isRunning,
                  animationValue: _controller.animationValue,
                  warningLevel: _controller.warningLevel,
                  remainingTimeText: _controller.formattedTime,
                  size: 250,
                );
              },
            ),
            
            const SizedBox(height: 40),
            
            // Control buttons
            Row(
              mainAxisAlignment: MainAxisAlignment.spaceEvenly,
              children: [
                ElevatedButton(
                  onPressed: () {
                    if (_controller.isRunning) {
                      _controller.pause();
                    } else if (_controller.isPaused) {
                      _controller.resume();
                    } else {
                      _controller.start();
                    }
                  },
                  child: Text(_controller.isRunning 
                    ? 'Pause' 
                    : _controller.isPaused 
                      ? 'Resume' 
                      : 'Start'),
                ),
                ElevatedButton(
                  onPressed: _controller.reset,
                  child: const Text('Reset'),
                ),
              ],
            ),
          ],
        ),
      ),
    );
  }
}

Custom Styling #

AnalogTimer(
  progress: 0.6,
  direction: AnalogTimerDirection.antiClockwise,
  size: 300,
  circleColor: const Color(0xFF2C3E50),
  intervalColor: const Color(0xFF95A5A6),
  majorIntervalColor: const Color(0xFF34495E),
  timeTextColor: const Color(0xFF2C3E50),
  timeTextSize: 32,
  warningColors: const AnalogTimerWarningConfig(
    normalColor: Color(0xFF3498DB),   // Blue
    warningColor: Color(0xFFE67E22),  // Orange  
    criticalColor: Color(0xFFE74C3C), // Red
    warningThreshold: 0.4,            // Warning at 40%
    criticalThreshold: 0.15,          // Critical at 15%
  ),
)

📋 API Reference #

AnalogTimer #

AnalogTimerController #

AnalogTimerWarningConfig #

🎯 Examples #

Check out the /example folder for a complete Flutter application demonstrating all features:

• Simple 60-second countdown timer
• Custom 2-minute timer with different styling
• Static examples showing different states
• Interactive controls for start/pause/reset
• Custom warning thresholds and colors

Running the Example #

# Clone or download the repository
cd analog_timer/example

# Get dependencies
flutter pub get

# Run on your preferred platform
flutter run

# Or run on web
flutter run -d web-server --web-port 8080

# Or build for web
flutter build web

The example works on all supported platforms (Android, iOS, Web, macOS, Windows, Linux).

🤝 Contributing #

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

📝 License #

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

🐛 Issues #

Please file issues on the GitHub issues page.

📧 Support #

For questions or support, please visit vignaraj.dev or open an issue on GitHub.