vibe_timer 0.0.2

A customizable animated countdown and count-up timer widget for Flutter.

🎛️ Vibe Timer

Vibe Timer is a beautiful and customizable Flutter countdown/count-up timer widget, built with animated digits, sounds, and interactive controls — perfect for meditation, workouts, study sessions, productivity apps, and more.

---

🎥 Demo

---

✨ Features

• ✅ Supports both countdown and count-up
• ⏱️ Smooth digit animations: slide and scale.
• 🔊 Optional tick and finish sounds
• 🎮 Interactive controls: play, pause, reset
• 🎨 Fully customizable layout (icons, text, colors)

---

🚀 Installation

Add to your pubspec.yaml:

dependencies:
  vibe_timer: ^0.0.1

Then run:

flutter pub get

---

🧪 Example

import 'package:vibe_timer/vibe_timer.dart';

VibeTimer(
  duration: Duration(minutes: 2, seconds: 30),
  mode: TimerMode.countDown,
  animate: true,
  animationType: VibeAnimationType.slide,
  textStyle: TextStyle(
    fontSize: 48,
    color: Colors.blueAccent,
    fontWeight: FontWeight.bold,
  ),
  showControllers: true,
  iconColor: Colors.blueAccent,
  playIcon: Icon(Icons.play_circle),
  pauseIcon: Icon(Icons.pause_circle),
  resetIcon: Icon(Icons.refresh),
)

---

🎨 Customization

Property	Type	Description
duration	Duration	Total timer duration
mode	TimerMode	countDown or countUp
animate	bool	Enables/disables animations
animationType	VibeAnimationType	Animation type: slide, scale
textStyle	TextStyle	Style for the timer text
showControllers	bool	Show/hide control buttons
iconColor	Color	Color of the control icons
playIcon, pauseIcon, resetIcon	Widget?	Custom icons for control buttons
autoPlay	bool	Auto start the timer on init
showHours, showMinutes, showSeconds	bool	Show/hide individual time units

---

🔊 Sound Support

You can add ticking and finish sounds:

VibeTimer(
  ...
  sound: true,
  tickSoundAsset: 'assets/sounds/tick.mp3',
  finishSoundAsset: 'assets/sounds/ding.mp3',
)

Make sure to declare the assets in your pubspec.yaml:

flutter:
  assets:
    - assets/sounds/tick.mp3
    - assets/sounds/ding.mp3

📄 License

MIT License. See LICENSE for details.

---

🤝 Contributing

Contributions and feedback are welcome! Feel free to open issues, submit PRs, or share ideas to make this widget even better.