Add cache-busting configuration to prevent browser caching issues

Author: chkry

astro.config.ts

@@ -14,6 +14,11 @@ import { SITE } from "./src/config";
 // https://astro.build/config
 export default defineConfig({
   site: SITE.website,
+  build: {
+    // Add cache busting with content hashes
+    inlineStylesheets: 'auto',
+    assets: '_astro',
+  },
   integrations: [
     sitemap({
       filter: page => SITE.showArchives || !page.endsWith("/archives"),
@@ -43,6 +48,21 @@ export default defineConfig({
     optimizeDeps: {
       exclude: ["@resvg/resvg-js"],
     },
+    build: {
+      // Enable CSS code splitting for better cache busting
+      cssCodeSplit: true,
+      // Generate manifest for cache busting
+      manifest: true,
+      // Add content hash to filenames
+      rollupOptions: {
+        output: {
+          // Ensure unique filenames for cache busting
+          entryFileNames: '_astro/[name].[hash].js',
+          chunkFileNames: '_astro/[name].[hash].js',
+          assetFileNames: '_astro/[name].[hash][extname]',
+        },
+      },
+    },
   },
   image: {
     responsiveStyles: true,

public/_headers

@@ -0,0 +1,41 @@
+# Cache busting headers for GitHub Pages
+# Prevents browser caching issues
+
+# HTML files - no cache, always revalidate
+/*.html
+  Cache-Control: no-cache, no-store, must-revalidate
+  Pragma: no-cache
+  Expires: 0
+
+/
+  Cache-Control: no-cache, no-store, must-revalidate
+  Pragma: no-cache
+  Expires: 0
+
+# Service Worker - never cache
+/sw.js
+  Cache-Control: no-cache, no-store, must-revalidate
+  Pragma: no-cache
+  Expires: 0
+
+# Static assets with hash - cache for 1 year
+/_astro/*
+  Cache-Control: public, max-age=31536000, immutable
+
+# Images - cache for 1 week
+/assets/*
+  Cache-Control: public, max-age=604800
+
+# Fonts - cache for 1 year
+/*.woff2
+  Cache-Control: public, max-age=31536000, immutable
+
+/*.woff
+  Cache-Control: public, max-age=31536000, immutable
+
+# JavaScript and CSS with hashes - cache for 1 year
+/*.js
+  Cache-Control: public, max-age=31536000, immutable
+
+/*.css
+  Cache-Control: public, max-age=31536000, immutable