1.4.7

What's new

🌈 New Visual Effects for Progress Bars

outer border-radius

Normalized outer border-radius based on component size (small, medium, large).

Visual Styles for Progress Fill

You can now customize the look of the progress bar using new visual styles:

• radius – rounded corners
• glass – frosted glass effect
• gradient – soft color gradients
• shimmer – animated shimmering

👉 Enable with the new bar_effect option.
➡️ Documentation: here

💧 Redesigned Watermarks

New watermark types provide more visual flexibility:

• blended (default): A subtle colored overlay that merges with the bar’s colors for a more integrated look.
• area: A soft transparent shape placed over the bar, without blending into the bar's colors.
• striped: Diagonal stripes for a patterned effect.
• triangle: Triangle shapes as a watermark.
• round: Rounded shapes applied as a watermark.
• line: Vertical lines pattern (like a hatch effect).

👉 Cleaner and more dynamic rendering.

👉 Request:

• #57 Watermark: opacity (@WaterInTheLake)
• #58 Watermark: line width (@WaterInTheLake)

➡️ Documentation: here

🧩 Technical Improvements

🏗 Full Refactor

• Modular rewrite for both cards and badges
• New config system with automatic validation

⚙️ Better Maintainability

• Reduced code duplication
• Dynamic CSS class handling for flexibility
• Foundation laid for future features

🔧 Migration Notes

No changes required to existing configurations.

To use new effects, add this to your card config:

type: 'custom:entity-progress-card'
entity: sensor.battery_level
bar_effect:
  - shimmer
  - radius

➡️ Documentation: entity-progress-card GitHub repo
➡️ Full Changelog: 1.4.6...1.4.7

1.4.6

What's new

🎨 Editor Improvements

• Cleaned the editor logic with proper separation of rendering methods.
• Improved accordion sections animation
• Improved behavior of toggle switches and dynamic hide logic in the config editor.

🏷️ Badge Component

• Standardized dimensions (width/height),
• Improved icon and text alignment,
• Better visual consistency in compact layouts.

🐞 Bug Fixes

• #56 Text on Badge is nearly unreadable (@sphings79)
• Resolved potential duplicate event listener issues in the editor.

➡️ Documentation: entity-progress-card GitHub repo
➡️ Full Changelog: 1.4.5...1.4.6

1.4.5

What's new

🚀 Improvements:

🎨 entity-progress-card

If the entity has an entity_picture attribute then a picture is shown, instead of an icon.

• #55 Allow image instead of icon (@netsoft-ruidias)

🎨 entity-progress-card & template:

reverse_secondary_info_row: added. Reverses the order of the progress bar and the secondary info when using a horizontal layout.

• #52 add options to display values on right side and adjust font size (@jamesvert)

📖 Extended support for frameless:

• Enhanced documentation now details compatibility with various card types (entities, vertical-stack, etc.).
• Clearer guidance on when this option needs to be explicitly set.

⚙️ CSS Optimizations

• Improved vertical layout handling:
  • Adjustments to margins, heights, and alignments.
  • Centered and responsive display.
• Renaming from formats like hide_icon → hide-icon for better consistency.
• Refactoring of CSS variables (--epb-*) for improved clarity and customization.
• manage all ellipsis with the same methodology

➡️ Documentation: entity-progress-card GitHub repo
➡️ Full Changelog: 1.4.4...1.4.5

1.4.4

What's new

🚀 Improvements:

🎨 Enhanced Frameless Mode Integration:

• Better compatibility with entities and vertical-stack-in-card cards when using frameless mode.
• Automatic detection with entities card and aligned look & feel
• Shadow has been removed to avoid glitch
  [Feature]: Add entity_row option - frameless #45

🎨 Major CSS Optimizations

• Complete CSS reorganization
• Enhanced entity support
• Better orientation handling
• Optimized transitions
• Improved accessibility

✏️ Editor Improvements

• Redesigned user interface 💫 with a more modern design
• Centralized CSS variables 🎛️ for easier maintenance
• Bug fixes 🐛 (typo align-item → align-items)
• Better organization 📁 of accordion styles

⚡Performance Optimizations

• Advanced throttling system 🚦 to limit frequent updates
• Enhanced resource management 🔧 with optimized ResourceManager
• Reduced unnecessary re-renders 🎯 through better change tracking

🔄 CI/CD Configuration

• Added GitHub workflow 🔄 for automatic stale issue management
• Automatic closure after 15 days of inactivity with reopening capability ⏰

🐞 Bug Fixes

• [Bug #53] Fixed an issue where custom theme icons were not displaying correctly.
• Improved Jinja processing 🔧 for templates
  During the copy-paste operation, the embedded template card displayed the Jinja syntax rather than the rendered output.
• Better validation ✅ of configuration fields
• Fixed demo mode handling 🎮

✅ Take away

• Enhanced user experience 😊 in the editor
• Better compatibility 🤝 with different Home Assistant card
• Improved performance 🚀 through throttling and optimized resource management
• Easier maintenance 🔧 with clearer CSS structure

➡️ Documentation: entity-progress-card GitHub repo
➡️ Full Changelog: 1.4.3...1.4.4

1.4.3

What's new

This update brings you more control and clarity under the hood:

• Updated internal code documentation for better clarity and maintainability.
• Changed logging strategy in development mode for enhanced debugging.

🧪 Feature Enhancements

• Performance improvements: finer tracking of state changes before triggering updates.
  Added a ChangeTracker class to detect and handle changes in the hass state efficiently.
• Reworked theme and color management with a cleaner, more dynamic ThemeManager.
  Vertical layout icons with hidden icons now support a single-line display.
  This new feature may cause automatic resizing if your layout is not fixed and you intend to maintain two or more rows without icons. Don't panic! You can adjust your grid setup to your requirements in the card editor.
  request: @Lemonadel #47

🎨 UI/UX Improvements

• Added structured comments, emoji tags (🛠️, 📦, ✅), and well-documented class sections (// === SECTION ===) to improve readability.
• Improved the configuration editor (EntityProgressCardEditor) with:
  • Better event handling
  • Clear mapping of editor fields
  • Automatic updates and validation
• Introduced demo mode for templates (EntityProgressTemplate), simulating entity values for preview.

🔄 CI/CD Configuration

• Updated the release.yaml workflow to:
  • Automatically clean up .js files from logger/debug-related patterns.
  • Enforce code style (e.g., removing trailing spaces).

➡️ Documentation: entity-progress-card GitHub repo
➡️ Full Changelog: 1.4.2...1.4.3

1.4.2

What's new

Transform your dashboard experience with the latest Entity Progress Card – where beautiful design meets powerful functionality, giving you the tools to create interfaces that truly reflect your vision.

🎯 New "Badge" Mode

A more compact version of the card is now available: perfect for badge-style views (e.g., in previews or condensed dashboards). It displays key information in a smaller, cleaner format.

• request: @peyn #43
• Documentation: here

🖼 "Frameless" Option

• frameless: added
  You can now enable a frameless mode without borders and background (frameless) for even smoother integration into your existing card.
  • request: @davidlb #45
  • Documentation: here

🎨 Extended Color Customization

Custom themes can now handle separately: added

• icon color (icon_color)
• progress bar color (bar_color)
• background color (color)
  • request: @LeCreepyboy #49
  • Documentation: here

💅 Visual Improvements

• Better color management with transparency support
• Icon is now better positioned and more visible
• Shrink card if icon is hidden and layout is vertical
  • request: @Lemonadel #47

⚙️ Performance and Reliability

• Faster and smoother rendering thanks to optimized DOM management
• Better compatibility with Home Assistant dynamic updates
• Improved error handling (standard error + network)
  • bug: @mooseBringer #48

To enjoy all these new features, remember to clear your browser cache if necessary after the update.
Need help or a configuration example? Check out the updated documentation or ask questions!

➡️ Documentation: entity-progress-card GitHub repo
➡️ Full Changelog: 1.4.1...1.4.2

1.4.1

What's New

We're excited to roll out a new update for the Entity Progress Card Template, continuing our mission to make your dashboards more flexible, expressive, and visually refined.

🌈 Improvements

This release brings several key enhancements:

• Improved display in the card gallery
  Your card now integrates more smoothly into the card selector interface, with a cleaner, more informative preview.

• New standard parameters support
  We’ve introduced additional layout and style customization options to better fit your UI needs:

  Variable	Description
  bar_orientation	Define the direction of the progress bar (e.g., ltr, rtl)
  bar_size	Customize the size or thickness of the progress bar
  layout	Adjust the overall layout (e.g., horizontal, vertical)

Stay inspired, and keep building ✨

➡️ Documentation: entity-progress-card GitHub repo
➡️ Full Changelog: 1.4.0...1.4.1

1.4.0

What's new

🆕 New Card: Entity Progress Card Template

We’re excited to introduce a powerful new addition to our card library: the Entity Progress Card Template.

This card is designed to handle more advanced use cases that aren't fully supported by the base card. It avoids the need for custom helpers by allowing you to implement your desired mathematical modeling directly through templating.

🧠 Why Use This Card?

This card is ideal for situations where:

• You want to show calculated progress (e.g., level, usage, battery life)
• You need to apply dynamic logic or math modeling directly in the card
• The base card doesn't offer the required level of customization

➡️ Documentation: here
➡️ Full Changelog: 1.3.14...1.4.0

1.3.14

What's new

Small improvements to prepare the future.

• Code optimizations across the application.
• Fixed a side effect introduced by a previous optimization that affected select fields.
• Preparation for version 1.4 to support upcoming changes.

1.3.13

What's new

Some users have reported issues with toggle components not behaving as expected in certain cases.

🔧 update to enhance the stability and reliability of toggle functionality across the interface.
🔧 reduce DOM update during YAML edit

This improvement addresses inconsistencies and ensures a smoother, more predictable user experience.

Full Changelog: 1.3.12...1.3.13