@lumerahq/cli 0.9.3 → 0.9.4

package/README.md

@@ -19,14 +19,14 @@ lumera logout              # Clear stored credentials
 lumera whoami              # Show current user
 lumera status              # Show project info
 
-lumera app dev             # Start dev server
-lumera app deploy          # Deploy frontend to S3
-lumera app destroy         # Delete app from Lumera
+lumera dev                 # Start dev server
+lumera apply app           # Deploy frontend
+lumera destroy app         # Delete app from Lumera
 
-lumera platform plan       # Preview infrastructure changes
-lumera platform apply      # Apply collections, automations, hooks
-lumera platform pull       # Pull remote state to local
-lumera platform destroy    # Delete remote resources
+lumera plan                # Preview infrastructure changes
+lumera apply               # Apply collections, automations, hooks
+lumera pull                # Pull remote state to local
+lumera destroy             # Delete remote resources
 
 lumera run <script>        # Run Python scripts locally
 ```
@@ -84,7 +84,7 @@ For automated environments, use the `LUMERA_TOKEN` environment variable:
 
 ```bash
 export LUMERA_TOKEN=your_api_token
-lumera app deploy
+lumera apply app
 ```
 
 The CLI checks for credentials in this order:

package/dist/index.js

@@ -118,7 +118,7 @@ async function main() {
         break;
       // Project
       case "init":
-        await import("./init-LVO3ZMG7.js").then((m) => m.init(args.slice(1)));
+        await import("./init-EDSRR3YM.js").then((m) => m.init(args.slice(1)));
         break;
       case "status":
         await import("./status-E4IHEUKO.js").then((m) => m.status(args.slice(1)));

package/dist/{init-LVO3ZMG7.js → init-EDSRR3YM.js}

@@ -332,6 +332,15 @@ async function init(args) {
       console.log(pc.green("  \u2713"), pc.dim(`${installed} Lumera skills installed`));
     }
     syncClaudeMd(targetDir);
+    if (isGitInstalled()) {
+      try {
+        execSync('git add -A && git commit -m "chore: install lumera skills"', {
+          cwd: targetDir,
+          stdio: "ignore"
+        });
+      } catch {
+      }
+    }
   } catch (err) {
     console.log(pc.yellow("  \u26A0"), pc.dim(`Failed to install skills: ${err}`));
   }

package/package.json

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

package/templates/default/ARCHITECTURE.md

@@ -0,0 +1,80 @@
+# {{projectTitle}} — Architecture
+
+## Overview
+
+{{projectTitle}} is a Lumera embedded app — a React frontend served inside the Lumera platform iframe, backed by collections, hooks, and automations managed through the Lumera CLI.
+
+## System Diagram
+
+```
+┌─────────────────────────────────────────────────┐
+│  Lumera Platform                                │
+│                                                 │
+│  ┌───────────┐   postMessage    ┌────────────┐  │
+│  │  Host UI  │ ◄──────────────► │  App       │  │
+│  │           │   (auth, init)   │  (iframe)  │  │
+│  └─────┬─────┘                  └─────┬──────┘  │
+│        │                              │         │
+│        │  REST API                    │         │
+│        ▼                              ▼         │
+│  ┌──────────────────────────────────────────┐   │
+│  │  Lumera API                              │   │
+│  │  - Collections (CRUD, SQL, search)       │   │
+│  │  - Automations (run, poll, cancel)       │   │
+│  │  - File storage (upload, download)       │   │
+│  └──────────────┬───────────────────────────┘   │
+│                 │                                │
+│                 ▼                                │
+│  ┌──────────────────────────────────────────┐   │
+│  │  Tenant Database (PocketBase/SQLite)     │   │
+│  │  - example_items                         │   │
+│  │  - (add your collections here)           │   │
+│  └──────────────────────────────────────────┘   │
+└─────────────────────────────────────────────────┘
+```
+
+## Frontend (`src/`)
+
+React app using TanStack Router (file-based routing) and TanStack Query for data fetching. Embedded in Lumera via iframe with postMessage bridge for authentication.
+
+| Directory        | Purpose                              |
+|------------------|--------------------------------------|
+| `src/routes/`    | Pages — file names map to URL paths  |
+| `src/components/`| Shared React components              |
+| `src/lib/`       | API helpers, query functions         |
+| `src/main.tsx`   | App entry — auth bridge, router init |
+
+**Key patterns:**
+- Auth context flows from `main.tsx` via `AuthContext`
+- Data fetching uses `pbList`, `pbSql` from `@lumerahq/ui/lib`
+- Styling via Tailwind CSS 4 with theme tokens in `styles.css`
+
+## Platform Resources (`platform/`)
+
+Declarative definitions deployed via `lumera apply`.
+
+| Directory                | Purpose                          |
+|--------------------------|----------------------------------|
+| `platform/collections/`  | Collection schemas (JSON)        |
+| `platform/automations/`  | Background Python scripts        |
+| `platform/hooks/`        | Server-side JS on collection events |
+
+## Scripts (`scripts/`)
+
+Local Python scripts run via `lumera run`. Used for seeding data, migrations, and ad-hoc operations. All scripts should be idempotent.
+
+## Data Flow
+
+1. **User opens app** → Lumera host sends auth payload via postMessage
+2. **App authenticates** → Stores session token in `AuthContext`
+3. **App fetches data** → Calls Lumera API via `@lumerahq/ui/lib` helpers
+4. **Data mutations** → API calls trigger collection hooks if configured
+5. **Background work** → Automations run async via `createRun` / `pollRun`
+
+## Collections
+
+| Collection       | Purpose                    |
+|------------------|----------------------------|
+| `example_items`  | Starter collection (replace with your own) |
+
+_Update this table as you add collections._

package/templates/default/CLAUDE.md

@@ -33,9 +33,9 @@ pnpm dev              # Start dev server
 pnpm deploy           # Deploy frontend
 
 # All other commands
-pnpm dlx @lumerahq/cli platform plan
-pnpm dlx @lumerahq/cli platform apply
-pnpm dlx @lumerahq/cli platform destroy
+pnpm dlx @lumerahq/cli plan
+pnpm dlx @lumerahq/cli apply
+pnpm dlx @lumerahq/cli destroy
 pnpm dlx @lumerahq/cli run scripts/seed-demo.py
 pnpm dlx @lumerahq/cli status
 ```
@@ -50,10 +50,10 @@ lumera login
 pnpm dev
 
 # With custom port
-lumera app dev --port 3000
+lumera dev --port 3000
 
 # With ngrok tunnel
-lumera app dev --url https://my-tunnel.ngrok.io
+lumera dev --url https://my-tunnel.ngrok.io
 
 # Plain vite (no Lumera registration)
 pnpm dev:vite
@@ -71,21 +71,21 @@ pnpm lint
 # Format code
 pnpm format
 
-# Run all checks (lint + typecheck) - use in CI
+# Run all checks (lint + format + typecheck) - use in CI
 pnpm check:ci
 ```
 
 ### Deploying
 
 ```bash
-# Deploy frontend to S3
-lumera app deploy
+# Deploy frontend
+lumera apply app
 
-# Apply platform resources (collections, automations, hooks)
-lumera platform apply
+# Apply all resources (collections, automations, hooks, app)
+lumera apply
 
-# Preview platform changes first
-lumera platform plan
+# Preview changes first
+lumera plan
 ```
 
 ### Running Scripts
@@ -129,7 +129,7 @@ EOF
 
 ## Important Rules
 
-1. **Authenticate first** - Before running any CLI or SDK commands, ensure the user has run `lumera login --local`. This stores credentials in `.lumera/credentials.json` which the SDK reads automatically.
+1. **Authenticate first** - Before running any CLI or SDK commands, ensure the user has run `lumera login`. This stores credentials in `.lumera/credentials.json` which the SDK reads automatically.
 
 2. **Source of truth is code** - `platform/` contains all schemas, automations, hooks. Update local code first, then deploy.
 

package/templates/default/README.md

@@ -23,13 +23,13 @@ Lumera custom embedded app.
 
 ```bash
 # Development
-lumera app dev                    # Start dev server
-lumera app dev --port 3000        # Custom port
+lumera dev                        # Start dev server
+lumera dev --port 3000            # Custom port
 
 # Deployment
-lumera app deploy                 # Build and deploy frontend
-lumera platform apply             # Apply collections, automations, hooks
-lumera platform plan              # Preview platform changes
+lumera apply app                  # Build and deploy frontend
+lumera apply                      # Apply all resources
+lumera plan                       # Preview changes
 
 # Scripts
 lumera run scripts/seed-demo.py   # Run seed script

package/templates/default/biome.json

@@ -29,5 +29,10 @@
       "semicolons": "always",
       "trailingCommas": "es5"
     }
+  },
+  "css": {
+    "parser": {
+      "tailwindDirectives": true
+    }
   }
 }

package/templates/default/package.json.hbs

@@ -12,16 +12,16 @@
     "name": "{{projectTitle}}"
   },
   "scripts": {
-    "dev": "pnpm dlx @lumerahq/cli app dev",
-    "deploy": "pnpm dlx @lumerahq/cli app deploy",
+    "dev": "pnpm dlx @lumerahq/cli dev",
+    "deploy": "pnpm dlx @lumerahq/cli apply app",
     "dev:vite": "vite",
     "build": "vite build && tsc",
     "preview": "vite preview",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsr generate && tsc --noEmit",
     "lint": "biome lint --write .",
     "format": "biome format --write .",
     "check": "biome check --write .",
-    "check:ci": "biome check . && tsc --noEmit"
+    "check:ci": "biome check . && tsr generate && tsc --noEmit"
   },
   "dependencies": {
     "@lumerahq/ui": "^0.5.0",
@@ -37,6 +37,7 @@
   "devDependencies": {
     "@biomejs/biome": "^2.0.0",
     "@tailwindcss/vite": "^4.0.6",
+    "@tanstack/router-cli": "1.155.0",
     "@types/react": "^19.2.0",
     "@types/react-dom": "^19.2.0",
     "@vitejs/plugin-react": "^5.0.4",

package/templates/default/platform/collections/example_items.json

@@ -22,7 +22,5 @@
       "type": "text"
     }
   ],
-  "indexes": [
-    { "fields": ["source_id"], "unique": true }
-  ]
+  "indexes": [{ "fields": ["source_id"], "unique": true }]
 }

package/templates/default/scripts/seed-demo.py

@@ -1,5 +1,5 @@
 # /// script
-# dependencies = ["lumera-sdk"]
+# dependencies = ["lumera"]
 # ///
 """
 Seed demo data into Lumera (idempotent - safe to run multiple times).

package/templates/default/src/components/Sidebar.tsx

@@ -1,7 +1,7 @@
+import { cn } from '@lumerahq/ui/lib';
 import { Link, useRouterState } from '@tanstack/react-router';
-import { LayoutDashboard, Settings, ChevronLeft, ChevronRight } from 'lucide-react';
+import { ChevronLeft, ChevronRight, LayoutDashboard, Settings } from 'lucide-react';
 import { useState } from 'react';
-import { cn } from '@lumerahq/ui/lib';
 
 type NavItem = {
   to: string;
@@ -37,9 +37,7 @@ export function Sidebar() {
           <div className="size-8 rounded-lg bg-primary flex items-center justify-center text-primary-foreground font-bold text-sm">
             {{projectInitial}}
           </div>
-          {!collapsed && (
-            <span className="font-semibold text-sm">{{projectTitle}}</span>
-          )}
+          {!collapsed && <span className="font-semibold text-sm">{{projectTitle}}</span>}
         </Link>
       </div>
 

package/templates/default/src/components/StatCard.tsx

@@ -16,15 +16,9 @@ export function StatCard({ title, value, subtitle, icon, className }: StatCardPr
         <div className="space-y-1">
           <p className="text-sm font-medium text-muted-foreground">{title}</p>
           <p className="text-2xl font-semibold tracking-tight">{value}</p>
-          {subtitle && (
-            <p className="text-sm text-muted-foreground">{subtitle}</p>
-          )}
+          {subtitle && <p className="text-sm text-muted-foreground">{subtitle}</p>}
         </div>
-        {icon && (
-          <div className="rounded-lg bg-muted p-2.5 text-muted-foreground">
-            {icon}
-          </div>
-        )}
+        {icon && <div className="rounded-lg bg-muted p-2.5 text-muted-foreground">{icon}</div>}
       </div>
     </div>
   );

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

@@ -1,4 +1,4 @@
-import { pbList, type PbRecord } from '@lumerahq/ui/lib';
+import { type PbRecord, pbList } from '@lumerahq/ui/lib';
 
 export type ExampleRecord = PbRecord & {
   name: string;

package/templates/default/src/main.tsx

@@ -1,16 +1,10 @@
-import { StrictMode, createContext, useEffect, useRef, useState } from 'react';
-import ReactDOM from 'react-dom/client';
+import { type HostPayload, isEmbedded, onInitMessage, postReadyMessage } from '@lumerahq/ui/lib';
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
-import { RouterProvider, createRouter, createHashHistory } from '@tanstack/react-router';
+import { createHashHistory, createRouter, RouterProvider } from '@tanstack/react-router';
+import { createContext, StrictMode, useEffect, useRef, useState } from 'react';
+import ReactDOM from 'react-dom/client';
 import { Toaster } from 'sonner';
 
-import {
-  isEmbedded,
-  onInitMessage,
-  postReadyMessage,
-  type HostPayload,
-} from '@lumerahq/ui/lib';
-
 import { routeTree } from './routeTree.gen';
 import '@lumerahq/ui/styles.css';
 import './styles.css';

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

@@ -1,4 +1,4 @@
-import { Outlet, createRootRoute } from '@tanstack/react-router';
+import { createRootRoute, Outlet } from '@tanstack/react-router';
 import { AppLayout } from '../components/layout';
 
 export const Route = createRootRoute({

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

@@ -1,8 +1,8 @@
 import { createFileRoute } from '@tanstack/react-router';
+import { Activity, FileText, TrendingUp, Users } from 'lucide-react';
 import { useContext } from 'react';
-import { Users, FileText, Activity, TrendingUp } from 'lucide-react';
-import { AuthContext } from '../main';
 import { StatCard } from '../components/StatCard';
+import { AuthContext } from '../main';
 
 export const Route = createFileRoute('/')({
   component: HomePage,
@@ -16,9 +16,7 @@ function HomePage() {
       {/* Header */}
       <div>
         <h1 className="text-2xl font-semibold">Dashboard</h1>
-        <p className="text-muted-foreground mt-1">
-          Welcome back, {auth?.user?.name ?? 'User'}
-        </p>
+        <p className="text-muted-foreground mt-1">Welcome back, {auth?.user?.name ?? 'User'}</p>
       </div>
 
       {/* Stats Grid */}

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

@@ -9,16 +9,12 @@ function SettingsPage() {
     <div className="space-y-6">
       <div>
         <h1 className="text-2xl font-semibold">Settings</h1>
-        <p className="text-muted-foreground mt-1">
-          Manage your application settings
-        </p>
+        <p className="text-muted-foreground mt-1">Manage your application settings</p>
       </div>
 
       <div className="rounded-xl border bg-card p-6">
         <h2 className="font-semibold mb-4">General</h2>
-        <p className="text-sm text-muted-foreground">
-          Add your settings UI here
-        </p>
+        <p className="text-sm text-muted-foreground">Add your settings UI here</p>
       </div>
     </div>
   );

package/templates/default/src/styles.css

@@ -35,6 +35,10 @@ body {
 }
 
 @layer base {
-  * { @apply border-border; }
-  body { @apply bg-background text-foreground; }
+  * {
+    @apply border-border;
+  }
+  body {
+    @apply bg-background text-foreground;
+  }
 }

package/templates/default/vite.config.ts

@@ -1,7 +1,7 @@
-import { defineConfig } from 'vite';
-import viteReact from '@vitejs/plugin-react';
 import tailwindcss from '@tailwindcss/vite';
 import { tanstackRouter } from '@tanstack/router-plugin/vite';
+import viteReact from '@vitejs/plugin-react';
+import { defineConfig } from 'vite';
 
 export default defineConfig({
   base: './', // Use relative paths for S3 hosting at subpaths
@@ -22,6 +22,7 @@ export default defineConfig({
   server: {
     allowedHosts: [
       'mac.lumerahq.com',
+      'untunable-del-nonephemerally.ngrok-free.dev',
     ],
   },
 });