feat(nx-dev): add watch to automatically sync docs to nx-dev when dev…

…eloping locally

nx-dev/nx-dev/copy-docs.js

@@ -0,0 +1,11 @@
+const { copySync } = require('fs-extra');
+const path = require('path');
+
+/**
+ * Copies the documentation into the proper Next.js public folder
+ */
+copySync(
+  path.resolve(path.join(__dirname, '../../docs')),
+  path.resolve(path.join(__dirname, 'public/documentation')),
+  { overwrite: true }
+);

nx-dev/nx-dev/next.config.js

@@ -1,18 +1,7 @@
 // nx-ignore-next-line
 const { withNx } = require('@nx/next/plugins/with-nx');
-const { copySync } = require('fs-extra');
-const path = require('path');
 const redirectRules = require('./redirect-rules.config');
 
-/**
- * TODO@ben: Use watch method instead.
- */
-copySync(
-  path.resolve(__dirname + '/../../docs'),
-  path.resolve(__dirname + '/public/documentation'),
-  { overwrite: true }
-);
-
 module.exports = withNx({
   // For both client and server
   env: {

nx-dev/nx-dev/project.json

@@ -44,6 +44,7 @@
     },
     "build-base": {
       "executor": "@nx/next:build",
+      "dependsOn": ["copy-docs"],
       "outputs": ["{options.outputPath}"],
       "options": {
         "root": "nx-dev/nx-dev",
@@ -56,8 +57,27 @@
         "production": {}
       }
     },
+    "copy-docs": {
+      "inputs": ["{workspaceRoot}/docs/**/*"],
+      "outputs": ["{projectRoot}/public/documentation"],
+      "command": "node ./copy-docs.js",
+      "options": {
+        "cwd": "nx-dev/nx-dev"
+      }
+    },
+    "serve-docs": {
+      "executor": "nx:run-commands",
+      "options": {
+        "commands": [
+          "nx watch --projects=docs -- nx run nx-dev:copy-docs",
+          "nx run nx-dev:serve"
+        ],
+        "parallel": true
+      }
+    },
     "serve": {
       "executor": "@nx/next:server",
+      "dependsOn": ["copy-docs"],
       "options": {
         "buildTarget": "nx-dev:build-base",
         "dev": true

nx.json

@@ -20,7 +20,8 @@
           "test",
           "test-native",
           "sitemap",
-          "build-storybook"
+          "build-storybook",
+          "copy-docs"
         ],
         "cacheDirectory": "/tmp/nx-cache",
         "parallel": 1,