Modules Overview

Modules Overview

Ultra Card ships 74 modules organized into seven categories. Every module has the same 4-tab editor (General / Actions / Logic / Design), so once you've learned one you've learned them all.

Pro modules are marked with (Pro). They require an UltraCard.io account + the Ultra Card Pro Cloud integration. See Pro-and-Cloud.

---

Content

Module	Description
Module-Text	Static or template-driven text
Module-Icon	Interactive icons with state-based styling and animations
Module-Info	Show entity state / attribute / unit
Module-Image	Display images (upload / URL / entity) with hover effects
Module-Markdown	Rich markdown content with templates
Module-Bar	Progress bars with animations and gradients
Module-Gauge	Sensor values as customizable gauges (11 styles)
Module-Graphs	Line / bar / pie / donut historical charts
Module-Camera	Live or still camera feeds
Module-Map	Interactive map with custom markers
Module-QR-Code	QR codes from URL, text, or entity (Pro)
Module-Badge-of-Honor	Animated Pro membership badge (Pro)

Data

Module	Description
Module-Area-Summary	Smart room tile (auto-discovers entities by HA area)
Module-Alert-Center	Active alerts in priority order
Module-Status-Summary	Entity activity with timestamps
Module-Activity-Feed	Real-time home activity timeline (Pro)
Module-Calendar	Multi-view calendar (Pro)
Module-Sports-Score	Live scores, schedules, team info (Pro)
Module-People	Person presence + customizable data items
Module-Solar-Analytics	Solar power / grid / battery widget (Pro)
Module-Energy-Display	Sankey-style energy flow (Pro)
Module-Grid	Customizable grid of entity tiles

Interactive

Module	Description
Module-Button	Multiple-style action buttons
Module-Toggle	Toggle / multi-state switcher
Module-Spinbox	Number input with +/-
Module-Dropdown	Select with action per option
Module-Light	Advanced light control (color / brightness / effects)
Module-Climate	Circular thermostat (Pro)
Module-Cover	Blinds / shutters / garage doors
Module-Fan	Speed / preset / oscillation / direction
Module-Lock	Lock / unlock / open
Module-Vacuum	Vacuum control with map and animations (Pro)
Module-Media-Player	Full-featured media player (compact / card / mini)
Module-Slider-Control	Premium slider for any controllable entity
Module-Timer	Countdown with optional action when expired
Module-Alarm-Panel	PIN-pad alarm control with status ring (Pro)
Module-Virtual-Pet	Tamagotchi-style mood pet (Pro)

Layout

Module	Description
Module-Horizontal	Side-by-side container with flex alignment
Module-Vertical	Vertical stack container
Module-Tabs	Tabbed switchable sections
Module-Accordion	Collapsible header reveals nested modules
Module-Popup	Modal popup container
Module-Slider	Carousel slideshow (use Pagebreak between pages)
Module-Pagebreak	Page divider inside a Slider
Module-Separator	Lines, divider with text, or blank space
Module-Navigation	Global navbar (routes, popups, media controls)
Module-Dynamic-List	Generate modules from a Jinja2 template loop

Media / Background

Module	Description
Module-Background	View-level background image
Module-Video-Background	YouTube / Vimeo / MP4 video backgrounds (Pro)
Module-Dynamic-Weather	Animated weather effects on the dashboard (Pro)
Module-Living-Canvas	Full-view WebGL background (Pro)
Module-Screensaver	Kiosk screensaver after idle (Pro)

Animated (Pro)

Module	Description
Module-Animated-Clock	Flip-clock with smooth animations
Module-Animated-Weather	Current weather with animated icons
Module-Animated-Forecast	Multi-day forecast with animated icons

Inputs (Helpers)

Module	Description
Text Input · Date/Time Input · Number Input · Slider Input · Select Input · Boolean Input · Button Input · Counter Input · Color Input	Form controls bound to HA input_* helpers. See Module-Input-Modules.

Card embeds

Module	Description
Module-Native-Card	Embed any built-in HA card
Module-3rd-Party-Card	Embed any 3rd-party Lovelace card (Bubble, Mushroom, ApexCharts…)

---

Picking the right module

If you want to...	Use
Show a value with a label	Info
Show a value as a colored bar	Bar
Show a value as a dial / gauge	Gauge
Plot history	Graphs
One-tap action with a label	Button
One-tap with state-based icons	Icon
Drag a value (light brightness, fan speed)	Slider Control
Pick a value from a list	Dropdown
Toggle a binary state	Toggle
Show a room with auto-discovered entities	Area Summary
Layout side-by-side	Horizontal
Layout stacked	Vertical
Tabs of different content	Tabs
Modal popup	Popup
Carousel	Slider + Pagebreak
Insert any HA / community card	Native Card / 3rd Party Card
Generate modules dynamically from a template	Dynamic List

---

Source of truth

The canonical list of module types and metadata lives in src/modules/module-manifest-data.ts. The BaseModule discriminated union in src/types.ts is the type-level source of truth.