diff --git a/README.md b/README.md
index ea4c46540..a4fc678af 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,8 @@
 <div align="center">
 
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="packages/docs/static/img/dockview-lockup-dark.svg">
-  <img src="packages/docs/static/img/dockview-lockup-light.svg" alt="Dockview" width="480">
+  <source media="(prefers-color-scheme: dark)" srcset="static/img/dockview-lockup-dark.svg">
+  <img src="static/img/dockview-lockup-light.svg" alt="Dockview" width="480">
 </picture>
 
 <h1>docking engine for the web</h1>
@@ -20,7 +20,7 @@
 
 ---
 
-![A Dockview layout showing docked, tabbed and split panels in a trading workbench](packages/docs/static/img/demo-hero.webp)
+![A Dockview layout showing docked, tabbed and split panels in a trading workbench](static/img/demo-hero.webp)
 
 Please see the website: https://dockview.dev
 
diff --git a/packages/dockview-angular/README.md b/packages/dockview-angular/README.md
index 732c8a928..0b84406b4 100644
--- a/packages/dockview-angular/README.md
+++ b/packages/dockview-angular/README.md
@@ -1,8 +1,8 @@
 <div align="center">
 
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://github.com/mathuo/dockview/blob/HEAD/packages/docs/static/img/dockview-lockup-dark.svg?raw=true">
-  <img src="https://github.com/mathuo/dockview/blob/HEAD/packages/docs/static/img/dockview-lockup-light.svg?raw=true" alt="Dockview" width="480">
+  <source media="(prefers-color-scheme: dark)" srcset="https://github.com/mathuo/dockview/blob/HEAD/static/img/dockview-lockup-dark.svg?raw=true">
+  <img src="https://github.com/mathuo/dockview/blob/HEAD/static/img/dockview-lockup-light.svg?raw=true" alt="Dockview" width="480">
 </picture>
 
 <h1>dockview-angular</h1>
@@ -20,7 +20,7 @@
 
 ---
 
-![A Dockview layout showing docked, tabbed and split panels in a trading workbench](https://github.com/mathuo/dockview/blob/HEAD/packages/docs/static/img/demo-hero.webp?raw=true)
+![A Dockview layout showing docked, tabbed and split panels in a trading workbench](https://github.com/mathuo/dockview/blob/HEAD/static/img/demo-hero.webp?raw=true)
 
 Please see the website: https://dockview.dev
 
diff --git a/packages/dockview-core/README.md b/packages/dockview-core/README.md
index 52b38470f..84b550a60 100644
--- a/packages/dockview-core/README.md
+++ b/packages/dockview-core/README.md
@@ -1,8 +1,8 @@
 <div align="center">
 
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://github.com/mathuo/dockview/blob/HEAD/packages/docs/static/img/dockview-lockup-dark.svg?raw=true">
-  <img src="https://github.com/mathuo/dockview/blob/HEAD/packages/docs/static/img/dockview-lockup-light.svg?raw=true" alt="Dockview" width="480">
+  <source media="(prefers-color-scheme: dark)" srcset="https://github.com/mathuo/dockview/blob/HEAD/static/img/dockview-lockup-dark.svg?raw=true">
+  <img src="https://github.com/mathuo/dockview/blob/HEAD/static/img/dockview-lockup-light.svg?raw=true" alt="Dockview" width="480">
 </picture>
 
 <h1>dockview-core</h1>
diff --git a/packages/dockview-enterprise/README.md b/packages/dockview-enterprise/README.md
index d0181dee2..cc324363d 100644
--- a/packages/dockview-enterprise/README.md
+++ b/packages/dockview-enterprise/README.md
@@ -1,8 +1,8 @@
 <div align="center">
 
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://github.com/mathuo/dockview/blob/HEAD/packages/docs/static/img/dockview-lockup-dark.svg?raw=true">
-  <img src="https://github.com/mathuo/dockview/blob/HEAD/packages/docs/static/img/dockview-lockup-light.svg?raw=true" alt="Dockview" width="480">
+  <source media="(prefers-color-scheme: dark)" srcset="https://github.com/mathuo/dockview/blob/HEAD/static/img/dockview-lockup-dark.svg?raw=true">
+  <img src="https://github.com/mathuo/dockview/blob/HEAD/static/img/dockview-lockup-light.svg?raw=true" alt="Dockview" width="480">
 </picture>
 
 <h1>dockview-enterprise</h1>
diff --git a/packages/dockview-react/README.md b/packages/dockview-react/README.md
index 74b93574c..75b45a8b6 100644
--- a/packages/dockview-react/README.md
+++ b/packages/dockview-react/README.md
@@ -1,8 +1,8 @@
 <div align="center">
 
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://github.com/mathuo/dockview/blob/HEAD/packages/docs/static/img/dockview-lockup-dark.svg?raw=true">
-  <img src="https://github.com/mathuo/dockview/blob/HEAD/packages/docs/static/img/dockview-lockup-light.svg?raw=true" alt="Dockview" width="480">
+  <source media="(prefers-color-scheme: dark)" srcset="https://github.com/mathuo/dockview/blob/HEAD/static/img/dockview-lockup-dark.svg?raw=true">
+  <img src="https://github.com/mathuo/dockview/blob/HEAD/static/img/dockview-lockup-light.svg?raw=true" alt="Dockview" width="480">
 </picture>
 
 <h1>dockview-react</h1>
@@ -20,7 +20,7 @@
 
 ---
 
-![A Dockview layout showing docked, tabbed and split panels in a trading workbench](https://github.com/mathuo/dockview/blob/HEAD/packages/docs/static/img/demo-hero.webp?raw=true)
+![A Dockview layout showing docked, tabbed and split panels in a trading workbench](https://github.com/mathuo/dockview/blob/HEAD/static/img/demo-hero.webp?raw=true)
 
 Please see the website: https://dockview.dev
 
diff --git a/packages/dockview-vue/README.md b/packages/dockview-vue/README.md
index 1180146b8..fef75453f 100644
--- a/packages/dockview-vue/README.md
+++ b/packages/dockview-vue/README.md
@@ -1,8 +1,8 @@
 <div align="center">
 
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://github.com/mathuo/dockview/blob/HEAD/packages/docs/static/img/dockview-lockup-dark.svg?raw=true">
-  <img src="https://github.com/mathuo/dockview/blob/HEAD/packages/docs/static/img/dockview-lockup-light.svg?raw=true" alt="Dockview" width="480">
+  <source media="(prefers-color-scheme: dark)" srcset="https://github.com/mathuo/dockview/blob/HEAD/static/img/dockview-lockup-dark.svg?raw=true">
+  <img src="https://github.com/mathuo/dockview/blob/HEAD/static/img/dockview-lockup-light.svg?raw=true" alt="Dockview" width="480">
 </picture>
 
 <h1>dockview-vue</h1>
@@ -20,7 +20,7 @@
 
 ---
 
-![A Dockview layout showing docked, tabbed and split panels in a trading workbench](https://github.com/mathuo/dockview/blob/HEAD/packages/docs/static/img/demo-hero.webp?raw=true)
+![A Dockview layout showing docked, tabbed and split panels in a trading workbench](https://github.com/mathuo/dockview/blob/HEAD/static/img/demo-hero.webp?raw=true)
 
 Please see the website: https://dockview.dev
 
diff --git a/packages/dockview/README.md b/packages/dockview/README.md
index 1e7b67f81..b5d387ba4 100644
--- a/packages/dockview/README.md
+++ b/packages/dockview/README.md
@@ -1,8 +1,8 @@
 <div align="center">
 
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://github.com/mathuo/dockview/blob/HEAD/packages/docs/static/img/dockview-lockup-dark.svg?raw=true">
-  <img src="https://github.com/mathuo/dockview/blob/HEAD/packages/docs/static/img/dockview-lockup-light.svg?raw=true" alt="Dockview" width="480">
+  <source media="(prefers-color-scheme: dark)" srcset="https://github.com/mathuo/dockview/blob/HEAD/static/img/dockview-lockup-dark.svg?raw=true">
+  <img src="https://github.com/mathuo/dockview/blob/HEAD/static/img/dockview-lockup-light.svg?raw=true" alt="Dockview" width="480">
 </picture>
 
 <h1>dockview</h1>
@@ -20,7 +20,7 @@
 
 ---
 
-![A Dockview layout showing docked, tabbed and split panels in a trading workbench](https://github.com/mathuo/dockview/blob/HEAD/packages/docs/static/img/demo-hero.webp?raw=true)
+![A Dockview layout showing docked, tabbed and split panels in a trading workbench](https://github.com/mathuo/dockview/blob/HEAD/static/img/demo-hero.webp?raw=true)
 
 Please see the website: https://dockview.dev
 
diff --git a/packages/docs/docusaurus.config.js b/packages/docs/docusaurus.config.js
index 680ebebc4..e5efa9f19 100644
--- a/packages/docs/docusaurus.config.js
+++ b/packages/docs/docusaurus.config.js
@@ -51,6 +51,10 @@ const config = {
         defaultLocale: 'en',
         locales: ['en'],
     },
+    // Serve both the docs-local `static` directory and the repository root
+    // `static` directory. Shared assets referenced from package READMEs live in
+    // the root `static/` so their links stay resilient to docs restructuring.
+    staticDirectories: ['static', path.resolve(__dirname, '../../static')],
     stylesheets: [
         {
             href: 'https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@20..48,100..700,0..1,-50..200',
diff --git a/packages/docs/static/img/demo-hero.webp b/static/img/demo-hero.webp
similarity index 100%
rename from packages/docs/static/img/demo-hero.webp
rename to static/img/demo-hero.webp
diff --git a/packages/docs/static/img/dockview-lockup-dark.svg b/static/img/dockview-lockup-dark.svg
similarity index 100%
rename from packages/docs/static/img/dockview-lockup-dark.svg
rename to static/img/dockview-lockup-dark.svg
diff --git a/packages/docs/static/img/dockview-lockup-light.svg b/static/img/dockview-lockup-light.svg
similarity index 100%
rename from packages/docs/static/img/dockview-lockup-light.svg
rename to static/img/dockview-lockup-light.svg