Calendar Card Pro v2.3.0

Time-aware and visually enhanced. This release brings dynamic countdown displays, weekend styling, and flexible date ranges that adapt to your needs, making Calendar Card Pro more informative and visually distinct than ever before.

→→→ Please see the 🆕 What's New section in the README for an overview of v2.3 features with links to their detailed documentation. ←←←

🎉 New Features

Countdown Display

Show how much time remains until an event starts with the new show_countdown option:

# Enable countdown display for upcoming events
show_countdown: true

Automatic Time Units - Shows days remaining for future events, hours for same-day events
Multi-Language Support - Countdown text automatically uses your configured language
Subtle Design - Unobtrusive display that complements the existing time information
Enhanced Awareness - Quickly see which events are coming up soon

Weekend Day Styling

Make weekend days visually distinct with dedicated color options:

# Style weekend days differently
weekend_weekday_color: '#E67C73' # Color for Sat/Sun weekday names
weekend_day_color: '#E67C73' # Color for weekend day numbers
weekend_month_color: '#E67C73' # Color for month names on weekends

Enhanced Visual Organization - Weekend days stand out from weekdays
Complete Control - Separately style weekday names, day numbers, and month names
Theme Integration - Works with Home Assistant theme variables and custom colors
Improved Readability - Easier to distinguish between work days and weekend days

Dynamic Start Date with Relative Offsets

Define "floating" start dates relative to the current day:

# Start date examples:
start_date: "today+7"  # Always show events starting 7 days from today
start_date: "+3"       # Shorthand for today+3
start_date: "today-2"  # Show events starting from 2 days ago
start_date: "-1"       # Shorthand for today-1 (yesterday)

Automatic Adjustment - Date range automatically updates as days pass
Shorthand Notation - Simplified syntax with + and - operators
Fixed or Dynamic - Use absolute dates for fixed ranges or relative offsets for floating windows
Flexible Planning - Perfect for showing "next two weeks" or "current week plus 3 days" views

Automatic Hyphenation

Long words (especially compound words in languages like German) now wrap more elegantly with automatic hyphenation.

Enhanced Cache Management

Improved caching mechanism by adding version-aware caching to automatically invalidate incompatible cache data after updates.

🐛 Bug Fixes

Fixed All-Day Event Sorting - All-day events are now properly sorted by calendar entity order first, then alphabetically
Improved Multi-Day Event Handling - Multi-day events that begin before a custom start date now display consistently
Cache Invalidation After Updates - Prevents blank cards after HACS updates by adding version numbers to cache keys

Related Issues

This release addresses the following feature requests and bug reports:

#67 - Days remaining countdown (requested by @jelmerwouters-topicus)
#76 - Time until the event countdown (requested by @pol409887)
#98 - Show weekends in different color (requested by @yornola)
#103 - End date customization (requested by @tkabt06)
#105 - Start days ahead option (requested by @pol409887)
#133 - Add hyphens:auto (requested by @sevorl)

Full Changelog: v2.2.1...v2.3.0

Thank you to everyone who contributed feature requests and bug reports that made this release possible!

alexpfau/calendar-card-pro v2.3.0 on GitHub