diff --git a/.github/workflows/deploy-github-pages.yaml b/.github/workflows/deploy-github-pages.yaml
index 5cdf75797..9b04b9786 100644
--- a/.github/workflows/deploy-github-pages.yaml
+++ b/.github/workflows/deploy-github-pages.yaml
@@ -27,6 +27,9 @@ jobs:
           cache: npm
           cache-dependency-path: package-lock.json
 
+      - name: Clear old docs references
+        run: make fresh
+
       - name: 🤔 Sync latest Upstream
         run: make sync-docs
 
diff --git a/.github/workflows/deploy-netlify.yaml b/.github/workflows/deploy-netlify.yaml
index 809099fff..2a1645f38 100644
--- a/.github/workflows/deploy-netlify.yaml
+++ b/.github/workflows/deploy-netlify.yaml
@@ -44,6 +44,9 @@ jobs:
     - name: Install Dependencies
       run: npm ci
 
+    - name: Clear old docs references
+      run: make fresh
+
     - name: Sync latest Upstream
       run: make sync-docs
 
diff --git a/.github/workflows/pr-verify-deployment.yaml b/.github/workflows/pr-verify-deployment.yaml
index 09105ddd8..3b6d806cf 100644
--- a/.github/workflows/pr-verify-deployment.yaml
+++ b/.github/workflows/pr-verify-deployment.yaml
@@ -20,6 +20,9 @@ jobs:
           cache: npm
           cache-dependency-path: package-lock.json
 
+      - name: Clear old docs references
+        run: make fresh
+
       - name: pull docs from current latest
         run: make sync-docs
 
diff --git a/Makefile b/Makefile
index b9771b144..d3699a851 100644
--- a/Makefile
+++ b/Makefile
@@ -18,6 +18,16 @@ dev-docs:
 latest-commits:
 	@bash ./scripts/sync-latest-commits.sh
 
+## fresh: Clear the current base doc source files for upstream repos
+# this is used for deployments to main to not hit divergent branch issues.
+.PHONY: fresh
+fresh:
+	rm -rf ./dsource-cosmos-sdk/
+	rm -rf ./dsource-cosmos-sdk-main/
+	rm -rf ./dsource-ibc-go/
+	rm -rf ./dsource-onboarding/
+	rm -rf ./dsource-cometbft/
+
 ## sync-docs: Grab the latest upstream documentation
 .PHONY: sync-docs
 sync-docs: