v1.1 — Community findings, source code analysis, Mushroom expansion

v1.1 — Community findings, source code analysis, Mushroom expansion

---

What's new

Bubble Card — source code analysis

A full read of the Bubble Card 3.2.2 source revealed several undocumented or
incorrectly documented options. All of these are now in bubble-card-ref.md.

Pop-up card — newly documented options:

Option	What it does
popup_style	classic gives a traditional dialog header instead of the default bottom-sheet style
popup_mode: adaptive-dialog	Fourth popup_mode — centered on desktop, bottom sheet on mobile
show_header	Hide the entire pop-up header including close/back buttons
show_close_button	Hide the X button while keeping the header
show_previous_button	Show a back (←) button in the header
buttons_position	right / left — position of header action buttons
main_buttons_position	Position pop-up header sub-buttons: default (inline) or bottom (as a row below header)
main_buttons_alignment	Alignment of bottom-positioned header sub-buttons
close_on_click	Close the pop-up after any tap inside it
auto_close	Auto-close after N milliseconds
slide_to_close_distance	Swipe distance to close (default 400px)
bg_opacity	Default is 88 (not 100) — pop-ups are semi-transparent by default
width_desktop	Default is 540px (corrected from 560px)
backdrop_blur	Blur the backdrop behind the pop-up (separate from bg_blur)
performance_mode	performance delays rendering and disables blur for slow devices
close_action	Action triggered when the pop-up closes
trigger + trigger_close	Conditions array for auto-opening; confirmed trigger_entity/trigger_state are deprecated
empty-column card type	Blank placeholder card for grid alignment

Sub-buttons — footer_mode: The sub-buttons card can be pinned as a fixed footer
bar with footer_mode: true, footer_full_width, footer_width, and footer_bottom_offset.

HBS — undocumented options: rise_animation, hide_gradient, margin, width_desktop
now documented. rise_animation: false recommended for wall panels (plays on every load).

---

Bubble Card — community forum (pages 149–153)

• Two-tap pop-up navigation — navigating from one open pop-up to another now
  closes the first pop-up in v3.2.x. Added as a pitfall row and troubleshooting entry.
• ha-view-sections-row-gap — HA 2026.4 increased default section row spacing.
  Added to css-theme-ref.md with override pattern, and to troubleshooting.
• rows: key — decimal multiplier for card height (e.g. rows: 1.4).
  Documented in button options table.
• Sub-button font CSS selectors — .bubble-sub-button and
  .bubble-sub-button-bottom-container .bubble-sub-button for per-row font size control.
• card-mod overflow: hidden clipping — new #cardmod-overflow-clipping
  troubleshooting section with CSS workaround and Bubble Card module alternative.
• Patreon modules — Bubble Badges v2, Bubble Weather, Bubble Calendar Enhanced,
  Bubble Neon, Custom Dropdown documented with Patreon link and guidance on how to
  handle them in prompts.
• HA 2026.4 / 2026.5 compatibility — both breaking changes documented in
  version-compat with affected versions and fixes.
• background_update — v3.2.1 does intelligent lazy updates by default;
  manual background_update: true no longer recommended.
• Sub-buttons on pop-ups — v3.2.1 automatically shows header when sub-buttons
  are configured on a pop-up card.
• Version pin corrected to 3.2.1 (stable release).

---

Streamline Card — source code analysis

Three findings from evaluateJavascript-helper.js, evaluateVariables-helper.js,
and templateLoader.js:

areas context variable — The JS evaluation context exposes four variables:
states, user, variables, and areas. The areas object (HA area registry,
keyed by area ID) was undocumented. Now documented with two worked examples:
displaying an entity's area name via CSS, and dynamically generating cards for
all lights in a named area.

!include tag — Streamline's own !include tag loads external YAML files
relative to the current file's URL. Unlike HA's !include_dir_named, this works
in both UI-mode and YAML-mode and supports nested includes. Documented with a
comparison table and folder structure example.

Background revalidation — After the initial load, Streamline fetches templates
in the background with a cache-busting URL and updates cards automatically when the
content changes. Hard refresh is usually not required after template edits. The
previously overstated "always hard refresh + restart HA" instruction has been
corrected across streamline-ref.md, troubleshooting-ref.md, and SKILL.md.

---

Mushroom Cards — expanded documentation

New #mushroom-cards-overview section in mushroom-theme-ref.md:

• Bubble vs Mushroom decision guide — when to use each for the same entity
• Mushroom entity card — icon_color options, state-based colour, fill_container
• Mushroom light card — full RGB/CCT colour picker, when to use vs Bubble Card sliders
• Mushroom person card — photo support, layout options
• Mushroom climate card — compact HVAC mode selector, when to use vs Bubble Card climate

---

SKILL.md — description trimmed

The description: field is now 727 characters (was 3,580), within the
1,024-character limit for Claude Project uploads.

---

Files changed

File	Changes
references/bubble-card-ref.md	Pop-up options table extended (+18 options), sub-button font selectors, footer_mode, HBS options, Patreon modules, HA 2026.4/5 compat, rows: key, cardmod-overflow-clipping
references/streamline-ref.md	!include tag section, areas context variable with examples, background revalidation corrected
references/troubleshooting-ref.md	#cardmod-overflow-clipping section, Streamline cache advice corrected, ha-view-sections-row-gap row
references/mushroom-theme-ref.md	#mushroom-cards-overview section (entity, light, person, climate cards)
references/css-theme-ref.md	ha-view-sections-row-gap structural variable
SKILL.md	Description trimmed to 727 chars, pitfall rows for two-tap nav + font loader, Streamline cache pitch softened

Component versions

Component	Version
Bubble Card	3.2.1 (stable)
Bubble Card Tools	1.0.2
Streamline Card	0.2.2
Sidebar Card	0.1.9.9
HA minimum	2024.3.0