feat(cli): add env package (#755)

Author: AmanVarshney01

.oxfmtrc.json

@@ -1,4 +1,8 @@
 {
   "$schema": "./node_modules/oxfmt/configuration_schema.json",
+  "experimentalSortImports": {
+    "order": "asc"
+  },
+  "experimentalSortPackageJson": true,
   "ignorePatterns": ["*.hbs", "apps/cli/templates/**"]
 }

apps/cli/src/constants.ts

@@ -1,5 +1,6 @@
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+
 import { getUserPkgManager } from "./utils/get-package-manager";
 
 const __filename = fileURLToPath(import.meta.url);
@@ -164,11 +165,14 @@ export const dependencyVersionMap = {
   "@sveltejs/adapter-cloudflare": "^7.2.4",
   "@cloudflare/workers-types": "^4.20251213.0",
 
-  alchemy: "^0.81.2",
+  alchemy: "^0.82.1",
 
   dotenv: "^17.2.2",
   tsdown: "^0.16.5",
   zod: "^4.1.13",
+  "@t3-oss/env-core": "^0.13.1",
+  "@t3-oss/env-nextjs": "^0.13.1",
+  "@t3-oss/env-nuxt": "^0.13.1",
   srvx: "0.8.15",
 
   "@polar-sh/better-auth": "^1.1.3",

apps/cli/src/helpers/addons/addons-setup.ts

@@ -1,8 +1,10 @@
-import path from "node:path";
 import { log } from "@clack/prompts";
 import fs from "fs-extra";
+import path from "node:path";
 import pc from "picocolors";
+
 import type { Frontend, ProjectConfig } from "../../types";
+
 import { addPackageDependency } from "../../utils/add-package-deps";
 import { setupFumadocs } from "./fumadocs-setup";
 import { setupOxlint } from "./oxlint-setup";
@@ -11,8 +13,8 @@ import { setupStarlight } from "./starlight-setup";
 import { setupTauri } from "./tauri-setup";
 import { setupTui } from "./tui-setup";
 import { setupUltracite } from "./ultracite-setup";
-import { setupWxt } from "./wxt-setup";
 import { addPwaToViteConfig } from "./vite-pwa-setup";
+import { setupWxt } from "./wxt-setup";
 
 export async function setupAddons(config: ProjectConfig, isAddCommand = false) {
   const { addons, frontend, projectDir, packageManager } = config;

apps/cli/src/helpers/addons/examples-setup.ts

@@ -1,7 +1,9 @@
-import path from "node:path";
 import fs from "fs-extra";
+import path from "node:path";
+
 import type { AvailableDependencies } from "../../constants";
 import type { ProjectConfig } from "../../types";
+
 import { addPackageDependency } from "../../utils/add-package-deps";
 
 export async function setupExamples(config: ProjectConfig) {

apps/cli/src/helpers/addons/fumadocs-setup.ts

@@ -1,12 +1,14 @@
-import path from "node:path";
 import { isCancel, log, select, spinner } from "@clack/prompts";
 import consola from "consola";
-import { execa } from "execa";
+import { $ } from "execa";
 import fs from "fs-extra";
+import path from "node:path";
 import pc from "picocolors";
+
 import type { ProjectConfig } from "../../types";
+
 import { exitCancelled } from "../../utils/errors";
-import { getPackageExecutionCommand } from "../../utils/package-runner";
+import { getPackageExecutionArgs } from "../../utils/package-runner";
 
 type FumadocsTemplate =
   | "next-mdx"
@@ -64,20 +66,15 @@ export async function setupFumadocs(config: ProjectConfig) {
     const templateArg = TEMPLATES[template].value;
 
     const commandWithArgs = `create-fumadocs-app@latest fumadocs --template ${templateArg} --src --pm ${packageManager} --no-git`;
-
-    const fumadocsInitCommand = getPackageExecutionCommand(packageManager, commandWithArgs);
+    const args = getPackageExecutionArgs(packageManager, commandWithArgs);
 
     const appsDir = path.join(projectDir, "apps");
     await fs.ensureDir(appsDir);
 
     const s = spinner();
     s.start("Running Fumadocs create command...");
 
-    await execa(fumadocsInitCommand, {
-      cwd: appsDir,
-      env: { CI: "true" },
-      shell: true,
-    });
+    await $({ cwd: appsDir, env: { CI: "true" } })`${args}`;
 
     const fumadocsDir = path.join(projectDir, "apps", "fumadocs");
     const packageJsonPath = path.join(fumadocsDir, "package.json");

apps/cli/src/helpers/addons/oxlint-setup.ts

@@ -1,10 +1,12 @@
-import path from "node:path";
 import { spinner } from "@clack/prompts";
-import { execa } from "execa";
+import { $ } from "execa";
 import fs from "fs-extra";
+import path from "node:path";
+
 import type { PackageManager } from "../../types";
+
 import { addPackageDependency } from "../../utils/add-package-deps";
-import { getPackageExecutionCommand } from "../../utils/package-runner";
+import { getPackageExecutionArgs } from "../../utils/package-runner";
 
 export async function setupOxlint(projectDir: string, packageManager: PackageManager) {
   await addPackageDependency({
@@ -26,19 +28,11 @@ export async function setupOxlint(projectDir: string, packageManager: PackageMan
 
   const s = spinner();
 
-  const oxlintInitCommand = getPackageExecutionCommand(packageManager, "oxlint@latest --init");
+  const oxlintArgs = getPackageExecutionArgs(packageManager, "oxlint@latest --init");
   s.start("Initializing oxlint and oxfmt...");
-  await execa(oxlintInitCommand, {
-    cwd: projectDir,
-    env: { CI: "true" },
-    shell: true,
-  });
+  await $({ cwd: projectDir, env: { CI: "true" } })`${oxlintArgs}`;
 
-  const oxfmtInitCommand = getPackageExecutionCommand(packageManager, "oxfmt@latest --init");
-  await execa(oxfmtInitCommand, {
-    cwd: projectDir,
-    env: { CI: "true" },
-    shell: true,
-  });
+  const oxfmtArgs = getPackageExecutionArgs(packageManager, "oxfmt@latest --init");
+  await $({ cwd: projectDir, env: { CI: "true" } })`${oxfmtArgs}`;
   s.stop("oxlint and oxfmt initialized successfully!");
 }

apps/cli/src/helpers/addons/ruler-setup.ts

@@ -1,11 +1,13 @@
-import path from "node:path";
 import { autocompleteMultiselect, isCancel, log, spinner } from "@clack/prompts";
-import { execa } from "execa";
+import { $ } from "execa";
 import fs from "fs-extra";
+import path from "node:path";
 import pc from "picocolors";
+
 import type { ProjectConfig } from "../../types";
+
 import { exitCancelled } from "../../utils/errors";
-import { getPackageExecutionCommand } from "../../utils/package-runner";
+import { getPackageExecutionArgs, getPackageExecutionCommand } from "../../utils/package-runner";
 
 export async function setupRuler(config: ProjectConfig) {
   const { packageManager, projectDir } = config;
@@ -90,15 +92,11 @@ export async function setupRuler(config: ProjectConfig) {
     s.start("Applying rules with Ruler...");
 
     try {
-      const rulerApplyCmd = getPackageExecutionCommand(
+      const rulerApplyArgs = getPackageExecutionArgs(
         packageManager,
         `@intellectronica/ruler@latest apply --agents ${selectedEditors.join(",")} --local-only`,
       );
-      await execa(rulerApplyCmd, {
-        cwd: projectDir,
-        env: { CI: "true" },
-        shell: true,
-      });
+      await $({ cwd: projectDir, env: { CI: "true" } })`${rulerApplyArgs}`;
 
       s.stop("Applied rules with Ruler");
     } catch {

apps/cli/src/helpers/addons/starlight-setup.ts

@@ -1,11 +1,13 @@
-import path from "node:path";
 import { spinner } from "@clack/prompts";
 import consola from "consola";
-import { execa } from "execa";
+import { $ } from "execa";
 import fs from "fs-extra";
+import path from "node:path";
 import pc from "picocolors";
+
 import type { ProjectConfig } from "../../types";
-import { getPackageExecutionCommand } from "../../utils/package-runner";
+
+import { getPackageExecutionArgs } from "../../utils/package-runner";
 
 export async function setupStarlight(config: ProjectConfig) {
   const { packageManager, projectDir } = config;
@@ -27,19 +29,12 @@ export async function setupStarlight(config: ProjectConfig) {
     const starlightArgsString = starlightArgs.join(" ");
 
     const commandWithArgs = `create-astro@latest ${starlightArgsString}`;
-
-    const starlightInitCommand = getPackageExecutionCommand(packageManager, commandWithArgs);
+    const args = getPackageExecutionArgs(packageManager, commandWithArgs);
 
     const appsDir = path.join(projectDir, "apps");
     await fs.ensureDir(appsDir);
 
-    await execa(starlightInitCommand, {
-      cwd: appsDir,
-      env: {
-        CI: "true",
-      },
-      shell: true,
-    });
+    await $({ cwd: appsDir, env: { CI: "true" } })`${args}`;
 
     s.stop("Starlight docs setup successfully!");
   } catch (error) {

apps/cli/src/helpers/addons/tauri-setup.ts

@@ -1,12 +1,14 @@
-import path from "node:path";
 import { spinner } from "@clack/prompts";
 import { consola } from "consola";
-import { execa } from "execa";
+import { $ } from "execa";
 import fs from "fs-extra";
+import path from "node:path";
 import pc from "picocolors";
+
 import type { ProjectConfig } from "../../types";
+
 import { addPackageDependency } from "../../utils/add-package-deps";
-import { getPackageExecutionCommand } from "../../utils/package-runner";
+import { getPackageRunnerPrefix } from "../../utils/package-runner";
 
 export async function setupTauri(config: ProjectConfig) {
   const { packageManager, frontend, projectDir } = config;
@@ -64,27 +66,18 @@ export async function setupTauri(config: ProjectConfig) {
             : "../dist";
 
     const tauriArgs = [
+      "@tauri-apps/cli@latest",
       "init",
       `--app-name=${path.basename(projectDir)}`,
       `--window-title=${path.basename(projectDir)}`,
       `--frontend-dist=${frontendDist}`,
       `--dev-url=${devUrl}`,
-      `--before-dev-command="${packageManager} run dev"`,
-      `--before-build-command="${packageManager} run build"`,
+      `--before-dev-command=${packageManager} run dev`,
+      `--before-build-command=${packageManager} run build`,
     ];
-    const tauriArgsString = tauriArgs.join(" ");
+    const prefix = getPackageRunnerPrefix(packageManager);
 
-    const commandWithArgs = `@tauri-apps/cli@latest ${tauriArgsString}`;
-
-    const tauriInitCommand = getPackageExecutionCommand(packageManager, commandWithArgs);
-
-    await execa(tauriInitCommand, {
-      cwd: clientPackageDir,
-      env: {
-        CI: "true",
-      },
-      shell: true,
-    });
+    await $({ cwd: clientPackageDir, env: { CI: "true" } })`${[...prefix, ...tauriArgs]}`;
 
     s.stop("Tauri desktop app support configured successfully!");
   } catch (error) {

apps/cli/src/helpers/addons/tui-setup.ts

@@ -1,11 +1,13 @@
-import path from "node:path";
 import { isCancel, log, select, spinner } from "@clack/prompts";
-import { execa } from "execa";
+import { $ } from "execa";
 import fs from "fs-extra";
+import path from "node:path";
 import pc from "picocolors";
+
 import type { ProjectConfig } from "../../types";
+
 import { exitCancelled } from "../../utils/errors";
-import { getPackageExecutionCommand } from "../../utils/package-runner";
+import { getPackageExecutionArgs } from "../../utils/package-runner";
 
 type TuiTemplate = "core" | "react" | "solid";
 
@@ -43,20 +45,15 @@ export async function setupTui(config: ProjectConfig) {
     if (isCancel(template)) return exitCancelled("Operation cancelled");
 
     const commandWithArgs = `create-tui@latest --template ${template} --no-git --no-install tui`;
-
-    const tuiInitCommand = getPackageExecutionCommand(packageManager, commandWithArgs);
+    const args = getPackageExecutionArgs(packageManager, commandWithArgs);
 
     const appsDir = path.join(projectDir, "apps");
     await fs.ensureDir(appsDir);
 
     const s = spinner();
     s.start("Running OpenTUI create command...");
 
-    await execa(tuiInitCommand, {
-      cwd: appsDir,
-      env: { CI: "true" },
-      shell: true,
-    });
+    await $({ cwd: appsDir, env: { CI: "true" } })`${args}`;
 
     s.stop("OpenTUI setup complete!");
   } catch (error) {