diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index efe25490..80562ab0 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -32,7 +32,11 @@ jobs:
 
       - name: Install dependencies
         working-directory: docs
-        run: yarn install --frozen-lockfile
+        run: |
+          # Remove package-lock.json to avoid conflicts
+          rm -f package-lock.json
+          # Force install with legacy peer deps to avoid warnings
+          yarn install --force --no-fund --silent --legacy-peer-deps
 
       - name: Build Docusaurus
         working-directory: docs
diff --git a/docs/docusaurus.config.ts b/docs/docusaurus.config.ts
index 37dc77a8..7dd5cb4e 100644
--- a/docs/docusaurus.config.ts
+++ b/docs/docusaurus.config.ts
@@ -27,6 +27,7 @@ const config: Config = {
       {
         docs: {
           sidebarPath: './sidebars.ts',
+          routeBasePath: '/', // This makes docs the main page
         },
         theme: {
           customCss: './src/css/custom.css',