v1.4.0 — coloured tag logos on a larger chip

The hero badge now shows each tag's icon/logo in its own colour on a solid white chip, instead of forcing every icon to white on a translucent chip (which turned full-logo tag icons — e.g. Font Awesome Kit conference/team logos — into washed-out white silhouettes).

• Icon takes the hero's primary colour, auto-darkened just enough to stay legible on white when the primary is light (hue preserved).
• Larger badge (92px tall) that widens to fit wide wordmark logos, with generous side padding.
• Glyph is flex-centred so icon-font baseline metrics can't push it off-centre.

v1.3.1 — fix border/shadow/margin not applying to the forum hero

Fixes a v1.3.0 regression: the new border, drop-shadow, and top/bottom margin options were saved (and previewed in the admin Hero Studio) but not applied to the actual forum hero — the forum resolver wasn't passing them through. All five now render correctly. Thanks to Stezkoy for the report.

v1.3.0 — secondary-tag heroes + border/shadow/margin + frame fix

New

• Secondary / child tag heroes — the Hero Studio now lists child tags too (shown as "Parent › Child"), so subcategories get their own hero.
• Border control — set border width (0 = none) and colour per hero.
• Drop-shadow control — none / soft / medium / strong.
• Header margin control — top & bottom margin per hero; the top margin accepts negative values so a banner can sit flush under a themed header.

Fixed

• 1px "black frame" on image heroes — the rounded-corner antialiasing could reveal the dark fallback behind a cover image; the image now overscans 1px so it never shows.

Thanks to tearofs and Stezkoy for the feedback.

v1.2.0 — live forum stats on the home hero

The home hero now shows live forum totals — discussions, posts and members — automatically, no setup needed (real numbers, not typed). A cached backend field exposes the counts; tag heroes still show their discussion count, and custom stats (v1.1.1) override either. Verified on flarum.test.

v1.1.1 — custom stats per hero (home too)

Adds a Stats editor to the Hero Studio: add your own stats (value, Font Awesome icon, label) to any hero — including the home hero, which previously had no stat source. Custom stats override the auto tag count, and are fully independent of the Show icon toggle (stats with no icon now work). Verified on flarum.test.

v1.1.0 — hide-icon + sharp-corners options

Two requested hero options:

• Show icon (default on) — turn off to hide the icon and its square background entirely, for a clean text-only hero.
• Sharp corners (default off) — square edges on the banner, icon badge and stat boxes instead of rounded.

Both are per-context (home + per tag) in the Hero Studio with live preview. Verified on flarum.test.

Hero Builder 1.0.0

A fully customizable, animated hero banner for your Flarum 2 discussion list — designed live, per page and per tag. The first public release.

• Title, subtitle, and any Font Awesome icon (type the class, no fixed presets)
• Animated two-colour gradient or a cover image
• Optional live community stats
• Per-context heroes — a distinct hero for the home page and for every tag
• Height + max-width controls
• Live Hero Studio editor in admin (live preview, per-context tabs)
• No core files touched

composer require ernestdefoe/hero-builder

MIT licensed.