diff --git a/docs/rspress.config.ts b/docs/rspress.config.ts
index 0fa246a..4ade8c0 100644
--- a/docs/rspress.config.ts
+++ b/docs/rspress.config.ts
@@ -5,6 +5,11 @@ import { pluginLlms } from '@rspress/plugin-llms';
 export default defineConfig({
   root: path.join(__dirname, 'docs'),
   title: 'CodingScaffold',
+  // GitHub Pages serves this project at https://jrs1986.github.io/CodingScaffold/.
+  // Without `base`, rspress emits asset URLs at /static/... which resolve to the
+  // jrs1986.github.io apex and 404, leaving the deployed site unstyled. The trailing
+  // slash matters — rspress normalizes URLs against it.
+  base: '/CodingScaffold/',
   builderConfig: {
     server: {
       host: '127.0.0.1',