robodev 0.45.1 → 0.47.0

package/templates/marketplace/.rulesync/skills/povio-ui-styling/SKILL.md

@@ -132,6 +132,9 @@ Do not create a CSS file for ordinary spacing, flex/grid layout, a simple hover,
 | Generated design tokens                                        | Figma-generated `theme.css` |
 | Handwritten global token or browser rule                       | `base.css` or `globals.css` |
 
+Retheming the app means overriding tokens in `globals.css`, in `@layer base`, after the
+`theme.css` import — nowhere else redeclares them, so the last declaration in that layer wins.
+
 ## Guardrails
 
 - Use `@povio/ui` before creating a custom primitive.

package/templates/marketplace/apps/fe/src/styles/base.css

@@ -82,22 +82,3 @@ html {
 .flex-fill {
   flex: 1 0 0;
 }
-
-:root {
-  --elevation-fill-default-2-base: 248 249 249;
-  --elevation-outline-default-1-base: 218 220 221;
-  --elevation-outline-default-2-base: 198 200 201;
-  --interactive-contained-primary-idle-base: 0 90 154;
-  --interactive-contained-primary-hover-base: 46 142 210;
-  --interactive-contained-primary-pressed-base: 95 170 224;
-  --interactive-contained-primary-disabled-base: 155 194 221;
-  --interactive-contained-primary-focus-base: 95 170 224;
-  --interactive-outlined-primary-on-idle-base: 0 90 154;
-  --interactive-outlined-primary-outline-idle-base: 0 90 154;
-  --interactive-outlined-primary-outline-hover-base: 46 142 210;
-  --interactive-text-primary-idle-base: 0 90 154;
-  --interactive-text-primary-hover-base: 46 142 210;
-  --text-default-1-base: 25 26 27;
-  --text-default-2-base: 79 85 88;
-  --text-default-3-base: 111 114 116;
-}

package/templates/marketplace/package.json

@@ -12,7 +12,7 @@
     "@robodev-ai/sdk": "^0.13.0"
   },
   "devDependencies": {
-    "robodev": "^0.45.1",
+    "robodev": "^0.47.0",
     "rulesync": "^8.18.0",
     "typescript": "^5.9.2"
   }

package/templates/shadcn/README.md

@@ -0,0 +1,20 @@
+# {{NAME}}
+
+Blank `robodev/database.ts` and `GET /api/health` plus a hosted Welcome page with shadcn and an orval client. No sample schema.
+
+The project App URL serves the hosted Welcome page (`/` via React Router in `src/pages/Home.tsx`). Edit `index.html` and `src/`, then `robodev deploy` (or Code + Save). Agents: read `ROBODEV.md`.
+
+```bash
+robodev create my-app --template shadcn
+robodev dev            # local APIs
+pnpm run dev:fe        # optional local Vite
+pnpm run generate:api  # regenerate the orval client from src/api/openapi.json
+```
+
+`robodev create` without `--template` / `--starter` / `--empty` still uses Empty. Pass `--template shadcn` (or `--starter shadcn`) for this starter.
+
+Do not write a `frontend` block in `robodev/.robodev` — that block is for Tiny `apps/fe`. Root `index.html` + `src/` deploy as hosted React.
+
+Hosted compile does not run Tailwind. `src/app.css` is plain CSS so Welcome works on the project host. `tailwind.config.ts` and `postcss.config.js` are for local `shadcn add` / Vite only. The orval client under `src/api/generated/` is committed; regenerate it after API changes.
+
+Docs: https://robodev.povio.dev/docs

package/templates/shadcn/ROBODEV.md

@@ -0,0 +1,67 @@
+# Robodev
+
+Agent notes for this Shadcn workspace. Use this file for Robodev and SDK facts. Do not web-search the SDK.
+
+This is the hosted Shadcn layout. Keep it. Do not convert this tree to Tiny (`packages/be` + `apps/fe`).
+
+## Layout
+
+- Schema: `robodev/database.ts` (`defineDatabase` from `@robodev-ai/sdk`)
+- HTTP handlers: `robodev/api/**/*.ts` (`defineApi` from `@robodev-ai/sdk`)
+- Optional jobs: `robodev/jobs/**/*.ts`. Optional sockets: `robodev/sockets/**/*.ts` (`defineSocket`). Optional runtime packages go in `robodev/package.json` (allowlisted exact semver only). Do not npm install in this runner — Starbase installs on publish.
+- Frontend: root `index.html` + `src/**` (React, React Router, shadcn, generated orval client)
+- Auth is reserved at `/api/user/*`. Do not add `robodev/api/user/**`.
+
+Do not write a `frontend` block in `robodev/.robodev` — that block is for Tiny `apps/fe`. Root `index.html` + `src/` deploy as hosted React.
+
+## defineApi (copy-paste)
+
+`db`, `email`, `storage`, and `env` are injected. Never `import { db } from "@robodev-ai/sdk"`.
+The SDK is not installed in the runner. Do not `import("@robodev-ai/sdk")`. Do not search `/opt`, `node_modules`, or grok/gemini home for it.
+
+```ts
+import { defineApi, z } from "@robodev-ai/sdk";
+
+export const get = defineApi({
+  response: z.object({ ok: z.literal(true) }),
+  handler: async ({ db, email, storage, env }) => {
+    void db;
+    void email;
+    void storage;
+    void env;
+    return { ok: true as const };
+  },
+});
+```
+
+## Hard rules
+
+- Do not run npm, pnpm, or yarn install.
+- Do not start npm run dev, vite, or any local server.
+- Do not run tsc (node_modules is not installed in this runner).
+- Do not port-scan or curl/fetch localhost.
+- Preview is the WebContainer. Live APIs exist only after `robodev-publish be`.
+- Publish backend after a batch of file edits, not after every file.
+- Do not publish the frontend.
+
+## Backend
+
+- Layout is `robodev/`. `robodev-publish be` maps `robodev/database.ts` → `database.ts` and `robodev/api/**` → `api/**`.
+- Auth: robodev-auth get / set / users / users-delete. Do not invent control-plane HTTP.
+- Secrets: robodev-secret list / set / delete. Use env.NAME in defineApi. List names only.
+- SQL: psql or robodev-sql for DML, SELECT, and seed only. Never print DATABASE_URL. Never run DDL.
+- Publish backend only with robodev-publish be. Do not publish the frontend.
+
+## Frontend
+
+- Route with React Router in `src/`. `src/pages/Home.tsx` is `/`. Add a page by adding a component and a `<Route>` in `src/App.tsx`.
+- Call APIs through the committed orval client under `src/api/generated`. After API changes, update `src/api/openapi.json` and regenerate.
+- UI: shadcn under `src/components/ui`. Hosted compile does not run Tailwind. Keep hosted CSS in `src/app.css`. `tailwind.config.ts` and `postcss.config.js` are for local `shadcn add` / Vite only.
+- Hosted FE packages: `react`, `react-dom`, `react-router-dom`, `@robodev-ai/client`. Do not import other npm packages in `src/` — hosted compile will fail.
+- Preview runs `pnpm install` / `vite --host` from the project root. Do not run those in this runner.
+
+## Allowed paths
+
+`robodev/database.ts`, `robodev/api/**/*.ts`, `robodev/jobs/**/*.ts`, `robodev/sockets/**/*.ts`, `robodev/hooks/**/*.ts`, `robodev/package.json`, `index.html`, `src/**`, `package.json`, `README.md`, `ROBODEV.md`, `.gitignore`.
+
+Never write `.env` or secrets. Never write `.robodev`.

package/templates/shadcn/components.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "tailwind.config.ts",
+    "css": "src/app.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "iconLibrary": "lucide"
+}

package/templates/shadcn/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{NAME}}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/shadcn/orval.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from "orval";
+
+export default defineConfig({
+  api: {
+    input: "src/api/openapi.json",
+    output: {
+      mode: "split",
+      target: "src/api/generated/endpoints.ts",
+      schemas: "src/api/generated/model",
+      client: "fetch",
+      clean: true,
+    },
+  },
+});

package/templates/shadcn/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "{{PACKAGE_NAME}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "robodev dev",
+    "deploy": "robodev deploy",
+    "dev:fe": "vite",
+    "build": "vite build",
+    "generate:api": "orval"
+  },
+  "dependencies": {
+    "@robodev-ai/sdk": "^0.13.0",
+    "@robodev-ai/client": "^0.5.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-router-dom": "^6.30.1"
+  },
+  "devDependencies": {
+    "autoprefixer": "^10.4.21",
+    "orval": "^7.11.2",
+    "postcss": "^8.5.6",
+    "robodev": "^0.47.0",
+    "shadcn": "^2.10.0",
+    "tailwindcss": "^3.4.17",
+    "typescript": "^5.9.2",
+    "vite": "^6.0.0"
+  }
+}

package/templates/shadcn/postcss.config.js

@@ -0,0 +1,6 @@
+export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+};

package/templates/shadcn/robodev/api/health.ts

@@ -0,0 +1,7 @@
+/** GET /api/health — liveness check for the deployed project host. */
+import { defineApi, z } from "@robodev-ai/sdk";
+
+export const get = defineApi({
+  response: z.object({ ok: z.literal(true) }),
+  handler: async () => ({ ok: true as const }),
+});

package/templates/shadcn/robodev/database.ts

@@ -0,0 +1,14 @@
+/**
+ * Placeholder schema. Replace this table or add tables, then `robodev deploy`.
+ */
+import { defineDatabase, pgTable, text, uuid } from "@robodev-ai/sdk";
+
+export const items = pgTable("items", {
+  id: uuid("id").primaryKey().defaultRandom(),
+  name: text("name").notNull(),
+});
+
+export default defineDatabase({
+  name: "app",
+  tables: { items },
+});

package/templates/shadcn/robodev/package.json

@@ -0,0 +1,4 @@
+{
+  "private": true,
+  "dependencies": {}
+}

package/templates/shadcn/src/App.tsx

@@ -0,0 +1,10 @@
+import { Route, Routes } from "react-router-dom";
+import { Home } from "./pages/Home";
+
+export function App() {
+  return (
+    <Routes>
+      <Route path="/" element={<Home />} />
+    </Routes>
+  );
+}

package/templates/shadcn/src/api/generated/endpoints.ts

@@ -0,0 +1,54 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * app
+ * Committed snapshot of Empty GET /api/health.
+ * OpenAPI spec version: 1.0.0
+ */
+import type {
+  HealthResponse
+} from './model';
+
+
+/**
+ * @summary Health
+ */
+export type getHealthResponse200 = {
+  data: HealthResponse
+  status: 200
+}
+    
+export type getHealthResponseSuccess = (getHealthResponse200) & {
+  headers: Headers;
+};
+;
+
+export type getHealthResponse = (getHealthResponseSuccess)
+
+export const getGetHealthUrl = () => {
+
+
+  
+
+  return `/api/health`
+}
+
+export const getHealth = async ( options?: RequestInit): Promise<getHealthResponse> => {
+  
+  const res = await fetch(getGetHealthUrl(),
+  {      
+    ...options,
+    method: 'GET'
+    
+    
+  }
+)
+
+  const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+  
+  const data: getHealthResponse['data'] = body ? JSON.parse(body) : {}
+  return { data, status: res.status, headers: res.headers } as getHealthResponse
+}
+
+
+

package/templates/shadcn/src/api/generated/model/healthResponse.ts

@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * app
+ * Committed snapshot of Empty GET /api/health.
+ * OpenAPI spec version: 1.0.0
+ */
+
+export interface HealthResponse {
+  ok: boolean;
+}

package/templates/shadcn/src/api/generated/model/index.ts

@@ -0,0 +1,9 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * app
+ * Committed snapshot of Empty GET /api/health.
+ * OpenAPI spec version: 1.0.0
+ */
+
+export * from './healthResponse';

package/templates/shadcn/src/api/openapi.json

@@ -0,0 +1,42 @@
+{
+  "openapi": "3.0.3",
+  "info": {
+    "title": "app",
+    "version": "1.0.0",
+    "description": "Committed snapshot of Empty GET /api/health."
+  },
+  "paths": {
+    "/api/health": {
+      "get": {
+        "operationId": "getHealth",
+        "summary": "Health",
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HealthResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "HealthResponse": {
+        "type": "object",
+        "required": ["ok"],
+        "properties": {
+          "ok": {
+            "type": "boolean",
+            "enum": [true]
+          }
+        }
+      }
+    }
+  }
+}

package/templates/shadcn/src/app.css

@@ -0,0 +1,117 @@
+:root {
+  --background: 0 0% 100%;
+  --foreground: 240 10% 3.9%;
+  --primary: 240 5.9% 10%;
+  --primary-foreground: 0 0% 98%;
+  --secondary: 240 4.8% 95.9%;
+  --secondary-foreground: 240 5.9% 10%;
+  --muted: 240 4.8% 95.9%;
+  --muted-foreground: 240 3.8% 46.1%;
+  --accent: 240 4.8% 95.9%;
+  --accent-foreground: 240 5.9% 10%;
+  --destructive: 0 84.2% 60.2%;
+  --destructive-foreground: 0 0% 98%;
+  --border: 240 5.9% 90%;
+  --ring: 240 5.9% 10%;
+  --radius: 0.5rem;
+  color: hsl(var(--foreground));
+  font-family: system-ui, sans-serif;
+}
+
+body {
+  margin: 0;
+  background: hsl(var(--background));
+}
+
+main {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 1rem;
+  padding: 2rem;
+}
+
+.btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.5rem;
+  white-space: nowrap;
+  border-radius: calc(var(--radius) - 2px);
+  font-size: 0.875rem;
+  font-weight: 500;
+  border: 1px solid transparent;
+  cursor: pointer;
+  transition:
+    background-color 0.15s ease,
+    color 0.15s ease,
+    border-color 0.15s ease;
+}
+
+.btn:focus-visible {
+  outline: 2px solid hsl(var(--ring));
+  outline-offset: 2px;
+}
+
+.btn:disabled {
+  pointer-events: none;
+  opacity: 0.5;
+}
+
+.btn-default {
+  background: hsl(var(--primary));
+  color: hsl(var(--primary-foreground));
+}
+
+.btn-default:hover {
+  background: hsl(var(--primary) / 0.9);
+}
+
+.btn-destructive {
+  background: hsl(var(--destructive));
+  color: hsl(var(--destructive-foreground));
+}
+
+.btn-outline {
+  border-color: hsl(var(--border));
+  background: hsl(var(--background));
+  color: hsl(var(--foreground));
+}
+
+.btn-secondary {
+  background: hsl(var(--secondary));
+  color: hsl(var(--secondary-foreground));
+}
+
+.btn-ghost {
+  background: transparent;
+  color: hsl(var(--foreground));
+}
+
+.btn-link {
+  background: transparent;
+  color: hsl(var(--primary));
+  text-decoration: underline;
+  text-underline-offset: 4px;
+}
+
+.btn-size-default {
+  height: 2.25rem;
+  padding: 0 1rem;
+}
+
+.btn-size-sm {
+  height: 2rem;
+  padding: 0 0.75rem;
+}
+
+.btn-size-lg {
+  height: 2.5rem;
+  padding: 0 2rem;
+}
+
+.btn-size-icon {
+  height: 2.25rem;
+  width: 2.25rem;
+  padding: 0;
+}

package/templates/shadcn/src/components/ui/button.tsx

@@ -0,0 +1,39 @@
+import type { ButtonHTMLAttributes } from "react";
+import { cn } from "@/lib/utils";
+
+const variantClasses = {
+  default: "btn btn-default",
+  destructive: "btn btn-destructive",
+  outline: "btn btn-outline",
+  secondary: "btn btn-secondary",
+  ghost: "btn btn-ghost",
+  link: "btn btn-link",
+} as const;
+
+const sizeClasses = {
+  default: "btn-size-default",
+  sm: "btn-size-sm",
+  lg: "btn-size-lg",
+  icon: "btn-size-icon",
+} as const;
+
+export type ButtonProps = ButtonHTMLAttributes<HTMLButtonElement> & {
+  variant?: keyof typeof variantClasses;
+  size?: keyof typeof sizeClasses;
+};
+
+export function Button({
+  className,
+  variant = "default",
+  size = "default",
+  type = "button",
+  ...props
+}: ButtonProps) {
+  return (
+    <button
+      type={type}
+      className={cn(variantClasses[variant], sizeClasses[size], className)}
+      {...props}
+    />
+  );
+}

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

@@ -0,0 +1,3 @@
+export function cn(...inputs: Array<string | false | null | undefined>) {
+  return inputs.filter(Boolean).join(" ");
+}

package/templates/shadcn/src/main.tsx

@@ -0,0 +1,10 @@
+import { createRoot } from "react-dom/client";
+import { BrowserRouter } from "react-router-dom";
+import { App } from "./App";
+import "./app.css";
+
+createRoot(document.getElementById("root")!).render(
+  <BrowserRouter>
+    <App />
+  </BrowserRouter>,
+);

package/templates/shadcn/src/pages/Home.tsx

@@ -0,0 +1,35 @@
+import { useEffect, useState } from "react";
+import { getHealth } from "@/api/generated/endpoints";
+import { Button } from "@/components/ui/button";
+
+export function Home() {
+  const [status, setStatus] = useState("Checking health…");
+
+  async function loadHealth() {
+    try {
+      const result = await getHealth();
+      if (result.status !== 200 || result.data.ok !== true) {
+        setStatus(`Request failed (${result.status})`);
+        return;
+      }
+      setStatus("{ ok: true }");
+    } catch (error) {
+      setStatus(error instanceof Error ? error.message : "Request failed");
+    }
+  }
+
+  useEffect(() => {
+    void loadHealth();
+  }, []);
+
+  return (
+    <main>
+      <h1>Welcome</h1>
+      <p>Your app is ready.</p>
+      <Button type="button" onClick={() => void loadHealth()}>
+        Check health
+      </Button>
+      <p>{status}</p>
+    </main>
+  );
+}

package/templates/shadcn/tailwind.config.ts

@@ -0,0 +1,42 @@
+import type { Config } from "tailwindcss";
+
+export default {
+  darkMode: ["class"],
+  content: ["./index.html", "./src/**/*.{ts,tsx}"],
+  theme: {
+    extend: {
+      borderRadius: {
+        lg: "var(--radius)",
+        md: "calc(var(--radius) - 2px)",
+        sm: "calc(var(--radius) - 4px)",
+      },
+      colors: {
+        background: "hsl(var(--background))",
+        foreground: "hsl(var(--foreground))",
+        primary: {
+          DEFAULT: "hsl(var(--primary))",
+          foreground: "hsl(var(--primary-foreground))",
+        },
+        secondary: {
+          DEFAULT: "hsl(var(--secondary))",
+          foreground: "hsl(var(--secondary-foreground))",
+        },
+        muted: {
+          DEFAULT: "hsl(var(--muted))",
+          foreground: "hsl(var(--muted-foreground))",
+        },
+        accent: {
+          DEFAULT: "hsl(var(--accent))",
+          foreground: "hsl(var(--accent-foreground))",
+        },
+        destructive: {
+          DEFAULT: "hsl(var(--destructive))",
+          foreground: "hsl(var(--destructive-foreground))",
+        },
+        border: "hsl(var(--border))",
+        ring: "hsl(var(--ring))",
+      },
+    },
+  },
+  plugins: [],
+} satisfies Config;

package/templates/shadcn/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["robodev/**/*.ts", "src"]
+}

package/templates/shadcn/vite.config.ts

@@ -0,0 +1,20 @@
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { defineConfig } from "vite";
+
+const root = dirname(fileURLToPath(import.meta.url));
+
+export default defineConfig({
+  esbuild: { jsx: "automatic" },
+  resolve: {
+    alias: {
+      "@": resolve(root, "src"),
+    },
+  },
+  server: {
+    proxy: {
+      "/api": "http://localhost:4000",
+      "/openapi.json": "http://localhost:4000",
+    },
+  },
+});