@farm.js/create-app 0.1.0-beta.9 → 0.1.0-beta.91

package/templates/react-compiler/docs.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://docs.farming-labs.dev/schema/docs.json",
+  "version": 1,
+  "entry": "docs",
+  "docsPath": "/docs",
+  "docs": {
+    "mode": "framework",
+    "runtime": "farm",
+    "root": "."
+  },
+  "content": {
+    "docsRoot": "src/app/docs"
+  },
+  "site": {
+    "name": "Farm App Docs"
+  },
+  "metadata": {
+    "description": "Documentation for your Farm.js app."
+  },
+  "nav": {
+    "title": "Farm App",
+    "url": "/"
+  },
+  "search": {
+    "provider": "simple",
+    "enabled": true,
+    "maxResults": 12
+  },
+  "llmsTxt": {
+    "enabled": true,
+    "siteTitle": "Farm App Docs",
+    "siteDescription": "Documentation for your Farm.js app."
+  },
+  "sitemap": true,
+  "robots": true
+}

package/templates/react-compiler/farm.config.ts

@@ -0,0 +1,29 @@
+import { defineConfig } from "@farm.js/core";
+import { react } from "@farm.js/react";
+
+const compilerEnabled = process.env.FARM_REACT_COMPILER !== "false";
+
+export default defineConfig({
+  env: {
+    public: {
+      FARM_REACT_COMPILER_ENABLED: () => compilerEnabled,
+    },
+  },
+  renderer: react({
+    experimental: {
+      compiler: compilerEnabled,
+    },
+  }),
+  theme: {
+    default: "dark",
+  },
+  // Docs are powered by the @farming-labs/farmjs framework. Farm auto-detects
+  // the installed adapter and reads docs.config.ts (docs.json is kept as a
+  // language-agnostic fallback/manifest); content lives in src/app/docs.
+  docs: {
+    enabled: true,
+  },
+  deploy: {
+    target: "node",
+  },
+});

package/templates/react-compiler/gitignore

@@ -0,0 +1,23 @@
+# Dependencies
+node_modules/
+
+# Farm and deployment output
+.farm/
+.output/
+.vercel/
+dist/
+
+# Local environment files
+.env
+.env.local
+.env.*.local
+
+# Local databases
+*.sqlite
+*.sqlite-*
+*.db
+*.db-*
+
+# Logs and TypeScript cache
+*.log
+*.tsbuildinfo

package/templates/react-compiler/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "farmjs-react-compiler-starter",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "farm dev",
+    "build": "farm build",
+    "start": "farm start",
+    "experiment": "pnpm run build && node scripts/verify-experiment.mjs",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@farm.js/core": "0.1.0-beta.91",
+    "@farm.js/react": "0.1.0-beta.8",
+    "@farming-labs/docs": "0.2.111",
+    "@farming-labs/farmjs": "0.2.111",
+    "@farming-labs/theme": "0.2.111",
+    "@fontsource-variable/geist": "5.3.0",
+    "@fontsource-variable/geist-mono": "5.3.0",
+    "react": "19.2.8",
+    "react-dom": "19.2.8"
+  },
+  "devDependencies": {
+    "@farm.js/cli": "0.1.0-beta.91",
+    "@playwright/test": "^1.52.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "tailwindcss": "^4.0.0",
+    "typescript": "^5.3.3",
+    "vite": "^5.0.10"
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "packageManager": "pnpm@8.12.1"
+}

package/templates/react-compiler/pnpm-workspace.yaml

@@ -0,0 +1,8 @@
+packages:
+  - "."
+
+allowBuilds:
+  "@prisma/client": true
+  esbuild: true
+  sharp: true
+  vue-demi: true

package/templates/react-compiler/public/favicon.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-labelledby="title">
+  <title id="title">FARMJS React AOT</title>
+  <rect width="64" height="64" rx="14" fill="#0a0a09"/>
+  <path d="M18 16h30v8H28v8h17v8H28v16H18z" fill="#b8ff5b"/>
+</svg>

package/templates/react-compiler/scripts/verify-experiment.mjs

@@ -0,0 +1,113 @@
+import assert from "node:assert/strict";
+import { spawn } from "node:child_process";
+import { access } from "node:fs/promises";
+import path from "node:path";
+import { chromium } from "@playwright/test";
+
+const port = Number(process.env.FARM_EXPERIMENT_PORT || 4327);
+const origin = `http://127.0.0.1:${port}`;
+const compilerEnabled = process.env.FARM_REACT_COMPILER !== "false";
+const serverEntry = path.resolve(".farm/.output/server/index.mjs");
+const screenshotPath =
+  process.env.FARM_EXPERIMENT_SCREENSHOT || "/tmp/farm-react-compiler-starter.png";
+
+await access(serverEntry);
+
+let serverOutput = "";
+const server = spawn(process.execPath, [serverEntry], {
+  env: {
+    ...process.env,
+    HOST: "127.0.0.1",
+    NITRO_HOST: "127.0.0.1",
+    NITRO_PORT: String(port),
+    PORT: String(port),
+  },
+  stdio: ["ignore", "pipe", "pipe"],
+});
+
+server.stdout.on("data", (chunk) => {
+  serverOutput += chunk;
+});
+server.stderr.on("data", (chunk) => {
+  serverOutput += chunk;
+});
+
+async function waitForServer() {
+  for (let attempt = 0; attempt < 120; attempt += 1) {
+    if (server.exitCode !== null) {
+      throw new Error(`Production server exited early.\n${serverOutput}`);
+    }
+    try {
+      const response = await fetch(origin);
+      if (response.ok) return;
+    } catch {
+      // The server is still starting.
+    }
+    await new Promise((resolve) => setTimeout(resolve, 100));
+  }
+  throw new Error(`Production server did not start.\n${serverOutput}`);
+}
+
+async function readNumber(page, selector) {
+  return Number((await page.locator(selector).textContent())?.trim());
+}
+
+let browser;
+try {
+  await waitForServer();
+  browser = await chromium.launch({ headless: true });
+  const page = await browser.newPage({ viewport: { width: 1280, height: 900 } });
+  const browserErrors = [];
+
+  page.on("console", (message) => {
+    if (message.type() === "error") browserErrors.push(message.text());
+  });
+  page.on("pageerror", (error) => browserErrors.push(error.message));
+
+  await page.goto(origin, { waitUntil: "networkidle" });
+  await page.getByRole("heading", { name: /compiler handles the rest/i }).waitFor();
+  assert.equal(
+    (await page.locator("[data-compiler-status]").textContent())?.trim(),
+    `experimental.compiler: ${String(compilerEnabled)}`,
+  );
+
+  const executions = {};
+  for (const pathName of ["compiled", "react"]) {
+    const root = `[data-path="${pathName}"]`;
+    executions[pathName] = {
+      initial: await readNumber(page, `${root} [data-metric="executions"]`),
+    };
+    await page.locator(`${root} [data-action="update"]`).click();
+    await page.locator(`${root} [data-action="update"]`).click();
+    await page.waitForFunction(
+      (selector) => document.querySelector(selector)?.textContent?.trim() === "2",
+      `${root} [data-metric="state"]`,
+    );
+    executions[pathName].final = await readNumber(page, `${root} [data-metric="executions"]`);
+    executions[pathName].added = executions[pathName].final - executions[pathName].initial;
+  }
+
+  assert.equal(executions.compiled.added, compilerEnabled ? 0 : 2);
+  assert.equal(executions.react.added, 2);
+  assert.deepEqual(browserErrors, []);
+
+  await page.screenshot({ path: screenshotPath, fullPage: true });
+
+  console.log(
+    JSON.stringify(
+      {
+        result: "PASS",
+        productionUrl: origin,
+        screenshot: screenshotPath,
+        compilerEnabled,
+        compiledUpdateExecutions: executions.compiled.added,
+        reactUpdateExecutions: executions.react.added,
+      },
+      null,
+      2,
+    ),
+  );
+} finally {
+  await browser?.close();
+  server.kill("SIGTERM");
+}

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

@@ -0,0 +1,29 @@
+---
+title: "Getting Started"
+description: "Your Farm.js documentation, powered by the @farming-labs/farmjs docs framework."
+---
+
+# Getting Started
+
+These docs are served by the Farm docs runtime, powered by the
+[@farming-labs/farmjs](https://www.npmjs.com/package/@farming-labs/farmjs) docs
+framework. The same Markdown files power human pages, Markdown routes,
+`llms.txt`, the sitemap, search, and agent discovery through `/api/docs`.
+
+## Edit this page
+
+This page lives at `src/app/docs/page.md`. Add more pages as folders with their
+own `page.md` — for example `src/app/docs/configuration/page.md` is served at
+`/docs/configuration`.
+
+## Configure
+
+Site-wide docs settings live in `docs.config.ts` at the project root (title,
+navigation, search, `llms.txt`, sitemap, and robots). Farm auto-detects the
+installed adapter because `farm.config.ts` sets `docs: { enabled: true }` — no
+manual wiring required.
+
+## Learn more
+
+- [Farm.js documentation](https://farmjs.dev/docs)
+- [Configuration guide](https://farmjs.dev/docs/configuration)