fix: reporting errors from command line executions

Author: jherr

src/create-app.ts

@@ -275,6 +275,8 @@ export async function createApp(
     environment: Environment
   },
 ) {
+  environment.startRun()
+
   const templateDirBase = fileURLToPath(
     new URL(`../templates/${options.framework}/base`, import.meta.url),
   )
@@ -630,14 +632,24 @@ export async function createApp(
     s?.stop(`Initialized git repository`)
   }
 
+  environment.finishRun()
+
+  let errorStatement = ''
+  if (environment.getErrors().length) {
+    errorStatement = `
+
+${chalk.red('There were errors encountered during this process:')}
+
+${environment.getErrors().join('\n')}`
+  }
+
   if (!silent) {
     outro(`Created your new TanStack app in '${basename(targetDir)}'.
 
 Use the following commands to start your app:
 % cd ${options.projectName}
 % ${options.packageManager === 'deno' ? 'deno start' : options.packageManager} ${isAddOnEnabled('start') ? 'dev' : 'start'}
 
-Please read README.md for more information on testing, styling, adding routes, react-query, etc.
-`)
+Please read README.md for more information on testing, styling, adding routes, react-query, etc.${errorStatement}`)
   }
 }

src/environment.ts

@@ -10,6 +10,10 @@ import { dirname } from 'node:path'
 import { execa } from 'execa'
 
 export type Environment = {
+  startRun: () => void
+  finishRun: () => void
+  getErrors: () => Array<string>
+
   appendFile: (path: string, contents: string) => Promise<void>
   copyFile: (from: string, to: string) => Promise<void>
   writeFile: (path: string, contents: string) => Promise<void>
@@ -22,7 +26,14 @@ export type Environment = {
 }
 
 export function createDefaultEnvironment(): Environment {
+  let errors: Array<string> = []
   return {
+    startRun: () => {
+      errors = []
+    },
+    finishRun: () => {},
+    getErrors: () => errors,
+
     appendFile: async (path: string, contents: string) => {
       await mkdir(dirname(path), { recursive: true })
       return appendFile(path, contents)
@@ -36,9 +47,15 @@ export function createDefaultEnvironment(): Environment {
       return writeFile(path, contents)
     },
     execute: async (command: string, args: Array<string>, cwd: string) => {
-      await execa(command, args, {
-        cwd,
-      })
+      try {
+        await execa(command, args, {
+          cwd,
+        })
+      } catch {
+        errors.push(
+          `Command "${command} ${args.join(' ')}" did not run successfully. Please run this manually in your project.`,
+        )
+      }
     },
 
     readFile: (path: string, encoding?: BufferEncoding) =>