showpane 0.4.4 → 0.4.5

package/bundle/meta/scaffold-manifest.json

@@ -1,11 +1,11 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-04-09T13:24:17.013Z",
-  "scaffoldVersion": "0.2.1",
+  "generatedAt": "2026-04-09T14:11:15.147Z",
+  "scaffoldVersion": "0.2.2",
   "files": {
     ".env.example": "0dd692f1c7e6bcabdf5dbdfe9abb73797d79d8e90da150d6098b63ddc695dc29",
     ".gitignore": "998e5f43865ea56ac79a05acfd5d4b0d696f310bd5325a1ed458c3d40154d437",
-    "VERSION": "71015c979ccb0fc8a0be7ca0ae83046ab045cdc2c8faa09fb2f0f7e440f9b4a6",
+    "VERSION": "998f6b887ed7a6ef44e84210d0237b715bed42ea7254f48dc418afec0a484103",
     "docker-compose.yml": "420fd123da019c22f03662933537e24779b4c2c91f90c23abfec5965cd0f35ce",
     "docker/Caddyfile": "d9c58086986795f5b3e42ff9b5942e60b8df946a1a0c40351381616c0b4d2bed",
     "docker/Dockerfile": "340470e3735ea53b2c03003a13a91361652291add33c40a2bf13e6af2a8cb73a",
@@ -47,7 +47,7 @@
     "src/app/api/health/route.ts": "78fff55707372ce0cd6e9e49ef4f049622bc43cc42916d3f83e0162409d678b1",
     "src/app/globals.css": "28dcda76006d0e6af01b6dcf1a315dc5b5b6931c880fc53fd6565ff09d5dd13a",
     "src/app/layout.tsx": "c17aabeb2b486f023e777230343ace6cc06840f641a10b9dd9f65e092018f82f",
-    "src/app/page.tsx": "1c48a37632621373db7730756aacde708e29d6f1bd14062b63736fe8057ce842",
+    "src/app/page.tsx": "df6abc817e751782df1f59ed770d6e0b47d3a24ea4ad3682485680bdf71845f8",
     "src/components/copy-button.tsx": "2f3d1d8a6a0a570c8d78e19c3c15519c44af17b5d8893ae5a5f57db5ecce7077",
     "src/components/portal-login.tsx": "8b0d91bb28674e1102fd2e5b5ddcc3a93755dd806fbd3d1b2dbea2646cffca5e",
     "src/components/portal-shell.tsx": "a4e16e118ef93f79e71fb69e80f1fac6e6fff90f0fbdacdf8deb821a57656877",

package/bundle/scaffold/VERSION

@@ -1 +1 @@
-0.2.1
+0.2.2

package/bundle/scaffold/src/app/page.tsx

@@ -16,9 +16,9 @@ const PROMPT_EXAMPLES = [
 export default async function Home() {
   let portalCount = 0;
   const showpaneBinDir = path.join(os.homedir(), ".showpane", "bin");
-  const resumeCommand = (process.env.PATH ?? "").split(path.delimiter).includes(showpaneBinDir)
-    ? "showpane claude"
-    : "npx showpane claude";
+  const prefersCanonicalCommand = (process.env.PATH ?? "").split(path.delimiter).includes(showpaneBinDir);
+  const primaryCommand = "showpane claude";
+  const fallbackCommand = "npx showpane claude";
   try {
     if (isRuntimeSnapshotMode()) {
       const state = await getRuntimeState();
@@ -46,7 +46,7 @@ export default async function Home() {
             Your Showpane workspace is ready
           </h1>
           <p className="mt-4 max-w-2xl text-base leading-7 text-white/82 sm:text-lg">
-            Open Claude in your Showpane workspace and create your first client portal.
+            Open a new terminal window, run Showpane with Claude, and create your first client portal.
           </p>
         </div>
       </div>
@@ -61,15 +61,21 @@ export default async function Home() {
                   Start with Claude
                 </div>
                 <p className="mt-3 text-sm leading-6 text-white/72">
-                  This opens Claude in the right Showpane workspace so you can start creating portals immediately.
+                  Open a new terminal window and run this command there. Your current terminal is running the local app, so this command belongs in a fresh one.
                 </p>
+                {!prefersCanonicalCommand && (
+                  <p className="mt-2 text-xs leading-5 text-white/60">
+                    If <code className="font-mono text-white">{primaryCommand}</code> isn&apos;t available in your shell yet, use{" "}
+                    <code className="font-mono text-white">{fallbackCommand}</code>.
+                  </p>
+                )}
               </div>
-              <CopyButton text={resumeCommand} invert />
+              <CopyButton text={primaryCommand} invert />
             </div>
 
             <div className="mt-5 rounded-2xl border border-white/10 bg-white/5 p-4">
               <code className="block overflow-x-auto font-mono text-sm text-white sm:text-[15px]">
-                {resumeCommand}
+                {primaryCommand}
               </code>
             </div>
           </section>

package/bundle/toolchain/VERSION

@@ -1 +1 @@
-1.1.1 (requires app >= 0.2.1)
+1.1.2 (requires app >= 0.2.2)

package/dist/index.js

@@ -331,6 +331,18 @@ function stepFailure(label, errorLike, hint) {
   }
   process.exit(1);
 }
+function shouldUseSpinner(verbose) {
+  return process.stdout.isTTY && !verbose;
+}
+function stepStartForCreate(label, options) {
+  stepStart(label, shouldUseSpinner(options.verbose));
+}
+function stepSuccessForCreate(label) {
+  stepSuccess(label);
+}
+function stepFailureForCreate(label, errorLike, hint) {
+  stepFailure(label, errorLike, hint);
+}
 function attachSpinnerCleanup() {
   const cleanup = () => stopSpinner();
   process.on("exit", cleanup);
@@ -792,9 +804,11 @@ function printCreateSuccessCard(projectRoot, url) {
   console.log(`  ${BOLD}App:${RESET}     ${url}`);
   console.log(`  ${BOLD}Demo:${RESET}    example / demo-only-password`);
   console.log();
-  console.log(`  ${BOLD}Next:${RESET}`);
+  console.log(`  ${BOLD}Next (in a new terminal window):${RESET}`);
   console.log(`    ${DIM}${resumeCommand}${RESET}`);
   console.log();
+  console.log(`  ${DIM}Your current terminal is running the local app logs, so open a fresh terminal before you run that command.${RESET}`);
+  console.log();
   console.log(`  ${BOLD}Try:${RESET}`);
   console.log(`    ${DIM}Create a portal for my call with Acme Health${RESET}`);
   if (resumeHint) {
@@ -1046,19 +1060,19 @@ async function createProject(args) {
   console.log();
   blue(`Setting up ${BOLD}${companyName}${RESET} portal as ${DIM}${dirName}/${RESET}`);
   console.log();
-  stepStart("Create project");
+  stepStartForCreate("Create project", options);
   try {
     copyScaffoldFiles(join(bundleRoot, "scaffold"), projectRoot, scaffoldManifest);
-    stepSuccess("Project created");
+    stepSuccessForCreate("Project created");
   } catch (errorLike) {
-    stepFailure("Create project", errorLike);
+    stepFailureForCreate("Create project", errorLike);
   }
-  stepStart("Install dependencies");
+  stepStartForCreate("Install dependencies", options);
   try {
     installDependencies(projectRoot, options.verbose);
-    stepSuccess("Dependencies installed");
+    stepSuccessForCreate("Dependencies installed");
   } catch (errorLike) {
-    stepFailure(
+    stepFailureForCreate(
       "Install dependencies",
       errorLike,
       "Check your Node.js version and network connection, then try again."
@@ -1072,19 +1086,19 @@ async function createProject(args) {
 AUTH_SECRET="${authSecret}"
 `
   );
-  stepStart("Configure database");
+  stepStartForCreate("Configure database", options);
   try {
     generateLocalDatabase(projectRoot, databaseUrl, options.verbose);
     seedProject(projectRoot, databaseUrl, options.verbose);
-    stepSuccess("Database configured");
+    stepSuccessForCreate("Database configured");
   } catch (errorLike) {
-    stepFailure(
+    stepFailureForCreate(
       "Configure database",
       errorLike,
       "Check Prisma setup and the generated .env file, then retry the install."
     );
   }
-  stepStart("Install Claude skills");
+  stepStartForCreate("Install Claude skills", options);
   let toolchainInfo;
   try {
     toolchainInfo = syncToolchain(bundleRoot, showpaneVersion, false);
@@ -1102,15 +1116,15 @@ AUTH_SECRET="${authSecret}"
       toolchainInfo.toolchainVersion
     );
     tryInitializeGitRepo(projectRoot, false);
-    stepSuccess("Claude skills installed");
+    stepSuccessForCreate("Claude skills installed");
   } catch (errorLike) {
-    stepFailure(
+    stepFailureForCreate(
       "Install Claude skills",
       errorLike,
       "Check permissions for ~/.showpane and ~/.claude/skills, then try again."
     );
   }
-  stepStart("Start app");
+  stepStartForCreate("Start app", options);
   let serverStart;
   try {
     serverStart = await startDevServer(
@@ -1120,7 +1134,7 @@ AUTH_SECRET="${authSecret}"
       options.verbose
     );
   } catch (errorLike) {
-    stepFailure(
+    stepFailureForCreate(
       "Start app",
       errorLike,
       `Run ${BOLD}cd ${dirName} && npm run dev${RESET} for more detail.`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "showpane",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "CLI for Showpane — AI-generated client portals",
   "type": "module",
   "bin": {