@lumerahq/cli 0.19.11 → 0.19.13

package/dist/index.js

@@ -248,7 +248,7 @@ async function main() {
         break;
       // Project
       case "init":
-        await import("./init-QCNR4ULM.js").then((m) => m.init(args.slice(1)));
+        await import("./init-KJOWD2KQ.js").then((m) => m.init(args.slice(1)));
         break;
       case "register":
         await import("./register-QBRKXWNX.js").then((m) => m.register(args.slice(1)));

package/dist/{init-QCNR4ULM.js → init-KJOWD2KQ.js}

@@ -25,7 +25,7 @@ init_auth();
 import pc from "picocolors";
 import prompts from "prompts";
 import { execSync } from "child_process";
-import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, rmSync, readlinkSync, symlinkSync } from "fs";
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, rmSync, readlinkSync, symlinkSync } from "fs";
 import { join, resolve } from "path";
 function toTitleCase(str) {
   return str.split(/[-_]/).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
@@ -41,6 +41,7 @@ function processTemplate(content, replacements) {
 }
 var TEMPLATE_EXCLUDE = /* @__PURE__ */ new Set(["template.json"]);
 var TEMPLATE_RENAMES = /* @__PURE__ */ new Map([["_gitignore", ".gitignore"]]);
+var TEMPLATE_RAW_COPY = /* @__PURE__ */ new Set(["pnpm-lock.yaml"]);
 function copyDir(src, dest, replacements, isRoot = true) {
   if (!existsSync(dest)) {
     mkdirSync(dest, { recursive: true });
@@ -60,6 +61,10 @@ function copyDir(src, dest, replacements, isRoot = true) {
     } else if (entry.isDirectory()) {
       copyDir(srcPath, destPath, replacements, false);
     } else {
+      if (TEMPLATE_RAW_COPY.has(entry.name)) {
+        copyFileSync(srcPath, destPath);
+        continue;
+      }
       const content = readFileSync(srcPath, "utf-8");
       const processed = processTemplate(content, replacements);
       writeFileSync(destPath, processed);
@@ -363,6 +368,7 @@ async function init(args) {
   ];
   copyDir(templateDir, targetDir, replacements);
   ensureClaudeInstructionsLink(targetDir);
+  const installCommand = existsSync(join(targetDir, "pnpm-lock.yaml")) ? "pnpm install --frozen-lockfile" : "pnpm install";
   function listFiles(dir, prefix = "") {
     for (const entry of readdirSync(dir, { withFileTypes: true })) {
       const relativePath = prefix + entry.name;
@@ -405,7 +411,7 @@ async function init(args) {
   if (opts.install) {
     const stopInstall = spinner("Installing dependencies...");
     try {
-      execSync("pnpm install", { cwd: targetDir, stdio: "ignore" });
+      execSync(installCommand, { cwd: targetDir, stdio: "ignore" });
       stopInstall(pc.green("\u2713") + pc.dim(" Dependencies installed"));
     } catch {
       stopInstall(pc.yellow("\u26A0") + pc.dim(" Failed to install dependencies"));
@@ -453,7 +459,7 @@ async function init(args) {
   console.log();
   console.log(pc.cyan(`  cd ${finalDirectory}`));
   if (!opts.install) {
-    console.log(pc.cyan("  pnpm install"));
+    console.log(pc.cyan(`  ${installCommand}`));
   }
   if (!registered) {
     console.log(pc.cyan("  lumera login"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumerahq/cli",
-  "version": "0.19.11",
+  "version": "0.19.13",
   "description": "CLI for building and deploying Lumera apps",
   "type": "module",
   "engines": {

package/templates/default/AGENTS.md

@@ -17,6 +17,12 @@ src/
 scripts/               # Utility scripts (seed data, migrations, etc.)
 ```
 
+The starter UI is intentionally throwaway. `src/routes/index.tsx` is just the
+default landing page shown before the real app exists, and `index.html` is only
+the Vite shell. When building the user's first real workflow or screen, replace
+the starter home page with the app experience instead of preserving or building
+around the placeholder content.
+
 ## Lumera Concepts
 
 A Lumera app is built from these primitives — all defined as code in `platform/`:
@@ -49,11 +55,11 @@ For detailed technical reference (data models, relationships, design decisions),
 
 ### Installing components
 
-Install shadcn components with `pnpm dlx` (the sandbox's default JS package manager):
+Install shadcn components with `pnpm dlx` (the sandbox's default JS package manager). Match the sandbox-pinned shadcn version:
 
 ```bash
-pnpm dlx shadcn@latest add button card dialog      # Install specific components
-pnpm dlx shadcn@latest add table input label select  # Install more as needed
+pnpm dlx shadcn@4.1.2 add button card dialog      # Install specific components
+pnpm dlx shadcn@4.1.2 add table input label select  # Install more as needed
 ```
 
 Components install into `src/components/ui/` and are fully editable.
@@ -122,6 +128,17 @@ const invoiceLink = buildShareableAppUrl('/invoices/123', { router: 'hash' });
 
 When reporting a deployed app, use `launch_url` or `url` from the deploy response. Do not share `iframe_url`; it is only the internal iframe/static asset mount.
 
+## Preview and Verification
+
+The Studio environment already runs the Vite dev server and exposes it through
+the portal's **Preview tab**. Users are not expected to run local developer
+commands, and raw localhost URLs are not reachable from the Studio portal.
+
+**Never tell users to run `pnpm dev`, `pnpm dev:vite`, `npm run dev`, or any
+other dev-server command. Never tell users to open `localhost`, `127.0.0.1`, or
+Vite ports such as `http://localhost:5173/`.** When explaining how to verify UI
+changes, tell them to open the **Preview tab**.
+
 
 ## Workflow
 
@@ -134,7 +151,7 @@ Follow the user's lead. If they tell you exactly what to build, build it. The wo
 
 ### Step 2: Build (one slice at a time)
 4. **Build horizontally** — Pick the first step. Build the full slice: collection schema → `lumera apply` → seed data → UI route/components → commit. Each slice should be deployable and usable on its own.
-5. **Stop and ask for feedback** — Tell the user to open the **Preview tab** to see the app. The dev server starts automatically — you do NOT need to run `pnpm dev` or start any server. Iterate on the slice until they're happy.
+5. **Stop and ask for feedback** — Tell the user to open the **Preview tab** to see the app. Do not mention local dev-server commands or localhost URLs. Iterate on the slice until they're happy.
 6. **Repeat** — Move to the next step. Build, deploy, get feedback.
 
 ### Rules

package/templates/default/_gitignore

@@ -1,6 +1,5 @@
 node_modules
 dist
-pnpm-lock.yaml
 .env
 .env.local
 *.local

package/templates/default/biome.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://biomejs.dev/schemas/2.0.0/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.4.16/schema.json",
   "vcs": {
     "enabled": true,
     "clientKind": "git",

package/templates/default/package.json

@@ -24,29 +24,26 @@
     "check:ci": "biome check . && tsr generate && tsc --noEmit"
   },
   "dependencies": {
-    "@lumerahq/ui": "^0.7.6",
+    "@lumerahq/ui": "^0.9.1",
     "@tanstack/react-query": "^5.90.11",
     "@tanstack/react-router": "1.155.0",
-    "@tanstack/router-plugin": "1.155.0",
-    "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "lucide-react": "^1.7.0",
-    "radix-ui": "^1.4.3",
-    "shadcn": "^4.1.2",
     "tailwind-merge": "^3.4.0",
-    "tw-animate-css": "^1.4.0",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
-    "sonner": "^2.0.7",
-    "tailwindcss": "^4.2.2"
+    "sonner": "^2.0.7"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.10",
     "@tailwindcss/vite": "^4.2.2",
     "@tanstack/router-cli": "1.155.0",
+    "@tanstack/router-plugin": "1.155.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^6.0.1",
+    "tailwindcss": "^4.2.2",
+    "tw-animate-css": "^1.4.0",
     "typescript": "^6.0.2",
     "vite": "^8.0.3"
   }