From 63a7984c878e215fb9965076a28611d4a2e62f1d Mon Sep 17 00:00:00 2001
From: Vijay Janapa Reddi <vj@eecs.harvard.edu>
Date: Tue, 30 Dec 2025 22:29:23 -0500
Subject: [PATCH] feat(kits): add dev preview announcement banner

---
 .github/workflows/kits-publish-dev.yml | 12 ++++++++++++
 kits/config/_quarto-html.yml           |  4 ++++
 kits/config/announcement.yml           | 16 ++++++++++++++++
 3 files changed, 32 insertions(+)
 create mode 100644 kits/config/announcement.yml

diff --git a/.github/workflows/kits-publish-dev.yml b/.github/workflows/kits-publish-dev.yml
index 7ec87d62b..c5960d627 100644
--- a/.github/workflows/kits-publish-dev.yml
+++ b/.github/workflows/kits-publish-dev.yml
@@ -68,6 +68,18 @@ jobs:
           echo "📦 Downloads folder contents:"
           ls -la kits/_build/assets/downloads/ || echo "No downloads folder"
 
+      - name: 🔧 Modify announcement for dev preview
+        run: |
+          echo "🔧 Modifying announcement banner for development preview..."
+          COMMIT_SHORT="${{ github.sha }}"
+          COMMIT_SHORT="${COMMIT_SHORT:0:8}"
+
+          python3 book/tools/scripts/publish/modify_dev_announcement.py \
+            kits/_build \
+            --verbose \
+            --commit-hash "${{ github.sha }}" \
+            --commit-short "$COMMIT_SHORT"
+
       - name: 🚀 Deploy to Dev Site via SSH
         env:
           SSH_DEPLOY_KEY: ${{ secrets.SSH_DEPLOY_KEY }}
diff --git a/kits/config/_quarto-html.yml b/kits/config/_quarto-html.yml
index 5cfa2ce96..37553ab79 100644
--- a/kits/config/_quarto-html.yml
+++ b/kits/config/_quarto-html.yml
@@ -207,3 +207,7 @@ format:
     include-after-body:
       - text: |
           <script src="assets/scripts/subscribe-modal.js" defer></script>
+
+# Announcement bar configuration
+metadata-files:
+  - config/announcement.yml
diff --git a/kits/config/announcement.yml b/kits/config/announcement.yml
new file mode 100644
index 000000000..08ffe4518
--- /dev/null
+++ b/kits/config/announcement.yml
@@ -0,0 +1,16 @@
+# =============================================================================
+# ANNOUNCEMENT BAR CONFIGURATION - HARDWARE KITS
+# =============================================================================
+# This file contains the announcement bar configuration for the kits site.
+# It's included via metadata-files in _quarto-html.yml
+# =============================================================================
+
+website:
+  announcement:
+    icon: megaphone
+    dismissable: true
+    type: primary
+    position: below-navbar
+    content: |
+      📦 **Hardware Kits:** Hands-on ML labs for Arduino, Seeed & Raspberry Pi. [Get started →](/contents/getting-started.html)<br>
+      📚 **Textbook:** Read the ML Systems book. [Explore →](https://mlsysbook.ai/book)