feat: community workshop for custom widgets and CSS (#5984)

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>

apps/docs/docusaurus.config.ts

@@ -20,6 +20,11 @@ const config: Config = {
   onBrokenAnchors: "throw",
   onDuplicateRoutes: "throw",
 
+  customFields: {
+    // Empty means same-origin, which is the production Workshop image shape.
+    workshopUrl: process.env.WORKSHOP_URL ?? "",
+  },
+
   future: {
     v4: {
       removeLegacyPostBuildHeadAttribute: true,
@@ -124,6 +129,11 @@ const config: Config = {
           position: "left",
           to: "/blog",
         },
+        {
+          label: "Workshop",
+          position: "left",
+          to: "/workshop",
+        },
         {
           label: "About us",
           position: "left",
@@ -278,7 +288,12 @@ const config: Config = {
       return {
         name: "resolve-homarr-packages",
         configureWebpack() {
-          return { resolve: { symlinks: false } };
+          return {
+            resolve: {
+              symlinks: false,
+              alias: { "@": require("path").resolve(__dirname, "src") },
+            },
+          };
         },
       };
     },
@@ -309,6 +324,18 @@ const config: Config = {
         },
       };
     },
+    function workshopDetailRoutePlugin() {
+      return {
+        name: "workshop-detail-route",
+        async contentLoaded({ actions }) {
+          actions.addRoute({
+            path: "/workshop/:id",
+            component: "@site/src/components/workshop/DetailPage",
+            exact: true,
+          });
+        },
+      };
+    },
     "@signalwire/docusaurus-plugin-llms-txt",
     async function tailwindCssPlugin() {
       return {