TimeFlow-Card v1.0.0
TimeFlow Card v1.0.0
๐ Introducing TimeFlow Card - A beautiful countdown timer card for Home Assistant with animated progress circles and intelligent time formatting.
โจ What's New
๐จ Advanced Styling System
- Card-mod integration - Full compatibility for complex CSS styling and animations
- Native styling options - Simple config-based styling for titles, cards, and progress circles
- True proportional scaling - Elements automatically resize based on card dimensions
- Responsive design - Perfect display on mobile, tablet, and desktop
โฐ Smart Countdown Features
- Flexible time units - Show/hide months, days, hours, minutes, seconds as needed
- Natural language formatting - "5 days and 3 hours" or compact "5d 3h" display
- Entity support - Use sensor values for dynamic countdowns
- Custom expired messages - Personalized completion text when timers finish
- Cross-platform compatibility - Reliable date parsing across all devices
๐ฆ Installation
HACS (Recommended)
- Open HACS โ Frontend โ "โฎ" (three dots menu) โ Custom repositories
- Add repository URL:
https://github.com/Rishi8078/TimeFlow-Card - Select category: "Dashboard"
- Click "Add" โ Install โ Add to Lovelace resources
Manual Installation
- Download
timeflow-card.jsfrom releases - Copy to
config/www/directory - Add to Lovelace resources
๐ก Quick Start Examples
Basic Countdown
type: custom:timeflow-card
title: "New Year 2026"
target_date: "2026-01-01T00:00:00"Entity-Based Timer
type: custom:timeflow-card
title: "Next Backup"
target_date: sensor.backup_next_scheduled
creation_date: sensor.backup_last_completedCustom Styling
type: custom:timeflow-card
title: "Project Deadline"
target_date: "2025-12-31T23:59:59"
styles:
title: ["color: #FF5722", "font-weight: bold"]
card: ["border: 2px solid #4CAF50"]Card-mod Integration
type: custom:timeflow-card
title: "Important Event"
target_date: "2025-08-15T18:00:00"
card_mod:
style: |
ha-card {
background: linear-gradient(45deg, #667eea 0%, #764ba2 100%);
}๐ Why TimeFlow Card?
Perfect for tracking:
- Project deadlines and milestones
- Event countdowns (birthdays, vacations, holidays)
- Maintenance schedules (backups, updates, renewals)
- Goal timelines (exams, competitions, launches)
- Any time-sensitive objectives
๐ค Community
- GitHub Repository: TimeFlow-Card
- Issues & Support: GitHub Issues
- Documentation: Full README with examples and configuration options
๐ Thank You
TimeFlow Card is built with โค๏ธ for the Home Assistant community. We welcome feedback, feature requests, and contributions to make it even better!
๐ Full Changelog
- feat: Major styling system overhaul - fix native styles and improve proportional scaling
- feat: Add card-mod compatibility for advanced styling
- fix: Expired text now shows as subtitle instead of title
- docs: Enhance documentation and HACS metadata for release
- chore: Reset version to 1.0.0 for initial public release
- feat: Update preview image with latest card design
Download: timeflow-card.js