The Open Standard for Generative UI
cli: quiet installs, spinner, and thesys next.config workaround (#1092)
AB4b51f4513d69
diff --git a/packages/openui-cli/src/auth/mint.ts b/packages/openui-cli/src/auth/mint.tsindex eab12073e..117ae34e4 100644--- a/packages/openui-cli/src/auth/mint.ts+++ b/packages/openui-cli/src/auth/mint.ts@@ -185,7 +185,7 @@ export async function resolveCloudApiKey(opts: {if (method === "manual") {console.warn(- "⚠ --auth manual is deprecated. Use browser sign-in or pass --api-key for scripted setup.",+ "[!] --auth manual is deprecated. Use browser sign-in or pass --api-key for scripted setup.",);const { password } = await import("@inquirer/prompts");const key = await cloudAuthPrompt("manual_key_prompt", "MANUAL_KEY_PROMPT_FAILED", () =>diff --git a/packages/openui-cli/src/commands/create-app.ts b/packages/openui-cli/src/commands/create-app.tsindex e7392a653..11a3502dc 100644--- a/packages/openui-cli/src/commands/create-app.ts+++ b/packages/openui-cli/src/commands/create-app.ts@@ -3,6 +3,7 @@ import * as os from "node:os";import * as path from "node:path";import { resolveCloudApiKey, THESYS_KEYS_URL } from "../auth/mint";+import { printLogTail, QUIET_COMMAND_CAPTURE_LIMIT } from "../lib/command-output";import { aiSetupFromTemplate, createFunnelProps } from "../lib/create-telemetry";import type { CreateAppOptions, EnvResult, OverlayName, TemplateName } from "../lib/create-types";import {@@ -14,6 +15,7 @@ import { runSkillInstall, shouldInstallSkill } from "../lib/install-skill";import { applyOverlay, OVERLAYS_DIR, resolveOverlay, type OverlayManifest } from "../lib/overlays";import { runCommand } from "../lib/process-runner";import { resolveArgs } from "../lib/resolve-args";+import { withSpinner } from "../lib/spinner";import { resolveAvailableTarget } from "../lib/target-dir";import { CliCancelledError, CreateError, telemetry } from "../lib/telemetry";import { cliErrorProperties, processErrorProperties } from "../lib/utils";@@ -277,9 +279,11 @@ export async function runCreateApp(options: CreateAppOptions): Promise<void> {restoreDotfiles(targetDir);applyOverlay(targetDir, overlay);rewritePackageJson(targetDir, name, packageManager.name, overlay?.manifest.packageJson);- // npm ci needs package-lock.json. Keep it for npm scaffolds (base template or- // a backend overlay that ships its own). Other managers resolve from package.json.- if (packageManager.name !== "npm") {+ // An overlay that changes dependencies without a lock must not keep the base lock+ const overlayShipsNpmLock = Boolean(+ overlay && fs.existsSync(path.join(overlay.dir, "package-lock.json")),+ );+ if (packageManager.name !== "npm" || (overlay && !overlayShipsNpmLock)) {fs.rmSync(path.join(targetDir, "package-lock.json"), { force: true });}// The Cloud template ships pnpm's lock/workspace files for reproducible pnpm@@ -416,15 +420,36 @@ export async function runCreateApp(options: CreateAppOptions): Promise<void> {});console.info(`Skipping dependency install (--no-install). Run \`${installCmd}\` later.\n`);} else {- console.info(`Installing dependencies with: ${installCmd}\n`);telemetry.capture("cli_dependency_install_started", {...createFunnelProps("dependency_install_started"),template,ai_setup: aiSetup,});- const installResult = await runCommand(packageManager.runCmd, installArgs, targetDir);+ const runInstall = () =>+ options.verbose+ ? runCommand(packageManager.runCmd, installArgs, targetDir)+ : runCommand(packageManager.runCmd, installArgs, targetDir, {+ echo: false,+ stdin: "ignore",+ captureLimit: QUIET_COMMAND_CAPTURE_LIMIT,+ env: {+ ...process.env,+ npm_config_loglevel: "error",+ NPM_CONFIG_LOGLEVEL: "error",+ },+ });++ if (options.verbose) {+ console.info(`Installing dependencies with: ${installCmd}\n`);+ }+ const installResult = options.verbose+ ? await runInstall()+ : await withSpinner("Installing dependencies...", runInstall);if (!installResult.error && installResult.status === 0) {dependencyInstalled = true;+ if (!options.verbose) {+ console.info("✓ Dependencies installed\n");+ }telemetry.capture("cli_dependency_install_succeeded", {...createFunnelProps("dependency_install_succeeded"),template,@@ -432,6 +457,9 @@ export async function runCreateApp(options: CreateAppOptions): Promise<void> {dependency_installed: dependencyInstalled,});} else {+ if (!options.verbose) {+ printLogTail(installResult.diagnosticTail, "install log (tail)");+ }const properties = processErrorProperties(installResult, "dependency_install", {error_class: "dependency",error_code: "NONZERO_EXIT",@@ -490,7 +518,6 @@ export async function runCreateApp(options: CreateAppOptions): Promise<void> {skillInstalled,envWritten: envResult.envWritten,startDev,- devStartBlockedByMissingApiKey,installCmd,dependencyInstalled,}),@@ -501,15 +528,6 @@ export async function runCreateApp(options: CreateAppOptions): Promise<void> {skip_reason: "missing_api_key",required_env: apiKeyEnv,});- const keyHint =- apiKeyEnv === "THESYS_API_KEY"- ? `Get a key at ${THESYS_KEYS_URL}, then add:\n\n ${apiKeyEnv}=…\n\nto ${name}/.env`- : `Add your key to ${name}/.env:\n\n ${apiKeyEnv}=…`;- console.error(- `\nSkipped starting the development server — ${apiKeyEnv} is missing.\n\n` +- `${keyHint}\n\n` +- `Then run:\n\n> cd ${name}\n> ${devCmd} run dev\n`,- );process.exitCode = 1;return;}@@ -687,7 +705,7 @@ async function resolveCloudEnv(auth_succeeded: false,...properties,});- console.error(`\n⚠ Could not obtain an API key: ${msg}`);+ console.error(`\n[!] Could not obtain an API key: ${msg}`);console.error(` Add THESYS_API_KEY to .env later (keys: ${THESYS_KEYS_URL}).\n`);}const lines = [`THESYS_API_KEY=${apiKey ?? ""}`, `DEMO_USER_ID=demo-user`];@@ -707,7 +725,6 @@ function getStartedMessage(o: {skillInstalled: boolean;envWritten: boolean;startDev: boolean;- devStartBlockedByMissingApiKey: boolean;installCmd: string;dependencyInstalled: boolean;}): string {@@ -719,20 +736,18 @@ function getStartedMessage(o: {o.template === "openui-cloud"? o.envWritten? "✅ .env created with your OpenUI Cloud API key + base URL."- : `⚠ .env created without a key. Add THESYS_API_KEY=… (get one at ${THESYS_KEYS_URL}).`+ : `[!] .env created without a key. Add THESYS_API_KEY=… (get one at ${THESYS_KEYS_URL}).`: o.envWritten? "✅ .env created with your API key.": "Add your API key to .env:\nOPENAI_API_KEY=sk-your-key-here";const nextStep = o.startDev? `Starting the development server in "${o.name}"...\n\n> ${o.devCmd} run dev`- : o.devStartBlockedByMissingApiKey- ? ""- : [- `> cd ${o.name}`,- ...(o.dependencyInstalled ? [] : [`> ${o.installCmd}`]),- `> ${o.devCmd} run dev`,- ].join("\n");+ : [+ `> cd ${o.name}`,+ ...(o.dependencyInstalled ? [] : [`> ${o.installCmd}`]),+ `> ${o.devCmd} run dev`,+ ].join("\n");const frameworkNote = o.backendGettingStarted?.replaceAll("{{packageManager}}", o.devCmd) ?? "";diff --git a/packages/openui-cli/src/index.ts b/packages/openui-cli/src/index.tsindex fbeeecf00..9b2837613 100644--- a/packages/openui-cli/src/index.ts+++ b/packages/openui-cli/src/index.ts@@ -72,6 +72,7 @@ program.option("--no-install", "Scaffold without running the package install").option("-i, --immediate", "Start the development server after installing dependencies").option("--no-immediate", "Install dependencies without starting the development server")+ .option("--verbose", "Stream full dependency install logs").addHelpText("after",`@@ -103,6 +104,7 @@ Backend frameworks:interactive: boolean;install: boolean;immediate?: boolean;+ verbose?: boolean;}) => {try {rejectConflictingImmediateFlags(process.argv.slice(2));@@ -116,6 +118,7 @@ Backend frameworks:noInteractive: !options.interactive,noInstall: !options.install,immediate: options.immediate,+ verbose: options.verbose,});} catch (e) {handleCliError(e, "cli_create_failed");diff --git a/packages/openui-cli/src/lib/command-output.ts b/packages/openui-cli/src/lib/command-output.tsnew file mode 100644index 000000000..6f98f17b5--- /dev/null+++ b/packages/openui-cli/src/lib/command-output.ts@@ -0,0 +1,10 @@+/** Enough build/install output to dump a useful failure tail in quiet mode. */+export const QUIET_COMMAND_CAPTURE_LIMIT = 256 * 1024;++export function printLogTail(log: string, title = "build log (tail)"): void {+ const trimmed = log.trim();+ if (!trimmed) return;+ console.error(`\n--- ${title} ---\n`);+ process.stderr.write(trimmed + "\n");+ console.error("---\n");+}diff --git a/packages/openui-cli/src/lib/create-types.ts b/packages/openui-cli/src/lib/create-types.tsindex 0a0ef97ff..bbbddc91d 100644--- a/packages/openui-cli/src/lib/create-types.ts+++ b/packages/openui-cli/src/lib/create-types.ts@@ -12,6 +12,7 @@ export interface CreateAppOptions {noInteractive?: boolean;noInstall?: boolean;immediate?: boolean;+ verbose?: boolean;apiKey?: string;auth?: CloudAuthMethod;}diff --git a/packages/openui-cli/src/lib/overlays.ts b/packages/openui-cli/src/lib/overlays.tsindex 537dc2cae..bfc4b20ad 100644--- a/packages/openui-cli/src/lib/overlays.ts+++ b/packages/openui-cli/src/lib/overlays.ts@@ -55,6 +55,18 @@ export function resolveOverlay(};}+function removeEmptyParentDirs(projectDir: string, removedRelativePath: string) {+ let dir = path.dirname(path.join(projectDir, removedRelativePath));++ while (true) {+ const relative = path.relative(projectDir, dir);+ if (!relative || relative.startsWith("..")) break;+ if (fs.readdirSync(dir).length > 0) break;+ fs.rmdirSync(dir);+ dir = path.dirname(dir);+ }+}+export function applyOverlay(projectDir: string, overlay?: TemplateOverlay) {if (!overlay) return;@@ -67,5 +79,6 @@ export function applyOverlay(projectDir: string, overlay?: TemplateOverlay) {for (const relativePath of overlay.manifest.files?.remove ?? []) {fs.rmSync(path.join(projectDir, relativePath), { recursive: true, force: true });+ removeEmptyParentDirs(projectDir, relativePath);}}diff --git a/packages/openui-cli/src/lib/process-runner.ts b/packages/openui-cli/src/lib/process-runner.tsindex 4559ecb69..8e7417825 100644--- a/packages/openui-cli/src/lib/process-runner.ts+++ b/packages/openui-cli/src/lib/process-runner.ts@@ -12,6 +12,14 @@ export type CommandResult = {export type RunCommandOptions = {env?: NodeJS.ProcessEnv;+ /** When false, capture stdout/stderr without writing them to the parent. Default true. */+ echo?: boolean;+ /** Default inherit so interactive CLIs can prompt. Use ignore for login probes. */+ stdin?: "inherit" | "ignore";+ /** Inherit stdout/stderr so the child sees a TTY (needed for `vercel login`). */+ inheritOutput?: boolean;+ /** Max bytes retained in `diagnosticTail` when output is piped. Default 16KiB. */+ captureLimit?: number;};/**@@ -31,10 +39,17 @@ export function runCommand(): Promise<CommandResult> {return new Promise((resolve) => {const startedAt = Date.now();+ const echo = options.echo !== false;+ const inheritOutput = Boolean(options.inheritOutput);+ const captureLimit = options.captureLimit ?? DIAGNOSTIC_TAIL_LIMIT;const child = spawn(command, args, {cwd,env: options.env,- stdio: ["inherit", "pipe", "pipe"],+ stdio: [+ options.stdin === "ignore" ? "ignore" : "inherit",+ inheritOutput ? "inherit" : "pipe",+ inheritOutput ? "inherit" : "pipe",+ ],});let diagnosticTail = "";let settled = false;@@ -42,16 +57,18 @@ export function runCommand(let forceKillTimer: NodeJS.Timeout | undefined;const observe = (chunk: Buffer) => {- diagnosticTail = (diagnosticTail + chunk.toString("utf8")).slice(-DIAGNOSTIC_TAIL_LIMIT);+ diagnosticTail = (diagnosticTail + chunk.toString("utf8")).slice(-captureLimit);};- child.stdout?.on("data", (chunk: Buffer) => {- process.stdout.write(chunk);- observe(chunk);- });- child.stderr?.on("data", (chunk: Buffer) => {- process.stderr.write(chunk);- observe(chunk);- });+ if (!inheritOutput) {+ child.stdout?.on("data", (chunk: Buffer) => {+ if (echo) process.stdout.write(chunk);+ observe(chunk);+ });+ child.stderr?.on("data", (chunk: Buffer) => {+ if (echo) process.stderr.write(chunk);+ observe(chunk);+ });+ }const finish = (result: Omit<CommandResult, "diagnosticTail" | "durationMs">) => {if (settled) return;diff --git a/packages/openui-cli/src/lib/spinner.ts b/packages/openui-cli/src/lib/spinner.tsnew file mode 100644index 000000000..d74d85ce0--- /dev/null+++ b/packages/openui-cli/src/lib/spinner.ts@@ -0,0 +1,39 @@+import * as readline from "node:readline";++/**+ * Terminal spinner for long-running work. Safe in non-TTY (prints the label once).+ * Clears the spinner line before resolving so callers can print a final status.+ *+ * Uses readline cursor APIs instead of bare `\r` — some terminals (including+ * Cursor/VS Code) don't reliably overwrite the current line with carriage return.+ */+export async function withSpinner<T>(label: string, run: () => Promise<T>): Promise<T> {+ if (!process.stdout.isTTY) {+ console.info(label);+ return run();+ }++ const frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];+ let frame = 0;++ const render = () => {+ readline.clearLine(process.stdout, 0);+ readline.cursorTo(process.stdout, 0);+ process.stdout.write(`${frames[frame]} ${label}`);+ };++ render();+ const timer = setInterval(() => {+ frame = (frame + 1) % frames.length;+ render();+ }, 80);+ timer.unref();++ try {+ return await run();+ } finally {+ clearInterval(timer);+ readline.clearLine(process.stdout, 0);+ readline.cursorTo(process.stdout, 0);+ }+}diff --git a/packages/openui-cli/src/templates/openui-cloud/next.config.ts b/packages/openui-cli/src/templates/openui-cloud/next.config.tsindex 30ac02797..9cb6e36da 100644--- a/packages/openui-cli/src/templates/openui-cloud/next.config.ts+++ b/packages/openui-cli/src/templates/openui-cloud/next.config.ts@@ -6,6 +6,9 @@ const nextConfig: NextConfig = {turbopack: {root: process.cwd(),},+ experimental: {+ turbopackMinify: false,+ },};export default nextConfig;