diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
index c70fdef..591dc8a 100644
--- a/.github/workflows/deploy.yml
+++ b/.github/workflows/deploy.yml
@@ -5,6 +5,10 @@ on:
     branches:
       - master
       - main
+    paths:
+      - 'gh-pages/**'
+      - 'mkdocs.yml'
+      - '.github/workflows/deploy.yml'
   workflow_dispatch:
 
 permissions:
diff --git a/docs/architecture.md b/gh-pages/architecture.md
similarity index 100%
rename from docs/architecture.md
rename to gh-pages/architecture.md
diff --git a/docs/cli-wizard.md b/gh-pages/cli-wizard.md
similarity index 100%
rename from docs/cli-wizard.md
rename to gh-pages/cli-wizard.md
diff --git a/docs/configuration.md b/gh-pages/configuration.md
similarity index 100%
rename from docs/configuration.md
rename to gh-pages/configuration.md
diff --git a/docs/index.md b/gh-pages/index.md
similarity index 100%
rename from docs/index.md
rename to gh-pages/index.md
diff --git a/docs/installation.md b/gh-pages/installation.md
similarity index 100%
rename from docs/installation.md
rename to gh-pages/installation.md
diff --git a/docs/javascripts/mathjax.js b/gh-pages/javascripts/mathjax.js
similarity index 100%
rename from docs/javascripts/mathjax.js
rename to gh-pages/javascripts/mathjax.js
diff --git a/docs/map-reduce-caching.md b/gh-pages/map-reduce-caching.md
similarity index 100%
rename from docs/map-reduce-caching.md
rename to gh-pages/map-reduce-caching.md
diff --git a/docs/performance-vram.md b/gh-pages/performance-vram.md
similarity index 100%
rename from docs/performance-vram.md
rename to gh-pages/performance-vram.md
diff --git a/docs/screenshots/vram_usage.png b/gh-pages/screenshots/vram_usage.png
similarity index 100%
rename from docs/screenshots/vram_usage.png
rename to gh-pages/screenshots/vram_usage.png
diff --git a/docs/security-concurrency.md b/gh-pages/security-concurrency.md
similarity index 100%
rename from docs/security-concurrency.md
rename to gh-pages/security-concurrency.md
diff --git a/docs/stylesheets/extra.css b/gh-pages/stylesheets/extra.css
similarity index 100%
rename from docs/stylesheets/extra.css
rename to gh-pages/stylesheets/extra.css
diff --git a/mkdocs.yml b/mkdocs.yml
index 93e0107..146fc11 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -2,6 +2,7 @@ site_name: Code-Reducer
 site_description: Lightweight, high-performance CLI tool for generating developer-friendly code wikis using local LLMs via Ollama.
 site_author: Arrase
 site_url: https://arrase.github.io/code-reducer/
+docs_dir: gh-pages
 
 repo_name: arrase/code-reducer
 repo_url: https://github.com/arrase/code-reducer