stack-site-builder 1.19.5 → 1.21.0

package/CHANGELOG.md

@@ -11,6 +11,26 @@ 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.21.0] - 2026-07-24
+
+### Added
+
+- **Header brand options** — `site.header = { logo, logoInvert, name }`:
+  `logo` (a public/ path) replaces the hardcoded ⚡ bolt with the site's
+  mark, `name: false` drops the wordmark for a logo-only brand (the home
+  link keeps `site.name` as its aria-label), and `logoInvert` flips a
+  black line-art logo in dark mode. Defaults unchanged: ⚡ + site name.
+
+## [1.20.0] - 2026-07-24
+
+### Added
+
+- **Per-site custom footer** — footers are site identity, not theme chrome.
+  A site that ships `src/components/Footer.astro` (receiving a `lang` prop)
+  now replaces the theme's stock footer wholesale; without one, the stock
+  "Built with Astro" footer renders as before (now living in
+  `DefaultFooter.astro`, resolved through the `@aas-footer` alias).
+
 ## [1.19.5] - 2026-07-24
 
 ### Added

package/README.md

@@ -43,6 +43,7 @@ export const collections = defineAasCollections({ categoryMap });
 | `src/content/{stacks,concepts,courses,products,papers,articles,slides}/` | The content, one MDX file per locale |
 | `src/content/pages/` | Standalone top-level pages (e.g. an About/소개), rendered at `/<slug>/` and optionally linked in the header nav |
 | `public/` · `samples/` | Logos/favicons and runnable sample projects |
+| `src/components/Footer.astro` (optional) | Replaces the theme's stock footer wholesale — receives a `lang` prop |
 
 The theme reaches the site's data through the `@aas-data/*` alias (set up by
 the integration), so everything above is swappable per site.

package/index.mjs

@@ -15,6 +15,7 @@
 // components resolve per-site taxonomy (categories, glossary, site identity)
 // at build time.
 import { fileURLToPath } from 'node:url';
+import { existsSync } from 'node:fs';
 import mdx from '@astrojs/mdx';
 import sitemap from '@astrojs/sitemap';
 import tailwindcss from '@tailwindcss/vite';
@@ -175,6 +176,17 @@ export default function aasTheme({ glossary, sections = {} }) {
               alias: {
                 '@aas-data': fileURLToPath(new URL('./src/data', config.root)),
                 '@assets': fileURLToPath(new URL('./src/assets', config.root)),
+                // Footers are site identity, not theme chrome: when the site
+                // ships `src/components/Footer.astro`, BaseLayout renders it
+                // (via this alias) instead of the theme's stock footer.
+                '@aas-footer': (() => {
+                  const siteFooter = fileURLToPath(
+                    new URL('./src/components/Footer.astro', config.root),
+                  );
+                  return existsSync(siteFooter)
+                    ? siteFooter
+                    : fileURLToPath(new URL('./src/components/DefaultFooter.astro', import.meta.url));
+                })(),
               },
             },
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "stack-site-builder",
   "type": "module",
-  "version": "1.19.5",
+  "version": "1.21.0",
   "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/DefaultFooter.astro

@@ -0,0 +1,26 @@
+---
+// The theme's stock footer. A site replaces it wholesale by shipping its own
+// `src/components/Footer.astro` — the integration aliases `@aas-footer` to
+// that file when it exists (this one otherwise), so BaseLayout needs no
+// site-specific knowledge. A custom footer receives the same `lang` prop.
+import { useTranslations, type Lang } from '../i18n/ui';
+
+interface Props {
+  lang: Lang;
+}
+
+const { lang } = Astro.props;
+const t = useTranslations(lang);
+---
+
+<footer class="border-t border-[var(--aas-border)] py-8 text-center text-sm text-[var(--aas-muted)]">
+  <p>
+    {t('footer.builtWith')}
+    <a
+      href="https://astro.build"
+      target="_blank"
+      rel="noopener noreferrer"
+      class="text-[var(--aas-accent)]">Astro</a
+    >. {t('footer.contribute')}
+  </p>
+</footer>

package/src/layouts/BaseLayout.astro

@@ -6,6 +6,10 @@ import { useTranslations, languages, type Lang } from '../i18n/ui';
 import LanguageSwitcher from '../components/LanguageSwitcher.astro';
 import ThemeToggle from '../components/ThemeToggle.astro';
 import BackToTop from '../components/BackToTop.astro';
+// Resolved by the integration: the site's src/components/Footer.astro when it
+// exists, the theme's DefaultFooter otherwise.
+// @ts-expect-error -- virtual alias, no static types
+import Footer from '@aas-footer';
 import { getNavPages, pageSlugOf } from '../lib/pages';
 import { getNavProducts, getTopProducts, productSlugOf } from '../lib/products';
 import { homeTemplate } from '../lib/home';
@@ -49,6 +53,14 @@ const base = import.meta.env.BASE_URL;
 
 const baseNoSlash = base.replace(/\/$/, '');
 
+// Header brand: `site.header = { logo?: '/path.png', logoInvert?: bool,
+// name?: bool }`. A logo replaces the ⚡ bolt; `name: false` drops the
+// wordmark (logo-only brand — the link keeps site.name as its aria-label).
+const header = (site as { header?: { logo?: string; logoInvert?: boolean; name?: boolean } })
+  .header;
+const brandLogo = header?.logo;
+const brandName = header?.name !== false;
+
 // Home URL per locale, for the language auto-detect redirect on the root home.
 const localeHomes = Object.fromEntries(
   (Object.keys(languages) as Lang[]).map((c) => [c, getRelativeLocaleUrl(c, '')]),
@@ -262,9 +274,19 @@ const navItems = allNavItems.filter((item) => !item.section || sectionEnabled(it
           aria-label={site.name}
           class="flex min-w-0 items-center gap-1.5 text-base font-bold tracking-tight whitespace-nowrap no-underline sm:text-lg"
         >
-          <span aria-hidden="true">⚡</span>
-          {/* Below 600px only the bolt remains, so the narrow header never truncates the wordmark. */}
-          <span class="hidden truncate min-[600px]:inline">{site.name}</span>
+          {
+            brandLogo ? (
+              <img
+                src={`${baseNoSlash}${brandLogo}`}
+                alt=""
+                class:list={['h-7 w-7 shrink-0 object-contain', header?.logoInvert && 'aas-icon-invert']}
+              />
+            ) : (
+              <span aria-hidden="true">⚡</span>
+            )
+          }
+          {/* Below 600px only the mark remains, so the narrow header never truncates the wordmark. */}
+          {brandName && <span class="hidden truncate min-[600px]:inline">{site.name}</span>}
         </a>
         {/* Section links are icon-only (labels live in aria-label). On phones
             (<sm) they collapse into the labelled dropdown menu below, so the
@@ -378,21 +400,7 @@ const navItems = allNavItems.filter((item) => !item.section || sectionEnabled(it
       <slot />
     </main>
 
-    <footer
-      class="border-t border-[var(--aas-border)] py-8 text-center text-sm text-[var(--aas-muted)]"
-    >
-      <p>
-        {t('footer.builtWith')}
-        <a
-          href="https://astro.build"
-          target="_blank"
-          rel="noopener noreferrer"
-          class="text-[var(--aas-accent)]">Astro</a
-        >. {
-          t('footer.contribute')
-        }
-      </p>
-    </footer>
+    <Footer lang={lang} />
 
     <BackToTop lang={lang} />