@proofkit/cli 2.0.0-beta.22 → 2.0.0-beta.24

package/template/nextjs-mantine/AGENTS.md

@@ -0,0 +1 @@
+__AGENT_INSTRUCTIONS__

package/template/nextjs-mantine/package.json

@@ -6,8 +6,8 @@
     "dev": "next dev --turbopack",
     "build": "next build",
     "start": "next start",
-    "lint": "biome check",
-    "format": "biome format --write",
+    "lint": "ultracite check .",
+    "format": "ultracite fix .",
     "proofkit": "proofkit",
     "typegen": "proofkit typegen",
     "deploy": "proofkit deploy"
@@ -35,7 +35,6 @@
     "@types/node": "^20",
     "@types/react": "npm:types-react@19.0.12",
     "@types/react-dom": "npm:types-react-dom@19.0.4",
-    "@biomejs/biome": "2.3.11",
     "postcss": "^8.4.41",
     "ultracite": "7.0.8",
     "postcss-preset-mantine": "^1.17.0",

package/template/nextjs-shadcn/AGENTS.md

@@ -0,0 +1 @@
+__AGENT_INSTRUCTIONS__

package/template/nextjs-shadcn/package.json

@@ -7,8 +7,8 @@
     "build": "next build --turbopack",
     "proofkit": "proofkit",
     "start": "next start",
-    "lint": "biome check",
-    "format": "biome format --write"
+    "lint": "ultracite check .",
+    "format": "ultracite fix ."
   },
   "dependencies": {
     "@radix-ui/react-slot": "^1.2.3",
@@ -25,7 +25,6 @@
     "tailwind-merge": "^3.3.1"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.3.11",
     "@tailwindcss/postcss": "^4",
     "@types/node": "^22",
     "@types/react": "^19",
@@ -33,6 +32,6 @@
     "tailwindcss": "^4",
     "tw-animate-css": "^1.3.7",
     "typescript": "^5",
-    "ultracite": "5.4.5"
+    "ultracite": "7.0.8"
   }
 }

package/template/vite-wv/.claude/launch.json

@@ -0,0 +1,18 @@
+{
+  "configurations": [
+    {
+      "name": "Preview",
+      "runtimeExecutable": "__PACKAGE_MANAGER__",
+      "runtimeArgs": ["run", "dev"],
+      "cwd": "${workspaceFolder}",
+      "autoPort": true,
+      "port": 5175
+    },
+    {
+      "name": "Typegen",
+      "runtimeExecutable": "__PACKAGE_MANAGER__",
+      "runtimeArgs": ["run", "typegen"],
+      "cwd": "${workspaceFolder}"
+    }
+  ]
+}

package/template/vite-wv/AGENTS.md

@@ -0,0 +1 @@
+__AGENT_INSTRUCTIONS__

package/template/vite-wv/package.json

@@ -14,15 +14,16 @@
     "typegen": "typegen",
     "typegen:ui": "typegen ui",
     "upload": "node ./scripts/upload.js",
-    "lint": "biome check .",
-    "format": "biome format --write ."
+    "lint": "ultracite check .",
+    "format": "ultracite fix ."
   },
   "dependencies": {
+    "@tanstack/react-query": "^5.90.21",
+    "@tanstack/react-router": "^1.167.4",
     "react": "^19.2.4",
     "react-dom": "^19.2.4"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.4.7",
     "@proofkit/typegen": "^1.1.0-beta.16",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
@@ -30,6 +31,7 @@
     "dotenv": "^17.3.1",
     "open": "^11.0.0",
     "typescript": "^5.9.3",
+    "ultracite": "7.0.8",
     "vite": "^7.3.1",
     "vite-plugin-singlefile": "^2.3.2"
   }

package/template/vite-wv/proofkit-typegen.config.jsonc

@@ -7,7 +7,7 @@
     "clientSuffix": "Layout",
     "validator": "zod/v4",
     "webviewerScriptName": "ExecuteDataApi",
-    "fmHttp": {
+    "fmMcp": {
       "enabled": true
     },
     "layouts": [

package/template/vite-wv/scripts/filemaker.js

@@ -7,13 +7,13 @@ const envPath = resolve(currentDirectory, "../.env");
 
 dotenv.config({ path: envPath });
 
-const defaultFmHttpBaseUrl = process.env.FM_HTTP_BASE_URL ?? "http://127.0.0.1:1365";
+const defaultFmMcpBaseUrl = process.env.FM_MCP_BASE_URL ?? "http://127.0.0.1:1365";
 
 function stripFileExtension(fileName) {
   return fileName.replace(/\.fmp12$/i, "");
 }
 
-async function getConnectedFiles(baseUrl = defaultFmHttpBaseUrl) {
+async function getConnectedFiles(baseUrl = defaultFmMcpBaseUrl) {
   const healthResponse = await fetch(`${baseUrl}/health`).catch(() => null);
   if (!healthResponse?.ok) {
     return [];
@@ -40,13 +40,13 @@ export async function resolveFileMakerTarget() {
       return {
         fileName: stripFileExtension(matches[0]),
         host: "$",
-        source: "fm-http",
+        source: "fm-mcp",
       };
     }
 
     if (connectedFiles.length > 0) {
       throw new Error(
-        `FM_DATABASE is set to "${process.env.FM_DATABASE}" but no matching connected file was found via FM HTTP.`,
+        `FM_DATABASE is set to "${process.env.FM_DATABASE}" but no matching connected file was found via FM MCP.`,
       );
     }
   }
@@ -55,13 +55,13 @@ export async function resolveFileMakerTarget() {
     return {
       fileName: stripFileExtension(connectedFiles[0]),
       host: "$",
-      source: "fm-http",
+      source: "fm-mcp",
     };
   }
 
   if (connectedFiles.length > 1) {
     throw new Error(
-      `Multiple FileMaker files are connected via FM HTTP (${connectedFiles.join(", ")}). Set FM_DATABASE to choose one.`,
+      `Multiple FileMaker files are connected via FM MCP (${connectedFiles.join(", ")}). Set FM_DATABASE to choose one.`,
     );
   }
 

package/template/vite-wv/scripts/launch-fm.js

@@ -5,7 +5,7 @@ const target = await resolveFileMakerTarget();
 
 if (!target) {
   console.error(
-    "Could not resolve a FileMaker file. Start the local FM HTTP proxy with a connected file, or set FM_SERVER and FM_DATABASE in .env.",
+    "Could not resolve a FileMaker file. Start the local FM MCP proxy with a connected file, or set FM_SERVER and FM_DATABASE in .env.",
   );
   process.exit(1);
 }

package/template/vite-wv/scripts/upload.js

@@ -9,7 +9,7 @@ const target = await resolveFileMakerTarget();
 
 if (!target) {
   console.error(
-    "Could not resolve a FileMaker file. Start the local FM HTTP proxy with a connected file, or set FM_SERVER and FM_DATABASE in .env.",
+    "Could not resolve a FileMaker file. Start the local FM MCP proxy with a connected file, or set FM_SERVER and FM_DATABASE in .env.",
   );
   process.exit(1);
 }

package/template/vite-wv/src/App.tsx

@@ -14,7 +14,7 @@ const steps: readonly Step[] = [
   {
     icon: Database,
     title: "Connect FileMaker later",
-    body: "This starter renders safely in a normal browser. When you are ready, wire in FM HTTP or hosted FileMaker setup with ProofKit commands.",
+    body: "This starter renders safely in a normal browser. When you are ready, wire in FM MCP or hosted FileMaker setup with ProofKit commands.",
   },
   {
     icon: Layers,
@@ -30,7 +30,7 @@ const steps: readonly Step[] = [
 
 export default function App() {
   return (
-    <main className="min-h-screen bg-background text-foreground">
+    <main>
       <div className="mx-auto flex min-h-screen w-full max-w-5xl flex-col px-6 py-10 sm:px-10">
         <div className="mb-10 flex-1">
           <div className="inline-flex items-center gap-2 rounded-full border border-border bg-card px-3 py-1 text-sm text-muted-foreground shadow-sm">
@@ -48,7 +48,7 @@ export default function App() {
               </h1>
               <p className="mt-6 max-w-2xl text-lg leading-8 text-muted-foreground">
                 This starter stays intentionally small, but it is already ready for Tailwind v4, shadcn component
-                installs, and later ProofKit typegen output.
+                installs, hash-based TanStack Router navigation, React Query, and later ProofKit typegen output.
               </p>
 
               <div className="mt-8 flex flex-wrap gap-3 text-sm">
@@ -63,7 +63,7 @@ export default function App() {
               <div className="mt-5 space-y-4 text-sm text-muted-foreground">
                 <p>Update the default WebViewer name in <code>src/App.tsx</code> to match your FileMaker layout object.</p>
                 <p>When the app runs inside FileMaker, you can start using <code>fmFetch</code> or generated clients right away.</p>
-                <p>The local helper scripts prefer FM HTTP connected files before falling back to hosted server env vars.</p>
+                <p>The local helper scripts prefer FM MCP connected files before falling back to hosted server env vars.</p>
               </div>
             </aside>
           </div>

package/template/vite-wv/src/main.tsx

@@ -1,7 +1,11 @@
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { RouterProvider } from "@tanstack/react-router";
 import React from "react";
 import ReactDOM from "react-dom/client";
-import App from "./App";
 import "./index.css";
+import { router } from "./router";
+
+const queryClient = new QueryClient();
 
 const rootElement = document.getElementById("root");
 if (!rootElement) {
@@ -10,6 +14,8 @@ if (!rootElement) {
 
 ReactDOM.createRoot(rootElement).render(
   <React.StrictMode>
-    <App />
+    <QueryClientProvider client={queryClient}>
+      <RouterProvider router={router} />
+    </QueryClientProvider>
   </React.StrictMode>,
 );

package/template/vite-wv/src/router.tsx

@@ -0,0 +1,57 @@
+import {
+  Link,
+  Outlet,
+  createHashHistory,
+  createRootRoute,
+  createRoute,
+  createRouter,
+} from "@tanstack/react-router";
+import App from "./App";
+import { QueryDemoPage } from "./routes/query-demo";
+
+const rootRoute = createRootRoute({
+  component: RootLayout,
+});
+
+const indexRoute = createRoute({
+  getParentRoute: () => rootRoute,
+  path: "/",
+  component: App,
+});
+
+const queryDemoRoute = createRoute({
+  getParentRoute: () => rootRoute,
+  path: "/query",
+  component: QueryDemoPage,
+});
+
+const routeTree = rootRoute.addChildren([indexRoute, queryDemoRoute]);
+
+export const router = createRouter({
+  routeTree,
+  history: createHashHistory(),
+});
+
+declare module "@tanstack/react-router" {
+  interface Register {
+    router: typeof router;
+  }
+}
+
+function RootLayout() {
+  return (
+    <div className="min-h-screen bg-background text-foreground">
+      <header className="border-b border-border bg-card/80">
+        <nav className="mx-auto flex w-full max-w-5xl items-center gap-4 px-6 py-3 sm:px-10">
+          <Link className="[&.active]:text-primary text-sm font-medium text-muted-foreground" to="/">
+            Starter
+          </Link>
+          <Link className="[&.active]:text-primary text-sm font-medium text-muted-foreground" to="/query">
+            Query Demo
+          </Link>
+        </nav>
+      </header>
+      <Outlet />
+    </div>
+  );
+}

package/template/vite-wv/src/routes/query-demo.tsx

@@ -0,0 +1,37 @@
+import { useQuery } from "@tanstack/react-query";
+import { Link } from "@tanstack/react-router";
+
+const getConnectionHint = async (): Promise<string> => {
+  await new Promise((resolve) => setTimeout(resolve, 180));
+  return "Use fmFetch or generated clients once your FileMaker file is ready.";
+};
+
+export function QueryDemoPage() {
+  const hintQuery = useQuery({
+    queryKey: ["starter-connection-hint"],
+    queryFn: getConnectionHint,
+  });
+
+  return (
+    <main className="mx-auto w-full max-w-5xl px-6 py-10 sm:px-10">
+      <section className="rounded-3xl border border-border bg-card p-8 shadow-sm">
+        <p className="text-sm font-medium uppercase tracking-[0.2em] text-muted-foreground">React Query ready</p>
+        <h1 className="mt-4 text-3xl font-semibold tracking-tight">TanStack Query is preconfigured</h1>
+        <p className="mt-4 text-muted-foreground">
+          This route is rendered by TanStack Router using hash history, which is recommended for FileMaker WebViewer
+          apps.
+        </p>
+
+        <div className="mt-6 rounded-xl border border-border bg-background p-4 text-sm">
+          {hintQuery.isLoading ? "Loading starter data..." : hintQuery.data}
+        </div>
+
+        <div className="mt-6">
+          <Link className="inline-flex rounded-full border border-border bg-card px-4 py-2 text-sm font-medium" to="/">
+            Back to starter
+          </Link>
+        </div>
+      </section>
+    </main>
+  );
+}

package/dist/index-JtcdNmdz.d.ts

@@ -1 +0,0 @@
-export {};