@farm.js/create-app 0.1.0-beta.87 → 0.1.0-beta.88

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farm.js/create-app",
-  "version": "0.1.0-beta.87",
+  "version": "0.1.0-beta.88",
   "description": "Create a new FARMJS application",
   "keywords": [
     "@farm.js/create-app",

package/templates/_integrations/better-auth/preact/farm.config.ts

@@ -11,6 +11,9 @@ export default defineConfig({
   integrations: {
     auth: betterAuth({ instance: auth }),
   },
+  migrations: {
+    commands: [{ name: "Better Auth schema", command: "pnpm auth:migrate" }],
+  },
   deploy: {
     target: "vercel",
   },

package/templates/_integrations/better-auth/solid/farm.config.ts

@@ -11,6 +11,9 @@ export default defineConfig({
   integrations: {
     auth: betterAuth({ instance: auth }),
   },
+  migrations: {
+    commands: [{ name: "Better Auth schema", command: "pnpm auth:migrate" }],
+  },
   deploy: {
     target: "vercel",
   },

package/templates/_integrations/better-auth/svelte/farm.config.ts

@@ -11,6 +11,9 @@ export default defineConfig({
   integrations: {
     auth: betterAuth({ instance: auth }),
   },
+  migrations: {
+    commands: [{ name: "Better Auth schema", command: "pnpm auth:migrate" }],
+  },
   deploy: {
     target: "vercel",
   },

package/templates/_integrations/better-auth/svelte/src/components/resource-links.svelte

@@ -16,7 +16,7 @@
   {/if}
   <span class="resource-link-item">
     {#if primary}<span class="resource-separator" aria-hidden="true">/</span>{/if}
-    <a href="https://farm.js.dev">
+    <a href="https://farmjs.dev">
       <svg
         class="resource-icon"
         viewBox="0 0 24 24"

package/templates/_integrations/better-auth/vue/farm.config.ts

@@ -11,6 +11,9 @@ export default defineConfig({
   integrations: {
     auth: betterAuth({ instance: auth }),
   },
+  migrations: {
+    commands: [{ name: "Better Auth schema", command: "pnpm auth:migrate" }],
+  },
   deploy: {
     target: "vercel",
   },

package/templates/_integrations/better-auth/vue/src/components/resource-links.vue

@@ -11,7 +11,7 @@ defineProps<{
     </span>
     <span class="resource-link-item">
       <span v-if="primary" class="resource-separator" aria-hidden="true">/</span>
-      <a href="https://farm.js.dev">
+      <a href="https://farmjs.dev">
         <svg
           class="resource-icon"
           viewBox="0 0 24 24"

package/templates/_renderers/preact/package.json

@@ -10,7 +10,7 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@farm.js/core": "0.1.0-beta.87",
+    "@farm.js/core": "0.1.0-beta.88",
     "@farm.js/preact": "0.1.0-beta.31",
     "@fontsource-variable/geist": "5.3.0",
     "@fontsource-variable/geist-mono": "5.3.0",
@@ -18,7 +18,7 @@
     "zod": "4.1.12"
   },
   "devDependencies": {
-    "@farm.js/cli": "0.1.0-beta.87",
+    "@farm.js/cli": "0.1.0-beta.88",
     "tailwindcss": "^4.0.0",
     "typescript": "^5.3.3"
   },

package/templates/_renderers/preact/src/components/resource-links.tsx

@@ -54,7 +54,7 @@ export function ResourceLinks({ className, primary }: ResourceLinksProps) {
       ) : null}
       <span className="resource-link-item">
         {primary ? <ResourceSeparator /> : null}
-        <a href="https://farm.js.dev">
+        <a href="https://farmjs.dev">
           <DocsIcon />
           <span>Docs</span>
         </a>

package/templates/_renderers/solid/package.json

@@ -9,7 +9,7 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@farm.js/core": "0.1.0-beta.87",
+    "@farm.js/core": "0.1.0-beta.88",
     "@farm.js/solid": "0.1.0-beta.27",
     "@fontsource-variable/geist": "5.3.0",
     "@fontsource-variable/geist-mono": "5.3.0",
@@ -17,7 +17,7 @@
     "zod": "4.1.12"
   },
   "devDependencies": {
-    "@farm.js/cli": "0.1.0-beta.87",
+    "@farm.js/cli": "0.1.0-beta.88",
     "tailwindcss": "^4.0.0",
     "typescript": "^5.3.3"
   },

package/templates/_renderers/solid/src/components/resource-links.tsx

@@ -54,7 +54,7 @@ export function ResourceLinks(props: ResourceLinksProps) {
       ) : null}
       <span class="resource-link-item">
         {props.primary ? <ResourceSeparator /> : null}
-        <a href="https://farm.js.dev">
+        <a href="https://farmjs.dev">
           <DocsIcon />
           <span>Docs</span>
         </a>

package/templates/_renderers/svelte/package.json

@@ -11,7 +11,7 @@
     "type-check": "svelte-check --tsconfig ./tsconfig.json"
   },
   "dependencies": {
-    "@farm.js/core": "0.1.0-beta.87",
+    "@farm.js/core": "0.1.0-beta.88",
     "@farm.js/svelte": "0.1.0-beta.30",
     "@fontsource-variable/geist": "5.3.0",
     "@fontsource-variable/geist-mono": "5.3.0",
@@ -19,7 +19,7 @@
     "zod": "4.1.12"
   },
   "devDependencies": {
-    "@farm.js/cli": "0.1.0-beta.87",
+    "@farm.js/cli": "0.1.0-beta.88",
     "svelte-check": "4.7.5",
     "tailwindcss": "^4.0.0",
     "typescript": "^5.3.3"

package/templates/_renderers/svelte/src/components/resource-links.svelte

@@ -1,6 +1,6 @@
 <nav aria-label="Starter resources">
   <span class="resource-link-item">
-    <a href="https://farm.js.dev">
+    <a href="https://farmjs.dev">
       <svg
         class="resource-icon"
         viewBox="0 0 24 24"

package/templates/_renderers/vue/package.json

@@ -9,7 +9,7 @@
     "type-check": "vue-tsc --noEmit"
   },
   "dependencies": {
-    "@farm.js/core": "0.1.0-beta.87",
+    "@farm.js/core": "0.1.0-beta.88",
     "@farm.js/vue": "0.1.0-beta.27",
     "@fontsource-variable/geist": "5.3.0",
     "@fontsource-variable/geist-mono": "5.3.0",
@@ -17,7 +17,7 @@
     "zod": "4.1.12"
   },
   "devDependencies": {
-    "@farm.js/cli": "0.1.0-beta.87",
+    "@farm.js/cli": "0.1.0-beta.88",
     "tailwindcss": "^4.0.0",
     "typescript": "^5.3.3",
     "vue-tsc": "3.3.9"

package/templates/_renderers/vue/src/components/resource-links.vue

@@ -1,7 +1,7 @@
 <template>
   <nav aria-label="Starter resources">
     <span class="resource-link-item">
-      <a href="https://farm.js.dev">
+      <a href="https://farmjs.dev">
         <svg
           class="resource-icon"
           viewBox="0 0 24 24"

package/templates/auth/package.json

@@ -11,8 +11,8 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@farm.js/auth": "0.1.0-beta.87",
-    "@farm.js/core": "0.1.0-beta.87",
+    "@farm.js/auth": "0.1.0-beta.88",
+    "@farm.js/core": "0.1.0-beta.88",
     "@farming-labs/docs": "0.2.111",
     "@farming-labs/farmjs": "0.2.111",
     "@farming-labs/theme": "0.2.111",
@@ -23,7 +23,7 @@
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@farm.js/cli": "0.1.0-beta.87",
+    "@farm.js/cli": "0.1.0-beta.88",
     "@types/node": "22.20.1",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",

package/templates/auth/src/app/docs/page.md

@@ -25,5 +25,5 @@ manual wiring required.
 
 ## Learn more
 
-- [Farm.js documentation](https://farm.js.dev/docs)
-- [Configuration guide](https://farm.js.dev/docs/configuration)
+- [Farm.js documentation](https://farmjs.dev/docs)
+- [Configuration guide](https://farmjs.dev/docs/configuration)

package/templates/auth/src/components/resource-links.tsx

@@ -61,7 +61,7 @@ export function ResourceLinks({ className, primary }: ResourceLinksProps) {
       ) : null}
       <span className="resource-link-item">
         {primary ? <ResourceSeparator /> : null}
-        <a href="https://farm.js.dev">
+        <a href="https://farmjs.dev">
           <DocsIcon />
           <span>Docs</span>
         </a>

package/templates/auth/src/components/site-header.tsx

@@ -21,7 +21,7 @@ export function SiteHeader({ user }: SiteHeaderProps) {
       </a>
 
       <nav className="header-nav" aria-label="Primary navigation">
-        <a href="https://farm.js.dev">Docs</a>
+        <a href="https://farmjs.dev">Docs</a>
         {user ? (
           <a className="header-account" href="/dashboard">
             <span className="avatar" aria-hidden="true">

package/templates/basic/package.json

@@ -9,7 +9,7 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@farm.js/core": "0.1.0-beta.87",
+    "@farm.js/core": "0.1.0-beta.88",
     "@farming-labs/docs": "0.2.111",
     "@farming-labs/farmjs": "0.2.111",
     "@farming-labs/theme": "0.2.111",
@@ -19,7 +19,7 @@
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@farm.js/cli": "0.1.0-beta.87",
+    "@farm.js/cli": "0.1.0-beta.88",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "tailwindcss": "^4.0.0",

package/templates/basic/src/app/docs/page.md

@@ -25,5 +25,5 @@ manual wiring required.
 
 ## Learn more
 
-- [Farm.js documentation](https://farm.js.dev/docs)
-- [Configuration guide](https://farm.js.dev/docs/configuration)
+- [Farm.js documentation](https://farmjs.dev/docs)
+- [Configuration guide](https://farmjs.dev/docs/configuration)

package/templates/basic/src/components/resource-links.tsx

@@ -61,7 +61,7 @@ export function ResourceLinks({ className, primary }: ResourceLinksProps) {
       ) : null}
       <span className="resource-link-item">
         {primary ? <ResourceSeparator /> : null}
-        <a href="https://farm.js.dev">
+        <a href="https://farmjs.dev">
           <DocsIcon />
           <span>Docs</span>
         </a>

package/templates/better-auth/README.md

@@ -10,7 +10,7 @@ This project was generated from the Better Auth template included with `@farm.js
 - email and password sign-up and sign-in
 - Better Auth session cookies
 - a server-middleware-protected `/dashboard`
-- pooled Postgres persistence and automatic Better Auth migrations
+- pooled Postgres persistence and explicit Better Auth migrations
 - a dark-first, one-page welcome screen set in Geist Sans and Geist Mono
 - pending, error, unauthorized, loading, and not-found states
 - responsive starter UI
@@ -34,6 +34,7 @@ Then install and start the app:
 
 ```bash
 pnpm install
+pnpm auth:migrate
 pnpm dev
 ```
 
@@ -41,8 +42,9 @@ Open [http://localhost:3000](http://localhost:3000), create an account, and cont
 
 ## How it is wired
 
-- [`src/lib/auth.ts`](./src/lib/auth.ts) creates the Better Auth instance, configures the pooled
-  Postgres connection, and runs programmatic migrations.
+- [`src/lib/auth.ts`](./src/lib/auth.ts) creates the Better Auth instance and configures the pooled
+  Postgres connection without touching the database during a build.
+- [`src/lib/migrate-auth.ts`](./src/lib/migrate-auth.ts) runs schema migrations only when requested.
 - [`farm.config.ts`](./farm.config.ts) mounts that instance through `@farm.js/better-auth`.
 - [`src/lib/auth-client.ts`](./src/lib/auth-client.ts) exposes the browser client.
 - [`src/lib/session.ts`](./src/lib/session.ts) resolves the current request session on the server.
@@ -72,12 +74,16 @@ The starter uses `pg` with a small connection pool suitable for a pooled Neon en
 `DATABASE_URL`, `BETTER_AUTH_SECRET`, and the production `BETTER_AUTH_URL` to your deployment
 environment before building.
 
+Run `pnpm auth:migrate` (or `farm migrate`) as an explicit deployment step before serving traffic.
+The production build itself never runs database migrations.
+
 The FARMJS deployment target is configured in [`farm.config.ts`](./farm.config.ts) for Vercel.
 
 ## Commands
 
 ```bash
 pnpm dev         # start the development server
+pnpm auth:migrate # apply Better Auth database migrations
 pnpm type-check  # run TypeScript checks
 pnpm build       # create the production build
 pnpm check       # type-check and build

package/templates/better-auth/farm.config.ts

@@ -16,6 +16,14 @@ export default defineConfig({
   experimental: {
     serverComponents: true,
   },
+  migrations: {
+    commands: [
+      {
+        name: "Better Auth schema",
+        command: "pnpm auth:migrate",
+      },
+    ],
+  },
   vite: {
     server: {
       port: 3000,

package/templates/better-auth/package.json

@@ -5,13 +5,14 @@
   "scripts": {
     "dev": "farm dev",
     "build": "farm build",
+    "auth:migrate": "node --experimental-strip-types src/lib/migrate-auth.ts",
     "check": "pnpm type-check && pnpm build",
     "deploy": "farm deploy",
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@farm.js/better-auth": "0.1.0-beta.87",
-    "@farm.js/core": "0.1.0-beta.87",
+    "@farm.js/better-auth": "0.1.0-beta.88",
+    "@farm.js/core": "0.1.0-beta.88",
     "@farming-labs/docs": "0.2.111",
     "@farming-labs/farmjs": "0.2.111",
     "@farming-labs/theme": "0.2.111",
@@ -24,7 +25,7 @@
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@farm.js/cli": "0.1.0-beta.87",
+    "@farm.js/cli": "0.1.0-beta.88",
     "@types/node": "22.20.1",
     "@types/pg": "8.20.0",
     "@types/react": "^19.0.0",

package/templates/better-auth/src/app/docs/page.md

@@ -25,5 +25,5 @@ manual wiring required.
 
 ## Learn more
 
-- [Farm.js documentation](https://farm.js.dev/docs)
-- [Configuration guide](https://farm.js.dev/docs/configuration)
+- [Farm.js documentation](https://farmjs.dev/docs)
+- [Configuration guide](https://farmjs.dev/docs/configuration)

package/templates/better-auth/src/components/resource-links.tsx

@@ -61,7 +61,7 @@ export function ResourceLinks({ className, primary }: ResourceLinksProps) {
       ) : null}
       <span className="resource-link-item">
         {primary ? <ResourceSeparator /> : null}
-        <a href="https://farm.js.dev">
+        <a href="https://farmjs.dev">
           <DocsIcon />
           <span>Docs</span>
         </a>

package/templates/better-auth/src/components/site-header.tsx

@@ -21,7 +21,7 @@ export function SiteHeader({ user }: SiteHeaderProps) {
       </a>
 
       <nav className="header-nav" aria-label="Primary navigation">
-        <a href="https://farm.js.dev">Docs</a>
+        <a href="https://farmjs.dev">Docs</a>
         {user ? (
           <a className="header-account" href="/dashboard">
             <span className="avatar" aria-hidden="true">

package/templates/better-auth/src/lib/auth.ts

@@ -1,5 +1,4 @@
 import { betterAuth } from "better-auth";
-import { getMigrations } from "better-auth/db/migration";
 import { Pool, type PoolConfig } from "pg";
 
 const authBaseUrl = process.env.BETTER_AUTH_URL ?? "http://localhost:3000";
@@ -32,12 +31,12 @@ const poolConfig: PoolConfig & { enableChannelBinding: boolean } = {
   allowExitOnIdle: true,
 };
 
-const database = new Pool(poolConfig);
+export const authDatabase = new Pool(poolConfig);
 
 export const auth = betterAuth({
   appName: "FARMJS Better Auth Starter",
   baseURL: authBaseUrl,
-  database,
+  database: authDatabase,
   emailAndPassword: {
     enabled: true,
     minPasswordLength: 8,
@@ -45,6 +44,3 @@ export const auth = betterAuth({
   secret,
   trustedOrigins: [new URL(authBaseUrl).origin],
 });
-
-const migrations = await getMigrations(auth.options);
-await migrations.runMigrations();

package/templates/better-auth/src/lib/migrate-auth.ts

@@ -0,0 +1,10 @@
+import { getMigrations } from "better-auth/db/migration";
+import { auth, authDatabase } from "./auth.ts";
+
+try {
+  const migrations = await getMigrations(auth.options);
+  await migrations.runMigrations();
+  console.log("Better Auth migrations completed.");
+} finally {
+  await authDatabase.end();
+}

package/templates/react-compiler/README.md

@@ -58,5 +58,5 @@ For batching, multiple bindings, safe keyed-list fallback, and the full compiler
 see the maintained
 [React Compiler example](https://github.com/farming-labs/farm.js/tree/main/examples/react-compiler).
 
-Read the [React compiler guide](https://farm.js.dev/docs/renderers/react#experimental-aot-compiler)
+Read the [React compiler guide](https://farmjs.dev/docs/renderers/react#experimental-aot-compiler)
 for the supported component contract and rollout guidance.

package/templates/react-compiler/package.json

@@ -11,7 +11,7 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@farm.js/core": "0.1.0-beta.87",
+    "@farm.js/core": "0.1.0-beta.88",
     "@farm.js/react": "0.1.0-beta.8",
     "@farming-labs/docs": "0.2.111",
     "@farming-labs/farmjs": "0.2.111",
@@ -22,7 +22,7 @@
     "react-dom": "19.2.8"
   },
   "devDependencies": {
-    "@farm.js/cli": "0.1.0-beta.87",
+    "@farm.js/cli": "0.1.0-beta.88",
     "@playwright/test": "^1.52.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",

package/templates/react-compiler/src/app/docs/page.md

@@ -25,5 +25,5 @@ manual wiring required.
 
 ## Learn more
 
-- [Farm.js documentation](https://farm.js.dev/docs)
-- [Configuration guide](https://farm.js.dev/docs/configuration)
+- [Farm.js documentation](https://farmjs.dev/docs)
+- [Configuration guide](https://farmjs.dev/docs/configuration)

package/templates/react-compiler/src/components/resource-links.tsx

@@ -61,7 +61,7 @@ export function ResourceLinks({ className, primary }: ResourceLinksProps) {
       ) : null}
       <span className="resource-link-item">
         {primary ? <ResourceSeparator /> : null}
-        <a href="https://farm.js.dev">
+        <a href="https://farmjs.dev">
           <DocsIcon />
           <span>Docs</span>
         </a>