diff --git a/index.html b/index.html
index 10a43d8..31f4623 100644
--- a/index.html
+++ b/index.html
@@ -2,12 +2,13 @@
 <html lang="en">
   <head>
     <meta charset="UTF-8" />
-    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <link rel="icon" type="image/svg+xml" href="/crdc-demo/favicon.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>CRDC Arrests API Demo — Civilytics</title>
   </head>
   <body>
     <div id="root"></div>
+    <!-- Vite injects the correct script tag with base-relative path -->
     <script type="module" src="/src/main.jsx"></script>
   </body>
 </html>
diff --git a/public/favicon.svg b/public/favicon.svg
new file mode 100644
index 0000000..b8bb935
--- /dev/null
+++ b/public/favicon.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill="#C25311" d="M8 0a8 8 0 1 0 0 16A8 8 0 0 0 8 0z"/></svg>
diff --git a/vite.config.mjs b/vite.config.mjs
index 4acedce..a3ef45e 100644
--- a/vite.config.mjs
+++ b/vite.config.mjs
@@ -1,8 +1,11 @@
 import { defineConfig } from 'vite'
 import react from '@vitejs/plugin-react-swc'
 
+// The app is served at /crdc-demo/ on pages.civilytics.org.
+// Set base to the subdirectory so asset paths resolve correctly.
 export default defineConfig({
   plugins: [react()],
   server: { port: 5173 },
   build: { outDir: 'dist', sourcemap: true },
+  base: '/crdc-demo/',  // Required for subdirectory deployment on git-pages
 })