stack-site-builder 1.19.4 → 1.19.5

package/CHANGELOG.md

@@ -11,6 +11,16 @@ content schema, while a consuming site supplies only content, taxonomy data and
 config. Sites track the theme with `pnpm up stack-site-builder`, so each release
 here is a plain version bump they pull in.
 
+## [1.19.5] - 2026-07-24
+
+### Added
+
+- **`iconInvert` for dark mode** — black line-art icons (e.g. Tabler-style
+  SVGs) vanished on the dark card background. Home cards and the home hero
+  (`iconInvert: true` in `site.home`), and product entries (`iconInvert`
+  frontmatter — applies on the products index and the landing hero) can now
+  flag an icon to be color-inverted when the dark theme is active.
+
 ## [1.19.4] - 2026-07-24
 
 ### Fixed

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "stack-site-builder",
   "type": "module",
-  "version": "1.19.4",
+  "version": "1.19.5",
   "license": "MIT",
   "description": "The engine behind the awesome-*-stack catalog sites: an Astro theme with the catalog/concepts/articles/slides/samples routes, components, styles and markdown pipeline. Sites provide content, taxonomy data and config.",
   "repository": {

package/src/components/CardsHome.astro

@@ -29,7 +29,7 @@ const resolveHref = (href: string, external?: boolean) =>
 ---
 
 <section class="py-14 text-center">
-  {h?.hero?.icon && <img src={withBase(h.hero.icon)} alt="" class="mx-auto h-20 w-20 rounded-[22%] object-contain" />}
+  {h?.hero?.icon && <img src={withBase(h.hero.icon)} alt="" class:list={['mx-auto h-20 w-20 rounded-[22%] object-contain', h.hero.iconInvert && 'aas-icon-invert']} />}
   <h1 class="mt-5 text-4xl font-bold tracking-tight sm:text-5xl">{heroTitle}</h1>
   <p class="mx-auto mt-4 max-w-2xl text-xl text-[var(--aas-muted)]" set:html={heroSubtitle} />
 </section>
@@ -50,7 +50,11 @@ const resolveHref = (href: string, external?: boolean) =>
                 <img
                   src={withBase(c.icon)}
                   alt=""
-                  class:list={['h-20 w-20 shrink-0 object-contain', c.rounded ? 'rounded-[22%]' : 'rounded-xl']}
+                  class:list={[
+                    'h-20 w-20 shrink-0 object-contain',
+                    c.rounded ? 'rounded-[22%]' : 'rounded-xl',
+                    c.iconInvert && 'aas-icon-invert',
+                  ]}
                   loading="lazy"
                 />
               )}

package/src/components/ProductLanding.astro

@@ -47,7 +47,7 @@ const altBg = (i: number) => i % 2 === 1;
     ]}
   >
     <div class="mx-auto max-w-[75rem] px-5">
-      {d.icon && <img src={withBase(d.icon)} alt="" class="mx-auto h-24 w-24 rounded-[22%] object-contain" />}
+      {d.icon && <img src={withBase(d.icon)} alt="" class:list={['mx-auto h-24 w-24 rounded-[22%] object-contain', d.iconInvert && 'aas-icon-invert']} />}
       <h1 class="mt-6 text-4xl font-bold tracking-tight sm:text-5xl">{d.title}</h1>
       {d.subtitle && <p class="mt-3 text-xl text-[var(--aas-muted)]" set:html={d.subtitle} />}
       {

package/src/components/ProductsIndex.astro

@@ -54,7 +54,7 @@ const sections = productTree.roots
             class="aas-lift flex items-center gap-6 rounded-3xl border border-[var(--aas-border)] bg-[var(--aas-panel)] p-6 no-underline"
           >
             {a.data.icon && (
-              <img src={withBase(a.data.icon)} alt="" class="h-20 w-20 shrink-0 rounded-[22%] object-contain" loading="lazy" />
+              <img src={withBase(a.data.icon)} alt="" class:list={['h-20 w-20 shrink-0 rounded-[22%] object-contain', a.data.iconInvert && 'aas-icon-invert']} loading="lazy" />
             )}
             <span class="min-w-0">
               <span class="block text-xl font-semibold text-[var(--aas-text)]">{a.data.title}</span>

package/src/content.ts

@@ -430,6 +430,9 @@ export function defineAasCollections({
       // ---- hero ----
       subtitle: z.string().optional(),
       icon: z.string().optional(), // app icon (public/ path)
+      // Invert the icon in dark mode — for black line-art icons that would
+      // otherwise vanish on the dark card background.
+      iconInvert: z.boolean().default(false),
       // Free-form key a site can target from its CSS (`.aas-hero-bg-<key>`)
       // for a custom hero background.
       heroBg: z.string().optional(),

package/src/lib/home.ts

@@ -24,6 +24,9 @@ export interface HomeCard {
   description?: Localized;
   icon?: string; // public/ path
   rounded?: boolean; // app-icon style rounding for the icon
+  /** Invert the icon in dark mode — for black line-art icons that would
+   *  otherwise vanish on the dark card background. */
+  iconInvert?: boolean;
   tags?: string[] | Record<string, string[]>;
 }
 
@@ -31,6 +34,7 @@ export interface HomeConfig {
   template: 'cards';
   hero?: {
     icon?: string; // public/ path, shown above the title
+    iconInvert?: boolean; // invert the icon in dark mode (black line art)
     title?: Localized; // defaults to site.name
     subtitle?: Localized; // defaults to the site.tagline UI string
   };

package/src/styles/global.css

@@ -179,6 +179,12 @@ html {
 :root[data-theme='dark'] .aas-deprecated {
   color: #fbbf24;
 }
+/* Icons flagged `iconInvert` (home cards, products) are black line art that
+   would vanish on the dark card background — flip them to white in dark. */
+:root[data-theme='dark'] .aas-icon-invert {
+  filter: invert(1);
+}
+
 /* "No updates in 1+ year" — same amber warning weight as deprecated. */
 .aas-stale {
   background: color-mix(in srgb, #d97706 16%, transparent);