feat(Gatsby Recipes): Initial release

packages/gatsby-cli/src/create-cli.js

@@ -293,6 +293,19 @@ function buildLocalCommands(cli, isLocalSite) {
       return cmd(args)
     }),
   })
+  cli.command({
+    command: `recipes`,
+    desc: `Run a recipe`,
+    handler: handlerP(
+      getCommandHandler(`recipes`, (args, cmd) => {
+        cmd(args)
+        // Return an empty promise to prevent handlerP from exiting early.
+        // The development server shouldn't ever exit until the user directly
+        // kills it so this is fine.
+        return new Promise(resolve => {})
+      })
+    ),
+  })
 }
 
 function isLocalGatsbySite() {

packages/gatsby/package.json

@@ -17,6 +17,8 @@
     "@babel/runtime": "^7.8.7",
     "@babel/traverse": "^7.8.6",
     "@hapi/joi": "^15.1.1",
+    "@mdx-js/mdx": "^1.5.8",
+    "@mdx-js/react": "^1.5.8",
     "@mikaelkristiansson/domready": "^1.0.10",
     "@pieh/friendly-errors-webpack-plugin": "1.7.0-chalk-2",
     "@pmmmwh/react-refresh-webpack-plugin": "^0.2.0",
@@ -64,6 +66,7 @@
     "eslint-plugin-react": "^7.19.0",
     "eslint-plugin-react-hooks": "^1.7.0",
     "event-source-polyfill": "^1.0.12",
+    "execa": "^4.0.0",
     "express": "^4.17.1",
     "express-graphql": "^0.9.0",
     "fast-levenshtein": "^2.0.6",
@@ -83,7 +86,10 @@
     "graphql": "^14.6.0",
     "graphql-compose": "^6.3.8",
     "graphql-playground-middleware-express": "^1.7.12",
+    "graphql-subscriptions": "^1.1.0",
     "hasha": "^5.2.0",
+    "humanize-list": "^1.0.1",
+    "import-jsx": "^4.0.0",
     "invariant": "^2.2.4",
     "is-relative": "^1.0.0",
     "is-relative-url": "^3.0.0",
@@ -120,21 +126,27 @@
     "react-error-overlay": "^3.0.0",
     "react-hot-loader": "^4.12.20",
     "react-refresh": "^0.7.0",
+    "read-package-tree": "^5.3.1",
     "redux": "^4.0.5",
     "redux-thunk": "^2.3.0",
+    "remark-stringify": "^8.0.0",
     "semver": "^5.7.1",
     "shallow-compare": "^1.2.2",
     "sift": "^5.1.0",
     "signal-exit": "^3.0.2",
+    "simplified-jsx-to-json": "^0.1.0",
     "slugify": "^1.4.0",
     "socket.io": "^2.3.0",
     "stack-trace": "^0.0.10",
     "string-similarity": "^1.2.2",
     "style-loader": "^0.23.1",
+    "subscriptions-transport-ws": "^0.9.16",
     "terser-webpack-plugin": "^1.4.3",
     "true-case-path": "^2.2.1",
     "type-of": "^2.0.1",
+    "unist-util-visit": "^2.0.2",
     "url-loader": "^1.1.2",
+    "urql": "^1.9.5",
     "util.promisify": "^1.0.1",
     "uuid": "^3.4.0",
     "v8-compile-cache": "^1.1.2",
@@ -144,6 +156,7 @@
     "webpack-hot-middleware": "^2.25.0",
     "webpack-merge": "^4.2.2",
     "webpack-stats-plugin": "^0.3.1",
+    "ws": "^7.2.3",
     "xstate": "^4.8.0",
     "yaml-loader": "^0.5.0"
   },
@@ -201,17 +214,20 @@
     "graphql": "^14.6.0"
   },
   "scripts": {
-    "build": "npm run build:src && npm run build:internal-plugins && npm run build:rawfiles && npm run build:cjs",
+    "build": "npm run build:src && npm run build:internal-plugins && npm run build:rawfiles && npm run build:cjs && npm run build:recipes",
     "postbuild": "node scripts/output-api-file.js",
     "build:internal-plugins": "copyfiles -u 1 src/internal-plugins/**/package.json dist",
     "build:rawfiles": "copyfiles -u 1 src/internal-plugins/**/raw_* dist",
+    "build:recipes": "copyfiles -u 1 src/recipes/*.mdx dist",
     "build:cjs": "babel cache-dir --out-dir cache-dir/commonjs --ignore **/__tests__",
     "build:src": "babel src --out-dir dist --source-maps --verbose --ignore **/gatsby-cli.js,src/internal-plugins/dev-404-page/raw_dev-404-page.js,**/__tests__ --extensions \".ts,.js\"",
     "clean-test-bundles": "find test/ -type f -name bundle.js* -exec rm -rf {} +",
     "prebuild": "rimraf dist && rimraf cache-dir/commonjs",
     "postinstall": "node scripts/postinstall.js",
     "prepare": "cross-env NODE_ENV=production npm run build",
-    "watch": "rimraf dist && mkdir dist && npm run build:internal-plugins && npm run build:rawfiles && npm run build:src -- --watch"
+    "watch": "rimraf dist && mkdir dist && npm run build:internal-plugins && npm run build:rawfiles && npm run build:recipes && npm run build:src -- --watch",
+    "test": "jest",
+    "test:watch": "jest --watch"
   },
   "types": "index.d.ts",
   "yargs": {

packages/gatsby/src/commands/recipes.ts

@@ -0,0 +1,41 @@
+import telemetry from "gatsby-telemetry"
+import execa from "execa"
+import path from "path"
+import fs from "fs"
+
+module.exports = async (program: IProgram): Promise<void> => {
+  const recipe = program._[1]
+  telemetry.trackCli(`RECIPE_RUN`, { recipe })
+
+  // Start GraphQL serve
+  let subprocess
+  const scriptPath = path.join(program.directory, `node_modules/gatsby/dist/recipes/graphql.js`)
+  subprocess = execa(`node`, [scriptPath], {
+    cwd: program.directory,
+    all: true,
+  })
+  process.on("exit", () =>
+    subprocess.kill("SIGTERM", {
+      forceKillAfterTimeout: 2000,
+    })
+  )
+  // Log server output to a file.
+  if (process.env.DEBUG) {
+    const logFile = path.join(program.directory, './recipe-server.log')
+    fs.writeFileSync(logFile, `\n-----\n${new Date().toJSON()}\n`)
+    const writeStream = fs.createWriteStream(logFile, {flags:'a'});
+    subprocess.stdout.pipe(writeStream)
+    // subprocess.stderr.pipe(writeStream)
+  }
+
+  let started = false
+  subprocess.stdout.on("data", data => {
+    if (!started) {
+      const runRecipe = require(`../recipes/index`)
+      runRecipe({ recipe, projectRoot: program.directory })
+      started = true
+    }
+  })
+
+  // Run command
+}