feat(cli-helpers): Root package install and RWJS env var

packages/cli-helpers/src/lib/installHelpers.ts

@@ -16,6 +16,16 @@ export const addApiPackages = (apiPackages: string[]) => ({
   },
 })
 
+export const addRootPackages = (packages: string[], devDependency = false) => {
+  const addMode = devDependency ? ['add', '-D'] : ['add']
+  return {
+    title: 'Installing packages...',
+    task: async () => {
+      await execa('yarn', [...addMode, ...packages], { cwd: getPaths().base })
+    },
+  }
+}
+
 export const installPackages = {
   title: 'Installing packages...',
   task: async () => {

packages/cli-helpers/src/lib/project.ts

@@ -1,7 +1,7 @@
 import fs from 'fs'
 import path from 'path'
 
-import { resolveFile } from '@redwoodjs/project-config'
+import { resolveFile, findUp } from '@redwoodjs/project-config'
 
 import { colors } from './colors'
 import { getPaths } from './paths'
@@ -49,3 +49,38 @@ export const addEnvVarTask = (name: string, value: string, comment: string) => {
     },
   }
 }
+
+/**
+ * This sets the `RWJS_CWD` env var to the redwood project directory. This is typically required for internal
+ * redwood packages to work correctly. For example, `@redwoodjs/project-config` uses this when reading config
+ * or paths.
+ *
+ * @param cwd Explicitly set the redwood cwd. If not set, we'll try to determine it automatically. You likely
+ * only want to set this based on some specific input, like a CLI flag.
+ */
+export const setRedwoodCWD = (cwd?: string) => {
+  // Get the existing `cwd` from the `RWJS_CWD` env var, if it exists.
+  cwd ??= process.env.RWJS_CWD
+
+  if (cwd) {
+    // `cwd` was specifically passed in or the `RWJS_CWD` env var. In this case,
+    // we don't want to find up for a `redwood.toml` file. The `redwood.toml` should just be in that directory.
+    if (!fs.existsSync(path.join(cwd, 'redwood.toml'))) {
+      throw new Error(`Couldn't find a "redwood.toml" file in ${cwd}`)
+    }
+  } else {
+    // `cwd` wasn't set. Odds are they're in a Redwood project,
+    // but they could be in ./api or ./web, so we have to find up to be sure.
+    const redwoodTOMLPath = findUp('redwood.toml', process.cwd())
+    if (!redwoodTOMLPath) {
+      throw new Error(
+        `Couldn't find up a "redwood.toml" file from ${process.cwd()}`
+      )
+    }
+    if (redwoodTOMLPath) {
+      cwd = path.dirname(redwoodTOMLPath)
+    }
+  }
+
+  process.env.RWJS_CWD = cwd
+}