+ );
+}
diff --git a/inject_override.py b/inject_override.py
new file mode 100644
index 0000000000..062f457766
--- /dev/null
+++ b/inject_override.py
@@ -0,0 +1,140 @@
+#!/usr/bin/env python3
+"""Inject docusaurus-override.css and eventmesh-internal.js into all Docusaurus HTML pages.
+Updates cache-busting version parameter to force browser reload.
+"""
+import os
+import re
+import sys
+from pathlib import Path
+
+SITE_ROOT = Path(__file__).parent
+OLD_CSS_VERSION = '20260704m'
+OLD_JS_VERSION = '20260704m'
+NEW_VERSION = '20260704n'
+
+# Files to inject
+CSS_FILE = '/assets/css/docusaurus-override.css'
+JS_FILE = '/assets/js/eventmesh-internal.js'
+
+# Theme init script (must be before any Docusaurus JS)
+THEME_INIT = ''''''
+
+css_inject = f''
+js_inject = f''
+
+def is_docusaurus_page(content):
+ """Check if this is a Docusaurus page with navbar."""
+ return 'class="navbar' in content or 'navbar__inner' in content
+
+def process_file(filepath):
+ with open(filepath, 'r', encoding='utf-8') as f:
+ content = f.read()
+
+ if not is_docusaurus_page(content):
+ return False, "not a docusaurus page"
+
+ modified = False
+
+ # 1. Update CSS link version
+ # Find old CSS link and replace version
+ old_css = f'{CSS_FILE}?v={OLD_CSS_VERSION}'
+ if old_css in content:
+ content = content.replace(old_css, f'{CSS_FILE}?v={NEW_VERSION}')
+ modified = True
+ else:
+ # CSS link exists but with different/no version — update it
+ # Find
+ css_pattern = re.compile(
+ r''
+ )
+ match = css_pattern.search(content)
+ if match:
+ content = content[:match.start()] + css_inject + content[match.end():]
+ modified = True
+ else:
+ # Inject CSS after the existing styles.4f054d44.css link
+ styles_match = re.search(r']*>', content)
+ if styles_match:
+ insert_pos = styles_match.end()
+ content = content[:insert_pos] + '\n' + css_inject + content[insert_pos:]
+ modified = True
+
+ # 2. Update JS script version
+ old_js = f'{JS_FILE}?v={OLD_JS_VERSION}'
+ if old_js in content:
+ content = content.replace(old_js, f'{JS_FILE}?v={NEW_VERSION}')
+ modified = True
+ else:
+ # JS script exists with different/no version
+ js_pattern = re.compile(
+ r''
+ )
+ match = js_pattern.search(content)
+ if match:
+ content = content[:match.start()] + js_inject + content[match.end():]
+ modified = True
+ else:
+ # Inject JS before
+ body_close = content.rfind('')
+ if body_close > 0:
+ content = content[:body_close] + js_inject + '\n' + content[body_close:]
+ modified = True
+
+ # 3. Inject anti-logo-flash inline style right after — absolute first CSS rule.
+ # This prevents the old Docusaurus logo.png from flashing during SPA navigation,
+ # before any external stylesheet is parsed. The html prefix + !important give max specificity.
+ ANTI_FLASH_STYLE = ''
+ anti_flash_present = 'data-em-anti-flash' in content
+ if not anti_flash_present:
+ head_close = content.find('')
+ if head_close > 0:
+ insert_pos = head_close + len('')
+ content = content[:insert_pos] + '\n' + ANTI_FLASH_STYLE + content[insert_pos:]
+ modified = True
+
+ # 4. Ensure theme init script is before any Docusaurus scripts in + # Check if already has our theme init
+ theme_init_present = 'localStorage.getItem("eventmesh-theme")' in content
+ if not theme_init_present:
+ # Find the Docusaurus theme script that sets dark:
+ docusaurus_theme = 'data-theme","dark");h.classList.add("dark")'
+ if docusaurus_theme in content:
+ # Insert our theme init BEFORE the Docusaurus one
+ idx = content.find(docusaurus_theme)
+ # Find the start of this script tag
+ script_start = content.rfind('
+ 
+