WIP

Author: letiescanciano

docusaurus/.gitignore

@@ -8,7 +8,7 @@
 .docusaurus
 .cache-loader
 src/data/declarative_component_schema.yaml
-src/data/connector_registry_slim.json
+src/data/connector_registry_full.json
 
 # Misc
 .DS_Store

docusaurus/docusaurus.config.ts

@@ -5,15 +5,19 @@ import type { Options as ClassicPresetOptions } from "@docusaurus/preset-classic
 import fs from "fs";
 import { PluginOptions as LLmPluginOptions } from "@signalwire/docusaurus-plugin-llms-txt";
 
-// Import remark plugins
-const docsHeaderDecoration = require("./src/remark/docsHeaderDecoration");
-const enterpriseDocsHeaderInformation = require("./src/remark/enterpriseDocsHeaderInformation");
-const productInformation = require("./src/remark/productInformation");
-const connectorList = require("./src/remark/connectorList");
-const specDecoration = require("./src/remark/specDecoration");
-const docMetaTags = require("./src/remark/docMetaTags");
-const addButtonToTitle = require("./src/remark/addButtonToTitle");
-const npm2yarn = require("@docusaurus/remark-plugin-npm2yarn");
+// Import remark plugins - lazy load to prevent webpack from bundling Node.js code
+const getRemarkPlugins = () => ({
+  docsHeaderDecoration: require("./src/remark/docsHeaderDecoration"),
+  enterpriseDocsHeaderInformation: require("./src/remark/enterpriseDocsHeaderInformation"),
+  productInformation: require("./src/remark/productInformation"),
+  connectorList: require("./src/remark/connectorList"),
+  specDecoration: require("./src/remark/specDecoration"),
+  docMetaTags: require("./src/remark/docMetaTags"),
+  addButtonToTitle: require("./src/remark/addButtonToTitle"),
+  npm2yarn: require("@docusaurus/remark-plugin-npm2yarn"),
+});
+
+const plugins = getRemarkPlugins();
 
 // Import constants
 const {
@@ -118,6 +122,14 @@ const config: Config = {
     ],
   ],
   plugins: [
+    [
+      "rsdoctor",
+      {
+        rsdoctorOptions: {
+          mode: "lite",
+        },
+      },
+    ],
     // This plugin controls "platform" docs, which are versioned
     [
       "@docusaurus/plugin-content-docs",
@@ -136,11 +148,11 @@ const config: Config = {
           }
         },
         remarkPlugins: [
-          docsHeaderDecoration,
-          enterpriseDocsHeaderInformation,
-          productInformation,
-          docMetaTags,
-          addButtonToTitle,
+          plugins.docsHeaderDecoration,
+          plugins.enterpriseDocsHeaderInformation,
+          plugins.productInformation,
+          plugins.docMetaTags,
+          plugins.addButtonToTitle,
         ],
       },
     ],
@@ -154,12 +166,12 @@ const config: Config = {
         sidebarPath: "./sidebar-ai-agents.js",
         editUrl: "https://github.com/airbytehq/airbyte/blob/master/docs",
         remarkPlugins: [
-          docsHeaderDecoration,
-          enterpriseDocsHeaderInformation,
-          productInformation,
-          docMetaTags,
-          addButtonToTitle,
-          [npm2yarn, { sync: true }],
+          plugins.docsHeaderDecoration,
+          plugins.enterpriseDocsHeaderInformation,
+          plugins.productInformation,
+          plugins.docMetaTags,
+          plugins.addButtonToTitle,
+          [plugins.npm2yarn, { sync: true }],
         ],
       },
     ],
@@ -173,11 +185,11 @@ const config: Config = {
         sidebarPath: "./sidebar-release_notes.js",
         editUrl: "https://github.com/airbytehq/airbyte/blob/master/docs",
         remarkPlugins: [
-          docsHeaderDecoration,
-          enterpriseDocsHeaderInformation,
-          productInformation,
-          docMetaTags,
-          addButtonToTitle,
+          plugins.docsHeaderDecoration,
+          plugins.enterpriseDocsHeaderInformation,
+          plugins.productInformation,
+          plugins.docMetaTags,
+          plugins.addButtonToTitle,
         ],
       },
     ],
@@ -190,12 +202,15 @@ const config: Config = {
         routeBasePath: "/integrations",
         sidebarPath: "./sidebar-connectors.js",
         editUrl: "https://github.com/airbytehq/airbyte/blob/master/docs",
-        beforeDefaultRemarkPlugins: [specDecoration, connectorList], // use before-default plugins so TOC rendering picks up inserted headings
+        beforeDefaultRemarkPlugins: [
+          plugins.specDecoration,
+          plugins.connectorList,
+        ], // use before-default plugins so TOC rendering picks up inserted headings
         remarkPlugins: [
-          docsHeaderDecoration,
-          enterpriseDocsHeaderInformation,
-          productInformation,
-          docMetaTags,
+          plugins.docsHeaderDecoration,
+          plugins.enterpriseDocsHeaderInformation,
+          plugins.productInformation,
+          plugins.docMetaTags,
         ],
       },
     ],

docusaurus/package.json

@@ -6,7 +6,9 @@
     "prepare-sidebar": "node src/scripts/prepare-sidebar-data.js",
     "gen-embedded-api-docs": "pnpm exec docusaurus clean-api-docs all && pnpm exec docusaurus gen-api-docs all",
     "prepare-embedded-api": "pnpm run gen-embedded-api-docs && node src/scripts/embedded-api/prepare-embedded-api-spec.js && pnpm prettier --write src/data/embedded_api_spec.json",
+    "cleanup-cache": "node src/scripts/cleanup-cache.js",
     "prebuild": "pnpm run prepare-sidebar && pnpm run prepare-embedded-api",
+    "postbuild": "pnpm run cleanup-cache",
     "prestart": "pnpm run prepare-sidebar && pnpm run prepare-embedded-api",
     "docusaurus": "docusaurus",
     "start": "node src/scripts/fetchSchema.js && docusaurus start --port 3005",
@@ -85,6 +87,7 @@
     "@docusaurus/faster": "^3.9.2",
     "@docusaurus/module-type-aliases": "^3.9.2",
     "@docusaurus/plugin-debug": "^3.9.2",
+    "@docusaurus/plugin-rsdoctor": "^3.9.2",
     "@docusaurus/plugin-sitemap": "^3.9.2",
     "@docusaurus/preset-classic": "^3.9.2",
     "@docusaurus/remark-plugin-npm2yarn": "^3.9.2",
@@ -169,6 +172,7 @@
     ]
   },
   "devDependencies": {
+    "@rsdoctor/cli": "^1.3.4",
     "prettier": "3.5.3"
   },
   "packageManager": "pnpm@9.4.0+sha1.9217c800d4ab947a7aee520242a7b70d64fc7638"