@lumerahq/cli 0.19.11 → 0.19.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumerahq/cli",
-  "version": "0.19.11",
+  "version": "0.19.12",
   "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/`:
@@ -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/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,7 +24,7 @@
     "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",

package/templates/default/src/lib/utils.ts

@@ -1,5 +1,5 @@
-import { type ClassValue, clsx } from "clsx";
-import { twMerge } from "tailwind-merge";
+import { type ClassValue, clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
 
 export function cn(...inputs: ClassValue[]) {
   return twMerge(clsx(inputs));

package/templates/default/src/main.tsx

@@ -125,6 +125,6 @@ if (rootElement && !rootElement.innerHTML) {
   ReactDOM.createRoot(rootElement).render(
     <StrictMode>
       <App />
-    </StrictMode>,
+    </StrictMode>
   );
 }

package/templates/default/src/routes/index.tsx

@@ -1,6 +1,6 @@
 import { createFileRoute } from '@tanstack/react-router';
+import { Bot, LayoutGrid, MessageSquare, Workflow } from 'lucide-react';
 import { useContext } from 'react';
-import { MessageSquare, LayoutGrid, Bot, Workflow } from 'lucide-react';
 import { AuthContext } from '../lib/auth';
 
 export const Route = createFileRoute('/')({
@@ -14,8 +14,12 @@ function HomePage() {
     <div className="space-y-10">
       {/* Header */}
       <div>
-        <h1 className="text-2xl font-semibold tracking-tight">Welcome{auth?.user?.name ? `, ${auth.user.name}` : ''}</h1>
-        <p className="text-muted-foreground mt-2 text-[0.95rem] leading-relaxed">Your app is ready. Use Studio to start building.</p>
+        <h1 className="text-2xl font-semibold tracking-tight">
+          Welcome{auth?.user?.name ? `, ${auth.user.name}` : ''}
+        </h1>
+        <p className="text-muted-foreground mt-2 text-[0.95rem] leading-relaxed">
+          Your app is ready. Use Studio to start building.
+        </p>
       </div>
 
       {/* Getting Started */}
@@ -27,8 +31,8 @@ function HomePage() {
           <div className="space-y-2">
             <h2 className="font-semibold text-lg tracking-tight">Build with Studio</h2>
             <p className="text-muted-foreground text-sm leading-relaxed">
-              Switch to the <strong>Chat</strong> tab and tell the agent what you want to build.
-              It will set up your data, write the logic, and build your UI — all from a conversation.
+              Switch to the <strong>Chat</strong> tab and tell the agent what you want to build. It
+              will set up your data, write the logic, and build your UI — all from a conversation.
             </p>
           </div>
         </div>
@@ -36,7 +40,9 @@ function HomePage() {
 
       {/* Example prompts */}
       <div>
-        <h2 className="text-sm font-semibold uppercase tracking-wider text-muted-foreground mb-4">Try asking the agent</h2>
+        <h2 className="text-sm font-semibold uppercase tracking-wider text-muted-foreground mb-4">
+          Try asking the agent
+        </h2>
         <div className="flex flex-wrap gap-2">
           {[
             'Build an invoice processing app with approval workflows',
@@ -57,27 +63,32 @@ function HomePage() {
 
       {/* What you can build */}
       <div>
-        <h2 className="text-sm font-semibold uppercase tracking-wider text-muted-foreground mb-5">What you can build</h2>
+        <h2 className="text-sm font-semibold uppercase tracking-wider text-muted-foreground mb-5">
+          What you can build
+        </h2>
         <div className="grid gap-4 md:grid-cols-3">
           <div className="group rounded-xl bg-card p-5 space-y-3 shadow-[0_1px_2px_0_oklch(0_0_0/0.03)] border border-border/60 hover:shadow-[0_4px_12px_-2px_oklch(0_0_0/0.06)] hover:border-border transition-all duration-300">
             <LayoutGrid className="size-5 text-primary transition-colors duration-300" />
             <h3 className="font-medium text-sm tracking-tight">Internal apps</h3>
             <p className="text-xs text-muted-foreground leading-relaxed">
-              Back-office tools for your team — dashboards, approval queues, and operational workflows.
+              Back-office tools for your team — dashboards, approval queues, and operational
+              workflows.
             </p>
           </div>
           <div className="group rounded-xl bg-card p-5 space-y-3 shadow-[0_1px_2px_0_oklch(0_0_0/0.03)] border border-border/60 hover:shadow-[0_4px_12px_-2px_oklch(0_0_0/0.06)] hover:border-border transition-all duration-300">
             <Bot className="size-5 text-primary transition-colors duration-300" />
             <h3 className="font-medium text-sm tracking-tight">Agent-powered workflows</h3>
             <p className="text-xs text-muted-foreground leading-relaxed">
-              AI agents that extract data, run reviews, draft outputs, and route exceptions — humans stay in the loop.
+              AI agents that extract data, run reviews, draft outputs, and route exceptions — humans
+              stay in the loop.
             </p>
           </div>
           <div className="group rounded-xl bg-card p-5 space-y-3 shadow-[0_1px_2px_0_oklch(0_0_0/0.03)] border border-border/60 hover:shadow-[0_4px_12px_-2px_oklch(0_0_0/0.06)] hover:border-border transition-all duration-300">
             <Workflow className="size-5 text-primary transition-colors duration-300" />
             <h3 className="font-medium text-sm tracking-tight">Automations</h3>
             <p className="text-xs text-muted-foreground leading-relaxed">
-              Connect to your systems, process inbound emails, and trigger actions automatically — with a full audit trail.
+              Connect to your systems, process inbound emails, and trigger actions automatically —
+              with a full audit trail.
             </p>
           </div>
         </div>

package/templates/default/src/styles.css

@@ -34,7 +34,7 @@ body {
   --secondary-foreground: oklch(0.16 0.01 60);
   /* Warm stone muted tones */
   --muted: oklch(0.955 0.005 60);
-  --muted-foreground: oklch(0.50 0.01 60);
+  --muted-foreground: oklch(0.5 0.01 60);
   /* Accent — lighter orange tint */
   --accent: oklch(0.95 0.03 50);
   --accent-foreground: oklch(0.35 0.12 35);

package/templates/default/vite.config.ts

@@ -20,9 +20,6 @@ export default defineConfig({
     dedupe: ['react', 'react-dom'],
   },
   server: {
-    allowedHosts: [
-      'mac.lumerahq.com',
-      'untunable-del-nonephemerally.ngrok-free.dev',
-    ],
+    allowedHosts: ['mac.lumerahq.com'],
   },
 });