stack-site-builder 1.19.5 → 1.20.0

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.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.20.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';
@@ -378,21 +382,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} />