diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
index 787c5cc165..aa04051c9c 100644
--- a/docs/.vitepress/config.mts
+++ b/docs/.vitepress/config.mts
@@ -109,6 +109,9 @@ export default extendConfig(
         ],
       ],
       vite: {
+        optimizeDeps: {
+          include: ['mermaid > @braintree/sanitize-url'],
+        },
         resolve: {
           tsconfigPaths: true,
           alias: [