@farm.js/create-app 0.1.0-beta.20 → 0.1.0-beta.22

package/README.md

@@ -1,16 +1,18 @@
 # @farm.js/create-app
 
-Create a new Farm.js application
+Create a new FARMJS application
 
-Farm.js is currently in beta.
+FARMJS is currently in beta.
 
 ```bash
-pnpm create @farm.js/app my-app
+pnpm create @farm.js/app@beta my-app --template basic --typescript
 cd my-app
 pnpm dev
 ```
 
-The scaffolder installs React, React DOM, Farm.js, TypeScript, and the other starter dependencies
-automatically. Pass `--skip-install` when you only want to generate the project files.
+The scaffolder installs React, React DOM, FARMJS, TypeScript, and the other starter dependencies
+automatically. The command explicitly selects the minimal Basic starter. Use `pnpm create`, not
+`pnpm add`; pnpm resolves this initializer command to the published `@farm.js/create-app` package.
+Pass `--skip-install` when you only want to generate the project files.
 
-See the [Farm.js repository](https://github.com/farming-labs/farm.js) for documentation, examples, and support.
+See the [FARMJS repository](https://github.com/farming-labs/farm.js) for documentation, examples, and support.

package/bin/create-farm-app.js

@@ -6,7 +6,7 @@ const { version } = require("../package.json");
 
 program
   .name("create-farm-app")
-  .description("Create a new Farm.js application")
+  .description("Create a new FARMJS application")
   .version(version)
   .argument("[project-name]", "Name of the project")
   .option("-t, --template <template>", "Template to use")

package/dist/index.js

@@ -9,6 +9,23 @@ let fs_promises = require("fs/promises");
 fs_promises = require_rolldown_runtime.__toESM(fs_promises);
 let node_child_process = require("node:child_process");
 //#region src/index.ts
+const templateDetails = {
+	basic: {
+		title: "FARMJS Basic",
+		description: "A minimal FARMJS app with built-in Tailwind support",
+		instructions: ["Tailwind is enabled by default. You only need postcss config for custom plugins."]
+	},
+	auth: {
+		title: "FARMJS Auth",
+		description: "FARMJS-native auth with local SQLite, secure sessions, and protected routes",
+		instructions: ["FARMJS Auth uses local SQLite automatically; no auth environment variables are needed locally.", "For production, set FARM_AUTH_URL, FARM_AUTH_SECRET, and DATABASE_URL, then run the auth:migrate script."]
+	},
+	"better-auth": {
+		title: "FARMJS Better Auth",
+		description: "Better Auth with Postgres, secure sessions, and protected routes",
+		instructions: ["Before starting, copy .env.example to .env.local and set DATABASE_URL and BETTER_AUTH_SECRET.", "Better Auth migrations run automatically when the auth instance starts."]
+	}
+};
 async function createApp(projectName, options = {}) {
 	require_utils.showBanner();
 	const templates = await getAvailableTemplates();
@@ -42,11 +59,14 @@ async function createApp(projectName, options = {}) {
 			type: "select",
 			name: "template",
 			message: "Which template would you like to use?",
-			choices: templates.map((name) => ({
-				title: prettifyTemplateName(name),
-				value: name,
-				description: name === "basic" ? "A simple Farm.js app with built-in Tailwind support" : void 0
-			})),
+			choices: templates.map((name) => {
+				const details = templateDetails[name];
+				return {
+					title: details?.title ?? prettifyTemplateName(name),
+					value: name,
+					description: details?.description
+				};
+			}),
 			initial: 0
 		});
 		if (!response.template) {
@@ -85,7 +105,7 @@ async function createApp(projectName, options = {}) {
 			process.exit(1);
 		}
 	}
-	require_utils.logger.info(`Creating Farm.js app in ${projectPath}`);
+	require_utils.logger.info(`Creating FARMJS app in ${projectPath}`);
 	await fs_promises.default.mkdir(projectPath, { recursive: true });
 	await copyTemplate(template, projectPath, useTypeScript);
 	await updatePackageJson(projectPath, projectName, packageManager);
@@ -101,7 +121,7 @@ async function createApp(projectName, options = {}) {
 	if (options.skipInstall) require_utils.logger.info(`  ${packageManager.name} install`);
 	require_utils.logger.info(`  ${getDevCommand(packageManager.name)}`);
 	require_utils.logger.info("");
-	require_utils.logger.info("Tailwind is enabled by default. You only need postcss config for custom plugins.");
+	for (const instruction of templateDetails[template]?.instructions ?? []) require_utils.logger.info(instruction);
 }
 async function copyTemplate(template, projectPath, useTypeScript) {
 	await copyDir(path.default.join(__dirname, "..", "templates", template), projectPath);
@@ -152,7 +172,13 @@ function prettifyTemplateName(name) {
 }
 async function getAvailableTemplates() {
 	const templatesRoot = path.default.join(__dirname, "..", "templates");
-	return (await fs_promises.default.readdir(templatesRoot, { withFileTypes: true })).filter((entry) => entry.isDirectory() && !entry.name.startsWith("_")).map((entry) => entry.name).sort();
+	const entries = await fs_promises.default.readdir(templatesRoot, { withFileTypes: true });
+	const templateOrder = Object.keys(templateDetails);
+	return entries.filter((entry) => entry.isDirectory() && !entry.name.startsWith("_")).map((entry) => entry.name).sort((left, right) => {
+		const leftIndex = templateOrder.indexOf(left);
+		const rightIndex = templateOrder.indexOf(right);
+		return (leftIndex === -1 ? Number.MAX_SAFE_INTEGER : leftIndex) - (rightIndex === -1 ? Number.MAX_SAFE_INTEGER : rightIndex) || left.localeCompare(right);
+	});
 }
 async function updatePackageJson(projectPath, projectName, packageManager) {
 	const packageJsonPath = path.default.join(projectPath, "package.json");

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["fs","path","spawn"],"sources":["../src/index.ts"],"sourcesContent":["import prompts from \"prompts\";\nimport path from \"path\";\nimport fs from \"fs/promises\";\nimport { spawn } from \"node:child_process\";\nimport { logger, showBanner } from \"./utils\";\n\ninterface CreateAppOptions {\n  template?: string;\n  typescript?: boolean;\n  skipInstall?: boolean;\n}\n\nexport type PackageManagerName = \"npm\" | \"pnpm\" | \"yarn\" | \"bun\";\n\nexport interface PackageManager {\n  name: PackageManagerName;\n  version?: string;\n}\n\nexport async function createApp(projectName?: string, options: CreateAppOptions = {}) {\n  showBanner();\n\n  const templates = await getAvailableTemplates();\n  if (templates.length === 0) {\n    logger.error(\"No templates are available in this package.\");\n    process.exit(1);\n  }\n\n  // Get project name if not provided\n  if (!projectName) {\n    const response = await prompts({\n      type: \"text\",\n      name: \"projectName\",\n      message: \"What is your project named?\",\n      initial: \"my-farm-app\",\n      validate: validateProjectName,\n    });\n\n    if (!response.projectName) {\n      logger.error(\"Operation cancelled.\");\n      process.exit(1);\n    }\n\n    projectName = response.projectName;\n  } else {\n    const validation = validateProjectPathArg(projectName);\n    if (validation !== true) {\n      logger.error(validation);\n      process.exit(1);\n    }\n  }\n\n  // Get template if not provided\n  let template = options.template;\n  if (!template) {\n    const response = await prompts({\n      type: \"select\",\n      name: \"template\",\n      message: \"Which template would you like to use?\",\n      choices: templates.map((name) => ({\n        title: prettifyTemplateName(name),\n        value: name,\n        description:\n          name === \"basic\" ? \"A simple Farm.js app with built-in Tailwind support\" : undefined,\n      })),\n      initial: 0,\n    });\n\n    if (!response.template) {\n      logger.error(\"Operation cancelled.\");\n      process.exit(1);\n    }\n    template = response.template;\n  } else if (!templates.includes(template)) {\n    logger.error(\n      `Unknown template \"${template}\". Available: ${templates.map((t) => `\"${t}\"`).join(\", \")}`,\n    );\n    process.exit(1);\n  }\n\n  // Check TypeScript preference\n  let useTypeScript = options.typescript;\n  if (useTypeScript === undefined) {\n    const response = await prompts({\n      type: \"confirm\",\n      name: \"typescript\",\n      message: \"Would you like to use TypeScript?\",\n      initial: true,\n    });\n\n    if (response.typescript === undefined) {\n      logger.error(\"Operation cancelled.\");\n      process.exit(1);\n    }\n    useTypeScript = response.typescript;\n  }\n\n  const projectPath = path.resolve(process.cwd(), projectName!);\n  const packageManager = detectPackageManager();\n  const hasExistingFiles = await directoryHasFiles(projectPath);\n  if (hasExistingFiles) {\n    const overwriteResponse = await prompts({\n      type: \"confirm\",\n      name: \"overwrite\",\n      message: `Directory \"${projectName}\" is not empty. Continue and overwrite conflicting files?`,\n      initial: false,\n    });\n\n    if (!overwriteResponse.overwrite) {\n      logger.error(\"Operation cancelled.\");\n      process.exit(1);\n    }\n  }\n\n  logger.info(`Creating Farm.js app in ${projectPath}`);\n\n  await fs.mkdir(projectPath, { recursive: true });\n\n  await copyTemplate(template!, projectPath, useTypeScript!);\n\n  await updatePackageJson(projectPath, projectName!, packageManager);\n\n  logger.success(`🚜 Created ${projectName}`);\n\n  if (!options.skipInstall) {\n    logger.info(`Installing dependencies with ${packageManager.name}...`);\n    await installDependencies(projectPath, packageManager);\n    logger.success(\"Dependencies installed\");\n  }\n\n  logger.info(\"\");\n  logger.info(\"Next steps\");\n  logger.info(`  cd ${projectName}`);\n  if (options.skipInstall) {\n    logger.info(`  ${packageManager.name} install`);\n  }\n  logger.info(`  ${getDevCommand(packageManager.name)}`);\n  logger.info(\"\");\n  logger.info(\"Tailwind is enabled by default. You only need postcss config for custom plugins.\");\n}\n\nasync function copyTemplate(template: string, projectPath: string, useTypeScript: boolean) {\n  const templatePath = path.join(__dirname, \"..\", \"templates\", template);\n\n  // Copy base template files\n  await copyDir(templatePath, projectPath);\n\n  // If TypeScript is requested, copy TS-specific files\n  if (useTypeScript) {\n    const tsTemplatePath = path.join(__dirname, \"..\", \"templates\", \"_typescript\");\n    if (await dirExists(tsTemplatePath)) {\n      await copyDir(tsTemplatePath, projectPath);\n    }\n  }\n}\n\nasync function copyDir(src: string, dest: string) {\n  await fs.mkdir(dest, { recursive: true });\n\n  const entries = await fs.readdir(src, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const srcPath = path.join(src, entry.name);\n    // npm excludes .gitignore files from published tarballs. Keep the template\n    // file publishable and restore its dot when generating the application.\n    const destinationName = entry.name === \"gitignore\" ? \".gitignore\" : entry.name;\n    const destPath = path.join(dest, destinationName);\n\n    if (entry.isDirectory()) {\n      await copyDir(srcPath, destPath);\n    } else {\n      await fs.copyFile(srcPath, destPath);\n    }\n  }\n}\n\nasync function dirExists(path: string): Promise<boolean> {\n  try {\n    const stat = await fs.stat(path);\n    return stat.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nasync function directoryHasFiles(dirPath: string): Promise<boolean> {\n  if (!(await dirExists(dirPath))) {\n    return false;\n  }\n  const files = await fs.readdir(dirPath);\n  return files.length > 0;\n}\n\nfunction validateProjectName(value: string): true | string {\n  const trimmed = value.trim();\n  if (!trimmed) {\n    return \"Project name is required\";\n  }\n\n  // npm package-safe pattern\n  if (!/^[a-z0-9._-]+$/i.test(trimmed)) {\n    return \"Use letters, numbers, hyphens, underscores, or dots\";\n  }\n\n  if (trimmed.startsWith(\".\") || trimmed.startsWith(\"_\")) {\n    return \"Project name cannot start with '.' or '_'\";\n  }\n\n  return true;\n}\n\nfunction validateProjectPathArg(value: string): true | string {\n  const trimmed = value.trim();\n  if (!trimmed) {\n    return \"Project name is required\";\n  }\n\n  const normalized = trimmed.replace(/[\\\\/]+$/, \"\");\n  const baseName = path.basename(normalized);\n  if (!baseName || baseName === \".\" || baseName === \"..\") {\n    return \"Please provide a valid project directory name\";\n  }\n\n  return validateProjectName(baseName);\n}\n\nfunction prettifyTemplateName(name: string): string {\n  return name\n    .split(\"-\")\n    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n    .join(\" \");\n}\n\nasync function getAvailableTemplates(): Promise<string[]> {\n  const templatesRoot = path.join(__dirname, \"..\", \"templates\");\n  const entries = await fs.readdir(templatesRoot, { withFileTypes: true });\n  return entries\n    .filter((entry) => entry.isDirectory() && !entry.name.startsWith(\"_\"))\n    .map((entry) => entry.name)\n    .sort();\n}\n\nasync function updatePackageJson(\n  projectPath: string,\n  projectName: string,\n  packageManager: PackageManager,\n) {\n  const packageJsonPath = path.join(projectPath, \"package.json\");\n\n  try {\n    const content = await fs.readFile(packageJsonPath, \"utf-8\");\n    const packageJson = JSON.parse(content);\n\n    packageJson.name = projectName;\n    if (packageManager.version) {\n      packageJson.packageManager = `${packageManager.name}@${packageManager.version}`;\n    }\n\n    await fs.writeFile(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\\n`);\n  } catch {\n    logger.warn(\"Could not update package.json\");\n  }\n}\n\nexport function detectPackageManager(\n  userAgent = process.env.npm_config_user_agent,\n): PackageManager {\n  const match = userAgent?.match(/^(npm|pnpm|yarn|bun)\\/([^\\s]+)/);\n  if (!match) {\n    return { name: \"pnpm\" };\n  }\n\n  const [, name, version] = match;\n  return {\n    name: name as PackageManagerName,\n    version: version === \"?\" ? undefined : version,\n  };\n}\n\nexport function installDependencies(\n  projectPath: string,\n  packageManager: PackageManager,\n): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const command =\n      process.platform === \"win32\" ? `${packageManager.name}.cmd` : packageManager.name;\n    const child = spawn(command, [\"install\"], {\n      cwd: projectPath,\n      env: process.env,\n      stdio: \"inherit\",\n    });\n\n    child.on(\"error\", reject);\n    child.on(\"close\", (code, signal) => {\n      if (code === 0) {\n        resolve();\n        return;\n      }\n\n      const reason = signal ? `signal ${signal}` : `exit code ${code ?? \"unknown\"}`;\n      reject(new Error(`${packageManager.name} install failed with ${reason}.`));\n    });\n  });\n}\n\nfunction getDevCommand(packageManager: PackageManagerName) {\n  if (packageManager === \"npm\" || packageManager === \"bun\") {\n    return `${packageManager} run dev`;\n  }\n  return `${packageManager} dev`;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["fs","path","spawn"],"sources":["../src/index.ts"],"sourcesContent":["import prompts from \"prompts\";\nimport path from \"path\";\nimport fs from \"fs/promises\";\nimport { spawn } from \"node:child_process\";\nimport { logger, showBanner } from \"./utils\";\n\ninterface CreateAppOptions {\n  template?: string;\n  typescript?: boolean;\n  skipInstall?: boolean;\n}\n\nconst templateDetails: Record<\n  string,\n  {\n    title: string;\n    description: string;\n    instructions: string[];\n  }\n> = {\n  basic: {\n    title: \"FARMJS Basic\",\n    description: \"A minimal FARMJS app with built-in Tailwind support\",\n    instructions: [\n      \"Tailwind is enabled by default. You only need postcss config for custom plugins.\",\n    ],\n  },\n  auth: {\n    title: \"FARMJS Auth\",\n    description: \"FARMJS-native auth with local SQLite, secure sessions, and protected routes\",\n    instructions: [\n      \"FARMJS Auth uses local SQLite automatically; no auth environment variables are needed locally.\",\n      \"For production, set FARM_AUTH_URL, FARM_AUTH_SECRET, and DATABASE_URL, then run the auth:migrate script.\",\n    ],\n  },\n  \"better-auth\": {\n    title: \"FARMJS Better Auth\",\n    description: \"Better Auth with Postgres, secure sessions, and protected routes\",\n    instructions: [\n      \"Before starting, copy .env.example to .env.local and set DATABASE_URL and BETTER_AUTH_SECRET.\",\n      \"Better Auth migrations run automatically when the auth instance starts.\",\n    ],\n  },\n};\n\nexport type PackageManagerName = \"npm\" | \"pnpm\" | \"yarn\" | \"bun\";\n\nexport interface PackageManager {\n  name: PackageManagerName;\n  version?: string;\n}\n\nexport async function createApp(projectName?: string, options: CreateAppOptions = {}) {\n  showBanner();\n\n  const templates = await getAvailableTemplates();\n  if (templates.length === 0) {\n    logger.error(\"No templates are available in this package.\");\n    process.exit(1);\n  }\n\n  // Get project name if not provided\n  if (!projectName) {\n    const response = await prompts({\n      type: \"text\",\n      name: \"projectName\",\n      message: \"What is your project named?\",\n      initial: \"my-farm-app\",\n      validate: validateProjectName,\n    });\n\n    if (!response.projectName) {\n      logger.error(\"Operation cancelled.\");\n      process.exit(1);\n    }\n\n    projectName = response.projectName;\n  } else {\n    const validation = validateProjectPathArg(projectName);\n    if (validation !== true) {\n      logger.error(validation);\n      process.exit(1);\n    }\n  }\n\n  // Get template if not provided\n  let template = options.template;\n  if (!template) {\n    const response = await prompts({\n      type: \"select\",\n      name: \"template\",\n      message: \"Which template would you like to use?\",\n      choices: templates.map((name) => {\n        const details = templateDetails[name];\n        return {\n          title: details?.title ?? prettifyTemplateName(name),\n          value: name,\n          description: details?.description,\n        };\n      }),\n      initial: 0,\n    });\n\n    if (!response.template) {\n      logger.error(\"Operation cancelled.\");\n      process.exit(1);\n    }\n    template = response.template;\n  } else if (!templates.includes(template)) {\n    logger.error(\n      `Unknown template \"${template}\". Available: ${templates.map((t) => `\"${t}\"`).join(\", \")}`,\n    );\n    process.exit(1);\n  }\n\n  // Check TypeScript preference\n  let useTypeScript = options.typescript;\n  if (useTypeScript === undefined) {\n    const response = await prompts({\n      type: \"confirm\",\n      name: \"typescript\",\n      message: \"Would you like to use TypeScript?\",\n      initial: true,\n    });\n\n    if (response.typescript === undefined) {\n      logger.error(\"Operation cancelled.\");\n      process.exit(1);\n    }\n    useTypeScript = response.typescript;\n  }\n\n  const projectPath = path.resolve(process.cwd(), projectName!);\n  const packageManager = detectPackageManager();\n  const hasExistingFiles = await directoryHasFiles(projectPath);\n  if (hasExistingFiles) {\n    const overwriteResponse = await prompts({\n      type: \"confirm\",\n      name: \"overwrite\",\n      message: `Directory \"${projectName}\" is not empty. Continue and overwrite conflicting files?`,\n      initial: false,\n    });\n\n    if (!overwriteResponse.overwrite) {\n      logger.error(\"Operation cancelled.\");\n      process.exit(1);\n    }\n  }\n\n  logger.info(`Creating FARMJS app in ${projectPath}`);\n\n  await fs.mkdir(projectPath, { recursive: true });\n\n  await copyTemplate(template!, projectPath, useTypeScript!);\n\n  await updatePackageJson(projectPath, projectName!, packageManager);\n\n  logger.success(`🚜 Created ${projectName}`);\n\n  if (!options.skipInstall) {\n    logger.info(`Installing dependencies with ${packageManager.name}...`);\n    await installDependencies(projectPath, packageManager);\n    logger.success(\"Dependencies installed\");\n  }\n\n  logger.info(\"\");\n  logger.info(\"Next steps\");\n  logger.info(`  cd ${projectName}`);\n  if (options.skipInstall) {\n    logger.info(`  ${packageManager.name} install`);\n  }\n  logger.info(`  ${getDevCommand(packageManager.name)}`);\n  logger.info(\"\");\n  for (const instruction of templateDetails[template!]?.instructions ?? []) {\n    logger.info(instruction);\n  }\n}\n\nasync function copyTemplate(template: string, projectPath: string, useTypeScript: boolean) {\n  const templatePath = path.join(__dirname, \"..\", \"templates\", template);\n\n  // Copy base template files\n  await copyDir(templatePath, projectPath);\n\n  // If TypeScript is requested, copy TS-specific files\n  if (useTypeScript) {\n    const tsTemplatePath = path.join(__dirname, \"..\", \"templates\", \"_typescript\");\n    if (await dirExists(tsTemplatePath)) {\n      await copyDir(tsTemplatePath, projectPath);\n    }\n  }\n}\n\nasync function copyDir(src: string, dest: string) {\n  await fs.mkdir(dest, { recursive: true });\n\n  const entries = await fs.readdir(src, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const srcPath = path.join(src, entry.name);\n    // npm excludes .gitignore files from published tarballs. Keep the template\n    // file publishable and restore its dot when generating the application.\n    const destinationName = entry.name === \"gitignore\" ? \".gitignore\" : entry.name;\n    const destPath = path.join(dest, destinationName);\n\n    if (entry.isDirectory()) {\n      await copyDir(srcPath, destPath);\n    } else {\n      await fs.copyFile(srcPath, destPath);\n    }\n  }\n}\n\nasync function dirExists(path: string): Promise<boolean> {\n  try {\n    const stat = await fs.stat(path);\n    return stat.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nasync function directoryHasFiles(dirPath: string): Promise<boolean> {\n  if (!(await dirExists(dirPath))) {\n    return false;\n  }\n  const files = await fs.readdir(dirPath);\n  return files.length > 0;\n}\n\nfunction validateProjectName(value: string): true | string {\n  const trimmed = value.trim();\n  if (!trimmed) {\n    return \"Project name is required\";\n  }\n\n  // npm package-safe pattern\n  if (!/^[a-z0-9._-]+$/i.test(trimmed)) {\n    return \"Use letters, numbers, hyphens, underscores, or dots\";\n  }\n\n  if (trimmed.startsWith(\".\") || trimmed.startsWith(\"_\")) {\n    return \"Project name cannot start with '.' or '_'\";\n  }\n\n  return true;\n}\n\nfunction validateProjectPathArg(value: string): true | string {\n  const trimmed = value.trim();\n  if (!trimmed) {\n    return \"Project name is required\";\n  }\n\n  const normalized = trimmed.replace(/[\\\\/]+$/, \"\");\n  const baseName = path.basename(normalized);\n  if (!baseName || baseName === \".\" || baseName === \"..\") {\n    return \"Please provide a valid project directory name\";\n  }\n\n  return validateProjectName(baseName);\n}\n\nfunction prettifyTemplateName(name: string): string {\n  return name\n    .split(\"-\")\n    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n    .join(\" \");\n}\n\nasync function getAvailableTemplates(): Promise<string[]> {\n  const templatesRoot = path.join(__dirname, \"..\", \"templates\");\n  const entries = await fs.readdir(templatesRoot, { withFileTypes: true });\n  const templateOrder = Object.keys(templateDetails);\n  return entries\n    .filter((entry) => entry.isDirectory() && !entry.name.startsWith(\"_\"))\n    .map((entry) => entry.name)\n    .sort((left, right) => {\n      const leftIndex = templateOrder.indexOf(left);\n      const rightIndex = templateOrder.indexOf(right);\n      const normalizedLeft = leftIndex === -1 ? Number.MAX_SAFE_INTEGER : leftIndex;\n      const normalizedRight = rightIndex === -1 ? Number.MAX_SAFE_INTEGER : rightIndex;\n      return normalizedLeft - normalizedRight || left.localeCompare(right);\n    });\n}\n\nasync function updatePackageJson(\n  projectPath: string,\n  projectName: string,\n  packageManager: PackageManager,\n) {\n  const packageJsonPath = path.join(projectPath, \"package.json\");\n\n  try {\n    const content = await fs.readFile(packageJsonPath, \"utf-8\");\n    const packageJson = JSON.parse(content);\n\n    packageJson.name = projectName;\n    if (packageManager.version) {\n      packageJson.packageManager = `${packageManager.name}@${packageManager.version}`;\n    }\n\n    await fs.writeFile(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\\n`);\n  } catch {\n    logger.warn(\"Could not update package.json\");\n  }\n}\n\nexport function detectPackageManager(\n  userAgent = process.env.npm_config_user_agent,\n): PackageManager {\n  const match = userAgent?.match(/^(npm|pnpm|yarn|bun)\\/([^\\s]+)/);\n  if (!match) {\n    return { name: \"pnpm\" };\n  }\n\n  const [, name, version] = match;\n  return {\n    name: name as PackageManagerName,\n    version: version === \"?\" ? undefined : version,\n  };\n}\n\nexport function installDependencies(\n  projectPath: string,\n  packageManager: PackageManager,\n): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const command =\n      process.platform === \"win32\" ? `${packageManager.name}.cmd` : packageManager.name;\n    const child = spawn(command, [\"install\"], {\n      cwd: projectPath,\n      env: process.env,\n      stdio: \"inherit\",\n    });\n\n    child.on(\"error\", reject);\n    child.on(\"close\", (code, signal) => {\n      if (code === 0) {\n        resolve();\n        return;\n      }\n\n      const reason = signal ? `signal ${signal}` : `exit code ${code ?? \"unknown\"}`;\n      reject(new Error(`${packageManager.name} install failed with ${reason}.`));\n    });\n  });\n}\n\nfunction getDevCommand(packageManager: PackageManagerName) {\n  if (packageManager === \"npm\" || packageManager === \"bun\") {\n    return `${packageManager} run dev`;\n  }\n  return `${packageManager} dev`;\n}\n"],"mappings":"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"}

package/dist/index.mjs

@@ -4,6 +4,23 @@ import path from "path";
 import fs from "fs/promises";
 import { spawn } from "node:child_process";
 //#region src/index.ts
+const templateDetails = {
+	basic: {
+		title: "FARMJS Basic",
+		description: "A minimal FARMJS app with built-in Tailwind support",
+		instructions: ["Tailwind is enabled by default. You only need postcss config for custom plugins."]
+	},
+	auth: {
+		title: "FARMJS Auth",
+		description: "FARMJS-native auth with local SQLite, secure sessions, and protected routes",
+		instructions: ["FARMJS Auth uses local SQLite automatically; no auth environment variables are needed locally.", "For production, set FARM_AUTH_URL, FARM_AUTH_SECRET, and DATABASE_URL, then run the auth:migrate script."]
+	},
+	"better-auth": {
+		title: "FARMJS Better Auth",
+		description: "Better Auth with Postgres, secure sessions, and protected routes",
+		instructions: ["Before starting, copy .env.example to .env.local and set DATABASE_URL and BETTER_AUTH_SECRET.", "Better Auth migrations run automatically when the auth instance starts."]
+	}
+};
 async function createApp(projectName, options = {}) {
 	showBanner();
 	const templates = await getAvailableTemplates();
@@ -37,11 +54,14 @@ async function createApp(projectName, options = {}) {
 			type: "select",
 			name: "template",
 			message: "Which template would you like to use?",
-			choices: templates.map((name) => ({
-				title: prettifyTemplateName(name),
-				value: name,
-				description: name === "basic" ? "A simple Farm.js app with built-in Tailwind support" : void 0
-			})),
+			choices: templates.map((name) => {
+				const details = templateDetails[name];
+				return {
+					title: details?.title ?? prettifyTemplateName(name),
+					value: name,
+					description: details?.description
+				};
+			}),
 			initial: 0
 		});
 		if (!response.template) {
@@ -80,7 +100,7 @@ async function createApp(projectName, options = {}) {
 			process.exit(1);
 		}
 	}
-	logger.info(`Creating Farm.js app in ${projectPath}`);
+	logger.info(`Creating FARMJS app in ${projectPath}`);
 	await fs.mkdir(projectPath, { recursive: true });
 	await copyTemplate(template, projectPath, useTypeScript);
 	await updatePackageJson(projectPath, projectName, packageManager);
@@ -96,7 +116,7 @@ async function createApp(projectName, options = {}) {
 	if (options.skipInstall) logger.info(`  ${packageManager.name} install`);
 	logger.info(`  ${getDevCommand(packageManager.name)}`);
 	logger.info("");
-	logger.info("Tailwind is enabled by default. You only need postcss config for custom plugins.");
+	for (const instruction of templateDetails[template]?.instructions ?? []) logger.info(instruction);
 }
 async function copyTemplate(template, projectPath, useTypeScript) {
 	await copyDir(path.join(__dirname, "..", "templates", template), projectPath);
@@ -147,7 +167,13 @@ function prettifyTemplateName(name) {
 }
 async function getAvailableTemplates() {
 	const templatesRoot = path.join(__dirname, "..", "templates");
-	return (await fs.readdir(templatesRoot, { withFileTypes: true })).filter((entry) => entry.isDirectory() && !entry.name.startsWith("_")).map((entry) => entry.name).sort();
+	const entries = await fs.readdir(templatesRoot, { withFileTypes: true });
+	const templateOrder = Object.keys(templateDetails);
+	return entries.filter((entry) => entry.isDirectory() && !entry.name.startsWith("_")).map((entry) => entry.name).sort((left, right) => {
+		const leftIndex = templateOrder.indexOf(left);
+		const rightIndex = templateOrder.indexOf(right);
+		return (leftIndex === -1 ? Number.MAX_SAFE_INTEGER : leftIndex) - (rightIndex === -1 ? Number.MAX_SAFE_INTEGER : rightIndex) || left.localeCompare(right);
+	});
 }
 async function updatePackageJson(projectPath, projectName, packageManager) {
 	const packageJsonPath = path.join(projectPath, "package.json");

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import prompts from \"prompts\";\nimport path from \"path\";\nimport fs from \"fs/promises\";\nimport { spawn } from \"node:child_process\";\nimport { logger, showBanner } from \"./utils\";\n\ninterface CreateAppOptions {\n  template?: string;\n  typescript?: boolean;\n  skipInstall?: boolean;\n}\n\nexport type PackageManagerName = \"npm\" | \"pnpm\" | \"yarn\" | \"bun\";\n\nexport interface PackageManager {\n  name: PackageManagerName;\n  version?: string;\n}\n\nexport async function createApp(projectName?: string, options: CreateAppOptions = {}) {\n  showBanner();\n\n  const templates = await getAvailableTemplates();\n  if (templates.length === 0) {\n    logger.error(\"No templates are available in this package.\");\n    process.exit(1);\n  }\n\n  // Get project name if not provided\n  if (!projectName) {\n    const response = await prompts({\n      type: \"text\",\n      name: \"projectName\",\n      message: \"What is your project named?\",\n      initial: \"my-farm-app\",\n      validate: validateProjectName,\n    });\n\n    if (!response.projectName) {\n      logger.error(\"Operation cancelled.\");\n      process.exit(1);\n    }\n\n    projectName = response.projectName;\n  } else {\n    const validation = validateProjectPathArg(projectName);\n    if (validation !== true) {\n      logger.error(validation);\n      process.exit(1);\n    }\n  }\n\n  // Get template if not provided\n  let template = options.template;\n  if (!template) {\n    const response = await prompts({\n      type: \"select\",\n      name: \"template\",\n      message: \"Which template would you like to use?\",\n      choices: templates.map((name) => ({\n        title: prettifyTemplateName(name),\n        value: name,\n        description:\n          name === \"basic\" ? \"A simple Farm.js app with built-in Tailwind support\" : undefined,\n      })),\n      initial: 0,\n    });\n\n    if (!response.template) {\n      logger.error(\"Operation cancelled.\");\n      process.exit(1);\n    }\n    template = response.template;\n  } else if (!templates.includes(template)) {\n    logger.error(\n      `Unknown template \"${template}\". Available: ${templates.map((t) => `\"${t}\"`).join(\", \")}`,\n    );\n    process.exit(1);\n  }\n\n  // Check TypeScript preference\n  let useTypeScript = options.typescript;\n  if (useTypeScript === undefined) {\n    const response = await prompts({\n      type: \"confirm\",\n      name: \"typescript\",\n      message: \"Would you like to use TypeScript?\",\n      initial: true,\n    });\n\n    if (response.typescript === undefined) {\n      logger.error(\"Operation cancelled.\");\n      process.exit(1);\n    }\n    useTypeScript = response.typescript;\n  }\n\n  const projectPath = path.resolve(process.cwd(), projectName!);\n  const packageManager = detectPackageManager();\n  const hasExistingFiles = await directoryHasFiles(projectPath);\n  if (hasExistingFiles) {\n    const overwriteResponse = await prompts({\n      type: \"confirm\",\n      name: \"overwrite\",\n      message: `Directory \"${projectName}\" is not empty. Continue and overwrite conflicting files?`,\n      initial: false,\n    });\n\n    if (!overwriteResponse.overwrite) {\n      logger.error(\"Operation cancelled.\");\n      process.exit(1);\n    }\n  }\n\n  logger.info(`Creating Farm.js app in ${projectPath}`);\n\n  await fs.mkdir(projectPath, { recursive: true });\n\n  await copyTemplate(template!, projectPath, useTypeScript!);\n\n  await updatePackageJson(projectPath, projectName!, packageManager);\n\n  logger.success(`🚜 Created ${projectName}`);\n\n  if (!options.skipInstall) {\n    logger.info(`Installing dependencies with ${packageManager.name}...`);\n    await installDependencies(projectPath, packageManager);\n    logger.success(\"Dependencies installed\");\n  }\n\n  logger.info(\"\");\n  logger.info(\"Next steps\");\n  logger.info(`  cd ${projectName}`);\n  if (options.skipInstall) {\n    logger.info(`  ${packageManager.name} install`);\n  }\n  logger.info(`  ${getDevCommand(packageManager.name)}`);\n  logger.info(\"\");\n  logger.info(\"Tailwind is enabled by default. You only need postcss config for custom plugins.\");\n}\n\nasync function copyTemplate(template: string, projectPath: string, useTypeScript: boolean) {\n  const templatePath = path.join(__dirname, \"..\", \"templates\", template);\n\n  // Copy base template files\n  await copyDir(templatePath, projectPath);\n\n  // If TypeScript is requested, copy TS-specific files\n  if (useTypeScript) {\n    const tsTemplatePath = path.join(__dirname, \"..\", \"templates\", \"_typescript\");\n    if (await dirExists(tsTemplatePath)) {\n      await copyDir(tsTemplatePath, projectPath);\n    }\n  }\n}\n\nasync function copyDir(src: string, dest: string) {\n  await fs.mkdir(dest, { recursive: true });\n\n  const entries = await fs.readdir(src, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const srcPath = path.join(src, entry.name);\n    // npm excludes .gitignore files from published tarballs. Keep the template\n    // file publishable and restore its dot when generating the application.\n    const destinationName = entry.name === \"gitignore\" ? \".gitignore\" : entry.name;\n    const destPath = path.join(dest, destinationName);\n\n    if (entry.isDirectory()) {\n      await copyDir(srcPath, destPath);\n    } else {\n      await fs.copyFile(srcPath, destPath);\n    }\n  }\n}\n\nasync function dirExists(path: string): Promise<boolean> {\n  try {\n    const stat = await fs.stat(path);\n    return stat.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nasync function directoryHasFiles(dirPath: string): Promise<boolean> {\n  if (!(await dirExists(dirPath))) {\n    return false;\n  }\n  const files = await fs.readdir(dirPath);\n  return files.length > 0;\n}\n\nfunction validateProjectName(value: string): true | string {\n  const trimmed = value.trim();\n  if (!trimmed) {\n    return \"Project name is required\";\n  }\n\n  // npm package-safe pattern\n  if (!/^[a-z0-9._-]+$/i.test(trimmed)) {\n    return \"Use letters, numbers, hyphens, underscores, or dots\";\n  }\n\n  if (trimmed.startsWith(\".\") || trimmed.startsWith(\"_\")) {\n    return \"Project name cannot start with '.' or '_'\";\n  }\n\n  return true;\n}\n\nfunction validateProjectPathArg(value: string): true | string {\n  const trimmed = value.trim();\n  if (!trimmed) {\n    return \"Project name is required\";\n  }\n\n  const normalized = trimmed.replace(/[\\\\/]+$/, \"\");\n  const baseName = path.basename(normalized);\n  if (!baseName || baseName === \".\" || baseName === \"..\") {\n    return \"Please provide a valid project directory name\";\n  }\n\n  return validateProjectName(baseName);\n}\n\nfunction prettifyTemplateName(name: string): string {\n  return name\n    .split(\"-\")\n    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n    .join(\" \");\n}\n\nasync function getAvailableTemplates(): Promise<string[]> {\n  const templatesRoot = path.join(__dirname, \"..\", \"templates\");\n  const entries = await fs.readdir(templatesRoot, { withFileTypes: true });\n  return entries\n    .filter((entry) => entry.isDirectory() && !entry.name.startsWith(\"_\"))\n    .map((entry) => entry.name)\n    .sort();\n}\n\nasync function updatePackageJson(\n  projectPath: string,\n  projectName: string,\n  packageManager: PackageManager,\n) {\n  const packageJsonPath = path.join(projectPath, \"package.json\");\n\n  try {\n    const content = await fs.readFile(packageJsonPath, \"utf-8\");\n    const packageJson = JSON.parse(content);\n\n    packageJson.name = projectName;\n    if (packageManager.version) {\n      packageJson.packageManager = `${packageManager.name}@${packageManager.version}`;\n    }\n\n    await fs.writeFile(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\\n`);\n  } catch {\n    logger.warn(\"Could not update package.json\");\n  }\n}\n\nexport function detectPackageManager(\n  userAgent = process.env.npm_config_user_agent,\n): PackageManager {\n  const match = userAgent?.match(/^(npm|pnpm|yarn|bun)\\/([^\\s]+)/);\n  if (!match) {\n    return { name: \"pnpm\" };\n  }\n\n  const [, name, version] = match;\n  return {\n    name: name as PackageManagerName,\n    version: version === \"?\" ? undefined : version,\n  };\n}\n\nexport function installDependencies(\n  projectPath: string,\n  packageManager: PackageManager,\n): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const command =\n      process.platform === \"win32\" ? `${packageManager.name}.cmd` : packageManager.name;\n    const child = spawn(command, [\"install\"], {\n      cwd: projectPath,\n      env: process.env,\n      stdio: \"inherit\",\n    });\n\n    child.on(\"error\", reject);\n    child.on(\"close\", (code, signal) => {\n      if (code === 0) {\n        resolve();\n        return;\n      }\n\n      const reason = signal ? `signal ${signal}` : `exit code ${code ?? \"unknown\"}`;\n      reject(new Error(`${packageManager.name} install failed with ${reason}.`));\n    });\n  });\n}\n\nfunction getDevCommand(packageManager: PackageManagerName) {\n  if (packageManager === \"npm\" || packageManager === \"bun\") {\n    return `${packageManager} run dev`;\n  }\n  return `${packageManager} dev`;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import prompts from \"prompts\";\nimport path from \"path\";\nimport fs from \"fs/promises\";\nimport { spawn } from \"node:child_process\";\nimport { logger, showBanner } from \"./utils\";\n\ninterface CreateAppOptions {\n  template?: string;\n  typescript?: boolean;\n  skipInstall?: boolean;\n}\n\nconst templateDetails: Record<\n  string,\n  {\n    title: string;\n    description: string;\n    instructions: string[];\n  }\n> = {\n  basic: {\n    title: \"FARMJS Basic\",\n    description: \"A minimal FARMJS app with built-in Tailwind support\",\n    instructions: [\n      \"Tailwind is enabled by default. You only need postcss config for custom plugins.\",\n    ],\n  },\n  auth: {\n    title: \"FARMJS Auth\",\n    description: \"FARMJS-native auth with local SQLite, secure sessions, and protected routes\",\n    instructions: [\n      \"FARMJS Auth uses local SQLite automatically; no auth environment variables are needed locally.\",\n      \"For production, set FARM_AUTH_URL, FARM_AUTH_SECRET, and DATABASE_URL, then run the auth:migrate script.\",\n    ],\n  },\n  \"better-auth\": {\n    title: \"FARMJS Better Auth\",\n    description: \"Better Auth with Postgres, secure sessions, and protected routes\",\n    instructions: [\n      \"Before starting, copy .env.example to .env.local and set DATABASE_URL and BETTER_AUTH_SECRET.\",\n      \"Better Auth migrations run automatically when the auth instance starts.\",\n    ],\n  },\n};\n\nexport type PackageManagerName = \"npm\" | \"pnpm\" | \"yarn\" | \"bun\";\n\nexport interface PackageManager {\n  name: PackageManagerName;\n  version?: string;\n}\n\nexport async function createApp(projectName?: string, options: CreateAppOptions = {}) {\n  showBanner();\n\n  const templates = await getAvailableTemplates();\n  if (templates.length === 0) {\n    logger.error(\"No templates are available in this package.\");\n    process.exit(1);\n  }\n\n  // Get project name if not provided\n  if (!projectName) {\n    const response = await prompts({\n      type: \"text\",\n      name: \"projectName\",\n      message: \"What is your project named?\",\n      initial: \"my-farm-app\",\n      validate: validateProjectName,\n    });\n\n    if (!response.projectName) {\n      logger.error(\"Operation cancelled.\");\n      process.exit(1);\n    }\n\n    projectName = response.projectName;\n  } else {\n    const validation = validateProjectPathArg(projectName);\n    if (validation !== true) {\n      logger.error(validation);\n      process.exit(1);\n    }\n  }\n\n  // Get template if not provided\n  let template = options.template;\n  if (!template) {\n    const response = await prompts({\n      type: \"select\",\n      name: \"template\",\n      message: \"Which template would you like to use?\",\n      choices: templates.map((name) => {\n        const details = templateDetails[name];\n        return {\n          title: details?.title ?? prettifyTemplateName(name),\n          value: name,\n          description: details?.description,\n        };\n      }),\n      initial: 0,\n    });\n\n    if (!response.template) {\n      logger.error(\"Operation cancelled.\");\n      process.exit(1);\n    }\n    template = response.template;\n  } else if (!templates.includes(template)) {\n    logger.error(\n      `Unknown template \"${template}\". Available: ${templates.map((t) => `\"${t}\"`).join(\", \")}`,\n    );\n    process.exit(1);\n  }\n\n  // Check TypeScript preference\n  let useTypeScript = options.typescript;\n  if (useTypeScript === undefined) {\n    const response = await prompts({\n      type: \"confirm\",\n      name: \"typescript\",\n      message: \"Would you like to use TypeScript?\",\n      initial: true,\n    });\n\n    if (response.typescript === undefined) {\n      logger.error(\"Operation cancelled.\");\n      process.exit(1);\n    }\n    useTypeScript = response.typescript;\n  }\n\n  const projectPath = path.resolve(process.cwd(), projectName!);\n  const packageManager = detectPackageManager();\n  const hasExistingFiles = await directoryHasFiles(projectPath);\n  if (hasExistingFiles) {\n    const overwriteResponse = await prompts({\n      type: \"confirm\",\n      name: \"overwrite\",\n      message: `Directory \"${projectName}\" is not empty. Continue and overwrite conflicting files?`,\n      initial: false,\n    });\n\n    if (!overwriteResponse.overwrite) {\n      logger.error(\"Operation cancelled.\");\n      process.exit(1);\n    }\n  }\n\n  logger.info(`Creating FARMJS app in ${projectPath}`);\n\n  await fs.mkdir(projectPath, { recursive: true });\n\n  await copyTemplate(template!, projectPath, useTypeScript!);\n\n  await updatePackageJson(projectPath, projectName!, packageManager);\n\n  logger.success(`🚜 Created ${projectName}`);\n\n  if (!options.skipInstall) {\n    logger.info(`Installing dependencies with ${packageManager.name}...`);\n    await installDependencies(projectPath, packageManager);\n    logger.success(\"Dependencies installed\");\n  }\n\n  logger.info(\"\");\n  logger.info(\"Next steps\");\n  logger.info(`  cd ${projectName}`);\n  if (options.skipInstall) {\n    logger.info(`  ${packageManager.name} install`);\n  }\n  logger.info(`  ${getDevCommand(packageManager.name)}`);\n  logger.info(\"\");\n  for (const instruction of templateDetails[template!]?.instructions ?? []) {\n    logger.info(instruction);\n  }\n}\n\nasync function copyTemplate(template: string, projectPath: string, useTypeScript: boolean) {\n  const templatePath = path.join(__dirname, \"..\", \"templates\", template);\n\n  // Copy base template files\n  await copyDir(templatePath, projectPath);\n\n  // If TypeScript is requested, copy TS-specific files\n  if (useTypeScript) {\n    const tsTemplatePath = path.join(__dirname, \"..\", \"templates\", \"_typescript\");\n    if (await dirExists(tsTemplatePath)) {\n      await copyDir(tsTemplatePath, projectPath);\n    }\n  }\n}\n\nasync function copyDir(src: string, dest: string) {\n  await fs.mkdir(dest, { recursive: true });\n\n  const entries = await fs.readdir(src, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const srcPath = path.join(src, entry.name);\n    // npm excludes .gitignore files from published tarballs. Keep the template\n    // file publishable and restore its dot when generating the application.\n    const destinationName = entry.name === \"gitignore\" ? \".gitignore\" : entry.name;\n    const destPath = path.join(dest, destinationName);\n\n    if (entry.isDirectory()) {\n      await copyDir(srcPath, destPath);\n    } else {\n      await fs.copyFile(srcPath, destPath);\n    }\n  }\n}\n\nasync function dirExists(path: string): Promise<boolean> {\n  try {\n    const stat = await fs.stat(path);\n    return stat.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nasync function directoryHasFiles(dirPath: string): Promise<boolean> {\n  if (!(await dirExists(dirPath))) {\n    return false;\n  }\n  const files = await fs.readdir(dirPath);\n  return files.length > 0;\n}\n\nfunction validateProjectName(value: string): true | string {\n  const trimmed = value.trim();\n  if (!trimmed) {\n    return \"Project name is required\";\n  }\n\n  // npm package-safe pattern\n  if (!/^[a-z0-9._-]+$/i.test(trimmed)) {\n    return \"Use letters, numbers, hyphens, underscores, or dots\";\n  }\n\n  if (trimmed.startsWith(\".\") || trimmed.startsWith(\"_\")) {\n    return \"Project name cannot start with '.' or '_'\";\n  }\n\n  return true;\n}\n\nfunction validateProjectPathArg(value: string): true | string {\n  const trimmed = value.trim();\n  if (!trimmed) {\n    return \"Project name is required\";\n  }\n\n  const normalized = trimmed.replace(/[\\\\/]+$/, \"\");\n  const baseName = path.basename(normalized);\n  if (!baseName || baseName === \".\" || baseName === \"..\") {\n    return \"Please provide a valid project directory name\";\n  }\n\n  return validateProjectName(baseName);\n}\n\nfunction prettifyTemplateName(name: string): string {\n  return name\n    .split(\"-\")\n    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n    .join(\" \");\n}\n\nasync function getAvailableTemplates(): Promise<string[]> {\n  const templatesRoot = path.join(__dirname, \"..\", \"templates\");\n  const entries = await fs.readdir(templatesRoot, { withFileTypes: true });\n  const templateOrder = Object.keys(templateDetails);\n  return entries\n    .filter((entry) => entry.isDirectory() && !entry.name.startsWith(\"_\"))\n    .map((entry) => entry.name)\n    .sort((left, right) => {\n      const leftIndex = templateOrder.indexOf(left);\n      const rightIndex = templateOrder.indexOf(right);\n      const normalizedLeft = leftIndex === -1 ? Number.MAX_SAFE_INTEGER : leftIndex;\n      const normalizedRight = rightIndex === -1 ? Number.MAX_SAFE_INTEGER : rightIndex;\n      return normalizedLeft - normalizedRight || left.localeCompare(right);\n    });\n}\n\nasync function updatePackageJson(\n  projectPath: string,\n  projectName: string,\n  packageManager: PackageManager,\n) {\n  const packageJsonPath = path.join(projectPath, \"package.json\");\n\n  try {\n    const content = await fs.readFile(packageJsonPath, \"utf-8\");\n    const packageJson = JSON.parse(content);\n\n    packageJson.name = projectName;\n    if (packageManager.version) {\n      packageJson.packageManager = `${packageManager.name}@${packageManager.version}`;\n    }\n\n    await fs.writeFile(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\\n`);\n  } catch {\n    logger.warn(\"Could not update package.json\");\n  }\n}\n\nexport function detectPackageManager(\n  userAgent = process.env.npm_config_user_agent,\n): PackageManager {\n  const match = userAgent?.match(/^(npm|pnpm|yarn|bun)\\/([^\\s]+)/);\n  if (!match) {\n    return { name: \"pnpm\" };\n  }\n\n  const [, name, version] = match;\n  return {\n    name: name as PackageManagerName,\n    version: version === \"?\" ? undefined : version,\n  };\n}\n\nexport function installDependencies(\n  projectPath: string,\n  packageManager: PackageManager,\n): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const command =\n      process.platform === \"win32\" ? `${packageManager.name}.cmd` : packageManager.name;\n    const child = spawn(command, [\"install\"], {\n      cwd: projectPath,\n      env: process.env,\n      stdio: \"inherit\",\n    });\n\n    child.on(\"error\", reject);\n    child.on(\"close\", (code, signal) => {\n      if (code === 0) {\n        resolve();\n        return;\n      }\n\n      const reason = signal ? `signal ${signal}` : `exit code ${code ?? \"unknown\"}`;\n      reject(new Error(`${packageManager.name} install failed with ${reason}.`));\n    });\n  });\n}\n\nfunction getDevCommand(packageManager: PackageManagerName) {\n  if (packageManager === \"npm\" || packageManager === \"bun\") {\n    return `${packageManager} run dev`;\n  }\n  return `${packageManager} dev`;\n}\n"],"mappings":"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"}

package/dist/utils.js

@@ -11,15 +11,17 @@ const logger = {
 };
 function showBanner() {
 	const art = [
-		" _______                         ",
-		"|  ___  |__ _ _ __ _ __ ___     ",
-		"| |_ /| / _` | '__| '_ ` _ \\ ",
-		"|  _ \\| | (_| | |  | | | | | | ",
-		"|_| \\_\\_|\\__,_|_|  |_| |_| |_|"
+		"░██████████   ░███    ░█████████  ░███     ░███         ░█████   ░██████",
+		"░██          ░██░██   ░██     ░██ ░████   ░████           ░██   ░██   ░██",
+		"░██         ░██  ░██  ░██     ░██ ░██░██ ░██░██           ░██  ░██",
+		"░█████████ ░█████████ ░█████████  ░██ ░████ ░██           ░██   ░████████",
+		"░██        ░██    ░██ ░██   ░██   ░██  ░██  ░██     ░██   ░██          ░██",
+		"░██        ░██    ░██ ░██    ░██  ░██       ░██     ░██   ░██   ░██   ░██",
+		"░██        ░██    ░██ ░██     ░██ ░██       ░██ ░██  ░██████     ░██████"
 	];
 	console.log("");
 	for (const line of art) console.log(picocolors.default.cyan(line));
-	console.log(picocolors.default.bold(picocolors.default.green("Create Farm.js App")) + picocolors.default.dim("  modern React meta-framework"));
+	console.log(picocolors.default.bold(picocolors.default.green("Create FARMJS App")) + picocolors.default.dim("  modern React meta-framework"));
 	console.log("");
 }
 //#endregion

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":["pc"],"sources":["../src/utils.ts"],"sourcesContent":["import pc from \"picocolors\";\n\nexport const logger = {\n  info: (message: string) => console.log(`${pc.blue(\"ℹ\")} ${message}`),\n  success: (message: string) => console.log(`${pc.green(\"✓\")} ${message}`),\n  warn: (message: string) => console.warn(`${pc.yellow(\"⚠\")} ${message}`),\n  error: (message: string) => console.error(`${pc.red(\"✗\")} ${message}`),\n};\n\nexport function showBanner() {\n  const art = [\n    \" _______                         \",\n    \"|  ___  |__ _ _ __ _ __ ___     \",\n    \"| |_ /| / _` | '__| '_ ` _ \\\\ \",\n    \"|  _ \\\\| | (_| | |  | | | | | | \",\n    \"|_| \\\\_\\\\_|\\\\__,_|_|  |_| |_| |_|\",\n  ];\n\n  console.log(\"\");\n  for (const line of art) {\n    console.log(pc.cyan(line));\n  }\n  console.log(pc.bold(pc.green(\"Create Farm.js App\")) + pc.dim(\"  modern React meta-framework\"));\n  console.log(\"\");\n}\n"],"mappings":";;;;;AAEA,MAAa,SAAS;CACpB,OAAO,YAAoB,QAAQ,IAAI,GAAGA,WAAAA,QAAG,KAAK,GAAG,EAAE,GAAG,SAAS;CACnE,UAAU,YAAoB,QAAQ,IAAI,GAAGA,WAAAA,QAAG,MAAM,GAAG,EAAE,GAAG,SAAS;CACvE,OAAO,YAAoB,QAAQ,KAAK,GAAGA,WAAAA,QAAG,OAAO,GAAG,EAAE,GAAG,SAAS;CACtE,QAAQ,YAAoB,QAAQ,MAAM,GAAGA,WAAAA,QAAG,IAAI,GAAG,EAAE,GAAG,SAAS;AACvE;AAEA,SAAgB,aAAa;CAC3B,MAAM,MAAM;EACV;EACA;EACA;EACA;EACA;CACF;CAEA,QAAQ,IAAI,EAAE;CACd,KAAK,MAAM,QAAQ,KACjB,QAAQ,IAAIA,WAAAA,QAAG,KAAK,IAAI,CAAC;CAE3B,QAAQ,IAAIA,WAAAA,QAAG,KAAKA,WAAAA,QAAG,MAAM,oBAAoB,CAAC,IAAIA,WAAAA,QAAG,IAAI,+BAA+B,CAAC;CAC7F,QAAQ,IAAI,EAAE;AAChB"}
+{"version":3,"file":"utils.js","names":["pc"],"sources":["../src/utils.ts"],"sourcesContent":["import pc from \"picocolors\";\n\nexport const logger = {\n  info: (message: string) => console.log(`${pc.blue(\"ℹ\")} ${message}`),\n  success: (message: string) => console.log(`${pc.green(\"✓\")} ${message}`),\n  warn: (message: string) => console.warn(`${pc.yellow(\"⚠\")} ${message}`),\n  error: (message: string) => console.error(`${pc.red(\"✗\")} ${message}`),\n};\n\nexport function showBanner() {\n  const art = [\n    \"░██████████   ░███    ░█████████  ░███     ░███         ░█████   ░██████\",\n    \"░██          ░██░██   ░██     ░██ ░████   ░████           ░██   ░██   ░██\",\n    \"░██         ░██  ░██  ░██     ░██ ░██░██ ░██░██           ░██  ░██\",\n    \"░█████████ ░█████████ ░█████████  ░██ ░████ ░██           ░██   ░████████\",\n    \"░██        ░██    ░██ ░██   ░██   ░██  ░██  ░██     ░██   ░██          ░██\",\n    \"░██        ░██    ░██ ░██    ░██  ░██       ░██     ░██   ░██   ░██   ░██\",\n    \"░██        ░██    ░██ ░██     ░██ ░██       ░██ ░██  ░██████     ░██████\",\n  ];\n\n  console.log(\"\");\n  for (const line of art) {\n    console.log(pc.cyan(line));\n  }\n  console.log(pc.bold(pc.green(\"Create FARMJS App\")) + pc.dim(\"  modern React meta-framework\"));\n  console.log(\"\");\n}\n"],"mappings":";;;;;AAEA,MAAa,SAAS;CACpB,OAAO,YAAoB,QAAQ,IAAI,GAAGA,WAAAA,QAAG,KAAK,GAAG,EAAE,GAAG,SAAS;CACnE,UAAU,YAAoB,QAAQ,IAAI,GAAGA,WAAAA,QAAG,MAAM,GAAG,EAAE,GAAG,SAAS;CACvE,OAAO,YAAoB,QAAQ,KAAK,GAAGA,WAAAA,QAAG,OAAO,GAAG,EAAE,GAAG,SAAS;CACtE,QAAQ,YAAoB,QAAQ,MAAM,GAAGA,WAAAA,QAAG,IAAI,GAAG,EAAE,GAAG,SAAS;AACvE;AAEA,SAAgB,aAAa;CAC3B,MAAM,MAAM;EACV;EACA;EACA;EACA;EACA;EACA;EACA;CACF;CAEA,QAAQ,IAAI,EAAE;CACd,KAAK,MAAM,QAAQ,KACjB,QAAQ,IAAIA,WAAAA,QAAG,KAAK,IAAI,CAAC;CAE3B,QAAQ,IAAIA,WAAAA,QAAG,KAAKA,WAAAA,QAAG,MAAM,mBAAmB,CAAC,IAAIA,WAAAA,QAAG,IAAI,+BAA+B,CAAC;CAC5F,QAAQ,IAAI,EAAE;AAChB"}

package/dist/utils.mjs

@@ -8,15 +8,17 @@ const logger = {
 };
 function showBanner() {
 	const art = [
-		" _______                         ",
-		"|  ___  |__ _ _ __ _ __ ___     ",
-		"| |_ /| / _` | '__| '_ ` _ \\ ",
-		"|  _ \\| | (_| | |  | | | | | | ",
-		"|_| \\_\\_|\\__,_|_|  |_| |_| |_|"
+		"░██████████   ░███    ░█████████  ░███     ░███         ░█████   ░██████",
+		"░██          ░██░██   ░██     ░██ ░████   ░████           ░██   ░██   ░██",
+		"░██         ░██  ░██  ░██     ░██ ░██░██ ░██░██           ░██  ░██",
+		"░█████████ ░█████████ ░█████████  ░██ ░████ ░██           ░██   ░████████",
+		"░██        ░██    ░██ ░██   ░██   ░██  ░██  ░██     ░██   ░██          ░██",
+		"░██        ░██    ░██ ░██    ░██  ░██       ░██     ░██   ░██   ░██   ░██",
+		"░██        ░██    ░██ ░██     ░██ ░██       ░██ ░██  ░██████     ░██████"
 	];
 	console.log("");
 	for (const line of art) console.log(pc.cyan(line));
-	console.log(pc.bold(pc.green("Create Farm.js App")) + pc.dim("  modern React meta-framework"));
+	console.log(pc.bold(pc.green("Create FARMJS App")) + pc.dim("  modern React meta-framework"));
 	console.log("");
 }
 //#endregion

package/dist/utils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.mjs","names":[],"sources":["../src/utils.ts"],"sourcesContent":["import pc from \"picocolors\";\n\nexport const logger = {\n  info: (message: string) => console.log(`${pc.blue(\"ℹ\")} ${message}`),\n  success: (message: string) => console.log(`${pc.green(\"✓\")} ${message}`),\n  warn: (message: string) => console.warn(`${pc.yellow(\"⚠\")} ${message}`),\n  error: (message: string) => console.error(`${pc.red(\"✗\")} ${message}`),\n};\n\nexport function showBanner() {\n  const art = [\n    \" _______                         \",\n    \"|  ___  |__ _ _ __ _ __ ___     \",\n    \"| |_ /| / _` | '__| '_ ` _ \\\\ \",\n    \"|  _ \\\\| | (_| | |  | | | | | | \",\n    \"|_| \\\\_\\\\_|\\\\__,_|_|  |_| |_| |_|\",\n  ];\n\n  console.log(\"\");\n  for (const line of art) {\n    console.log(pc.cyan(line));\n  }\n  console.log(pc.bold(pc.green(\"Create Farm.js App\")) + pc.dim(\"  modern React meta-framework\"));\n  console.log(\"\");\n}\n"],"mappings":";;AAEA,MAAa,SAAS;CACpB,OAAO,YAAoB,QAAQ,IAAI,GAAG,GAAG,KAAK,GAAG,EAAE,GAAG,SAAS;CACnE,UAAU,YAAoB,QAAQ,IAAI,GAAG,GAAG,MAAM,GAAG,EAAE,GAAG,SAAS;CACvE,OAAO,YAAoB,QAAQ,KAAK,GAAG,GAAG,OAAO,GAAG,EAAE,GAAG,SAAS;CACtE,QAAQ,YAAoB,QAAQ,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,GAAG,SAAS;AACvE;AAEA,SAAgB,aAAa;CAC3B,MAAM,MAAM;EACV;EACA;EACA;EACA;EACA;CACF;CAEA,QAAQ,IAAI,EAAE;CACd,KAAK,MAAM,QAAQ,KACjB,QAAQ,IAAI,GAAG,KAAK,IAAI,CAAC;CAE3B,QAAQ,IAAI,GAAG,KAAK,GAAG,MAAM,oBAAoB,CAAC,IAAI,GAAG,IAAI,+BAA+B,CAAC;CAC7F,QAAQ,IAAI,EAAE;AAChB"}
+{"version":3,"file":"utils.mjs","names":[],"sources":["../src/utils.ts"],"sourcesContent":["import pc from \"picocolors\";\n\nexport const logger = {\n  info: (message: string) => console.log(`${pc.blue(\"ℹ\")} ${message}`),\n  success: (message: string) => console.log(`${pc.green(\"✓\")} ${message}`),\n  warn: (message: string) => console.warn(`${pc.yellow(\"⚠\")} ${message}`),\n  error: (message: string) => console.error(`${pc.red(\"✗\")} ${message}`),\n};\n\nexport function showBanner() {\n  const art = [\n    \"░██████████   ░███    ░█████████  ░███     ░███         ░█████   ░██████\",\n    \"░██          ░██░██   ░██     ░██ ░████   ░████           ░██   ░██   ░██\",\n    \"░██         ░██  ░██  ░██     ░██ ░██░██ ░██░██           ░██  ░██\",\n    \"░█████████ ░█████████ ░█████████  ░██ ░████ ░██           ░██   ░████████\",\n    \"░██        ░██    ░██ ░██   ░██   ░██  ░██  ░██     ░██   ░██          ░██\",\n    \"░██        ░██    ░██ ░██    ░██  ░██       ░██     ░██   ░██   ░██   ░██\",\n    \"░██        ░██    ░██ ░██     ░██ ░██       ░██ ░██  ░██████     ░██████\",\n  ];\n\n  console.log(\"\");\n  for (const line of art) {\n    console.log(pc.cyan(line));\n  }\n  console.log(pc.bold(pc.green(\"Create FARMJS App\")) + pc.dim(\"  modern React meta-framework\"));\n  console.log(\"\");\n}\n"],"mappings":";;AAEA,MAAa,SAAS;CACpB,OAAO,YAAoB,QAAQ,IAAI,GAAG,GAAG,KAAK,GAAG,EAAE,GAAG,SAAS;CACnE,UAAU,YAAoB,QAAQ,IAAI,GAAG,GAAG,MAAM,GAAG,EAAE,GAAG,SAAS;CACvE,OAAO,YAAoB,QAAQ,KAAK,GAAG,GAAG,OAAO,GAAG,EAAE,GAAG,SAAS;CACtE,QAAQ,YAAoB,QAAQ,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,GAAG,SAAS;AACvE;AAEA,SAAgB,aAAa;CAC3B,MAAM,MAAM;EACV;EACA;EACA;EACA;EACA;EACA;EACA;CACF;CAEA,QAAQ,IAAI,EAAE;CACd,KAAK,MAAM,QAAQ,KACjB,QAAQ,IAAI,GAAG,KAAK,IAAI,CAAC;CAE3B,QAAQ,IAAI,GAAG,KAAK,GAAG,MAAM,mBAAmB,CAAC,IAAI,GAAG,IAAI,+BAA+B,CAAC;CAC5F,QAAQ,IAAI,EAAE;AAChB"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@farm.js/create-app",
-  "version": "0.1.0-beta.20",
-  "description": "Create a new Farm.js application",
+  "version": "0.1.0-beta.22",
+  "description": "Create a new FARMJS application",
   "keywords": [
     "@farm.js/create-app",
     "create-app",

package/templates/auth/.env.example

@@ -0,0 +1,6 @@
+# FARMJS Auth needs no environment variables in local development.
+# Configure these values in the production deployment environment.
+
+# FARM_AUTH_URL=https://your-app.example.com
+# FARM_AUTH_SECRET=replace-with-a-random-secret-at-least-32-characters
+# DATABASE_URL=postgresql://user:password@your-postgres-host/database?sslmode=require

package/templates/auth/README.md

@@ -0,0 +1,95 @@
+# FARMJS Auth Starter
+
+A standalone email/password authentication starter using FARMJS built-in authentication and
+React.
+
+This project was generated from the FARMJS Auth template included with `@farm.js/create-app`.
+
+## Included
+
+- email/password sign-up and sign-in enabled by `auth: true`
+- database-backed, HTTP-only session cookies
+- a server-middleware-protected `/dashboard`
+- `@farm.js/auth/server` request helpers and the `@farm.js/auth/client` React hook
+- automatic local SQLite storage in `.farm/auth.sqlite`
+- production Postgres support through `DATABASE_URL`
+- a dark-first, one-page welcome screen set in Geist Sans and Geist Mono
+- pending, error, unauthorized, loading, and not-found states
+- exact FARMJS beta dependencies for reproducible installs
+
+## Quick start
+
+```bash
+pnpm create @farm.js/app@beta my-app --template auth --typescript
+cd my-app
+pnpm dev
+```
+
+Open [http://localhost:3000](http://localhost:3000), create an account, and continue to the
+protected dashboard. Local development needs no database or auth environment variables; FARMJS Auth
+creates and migrates `.farm/auth.sqlite` when auth is first used.
+
+## How it is wired
+
+- [`farm.config.ts`](./farm.config.ts) enables email/password authentication with `auth: true`.
+- [`src/app/page.tsx`](./src/app/page.tsx) reads the current session with
+  `auth.session()` from `@farm.js/auth/server`.
+- [`src/components/auth-form.tsx`](./src/components/auth-form.tsx) uses the built-in `signIn` and
+  `signUp` client functions.
+- [`src/app/dashboard/middleware.ts`](./src/app/dashboard/middleware.ts) redirects anonymous
+  requests before the dashboard route runs.
+- [`src/app/dashboard/page.tsx`](./src/app/dashboard/page.tsx) uses the built-in `useAuth` React
+  hook to render the current account and session.
+
+FARMJS owns the auth action routes, so the starter does not need an app-local Better Auth instance,
+client factory, database pool, or catch-all API route:
+
+```text
+/api/auth/*
+```
+
+## Production environment
+
+Local development uses safe defaults. Production requires these deployment environment variables:
+
+| Variable           | Purpose                                                     |
+| ------------------ | ----------------------------------------------------------- |
+| `FARM_AUTH_URL`    | Public application origin; inferred automatically on Vercel |
+| `FARM_AUTH_SECRET` | Random secret used to sign and encrypt auth data            |
+| `DATABASE_URL`     | Postgres connection string                                  |
+
+Generate a production secret with:
+
+```bash
+openssl rand -base64 32
+```
+
+Loading `farm.config.ts` and running `farm build` do not connect to the database. Apply the
+production auth schema before serving traffic:
+
+```bash
+pnpm auth:migrate
+```
+
+The FARMJS deployment target is configured in [`farm.config.ts`](./farm.config.ts) for Vercel.
+
+## Advanced authentication
+
+`auth: true` intentionally owns the common email/password path. If an application needs Better Auth
+plugins, adapters, social providers, or callbacks, replace the top-level auth option with an
+app-owned `integrations.auth` configuration using `@farm.js/better-auth`.
+
+## Commands
+
+```bash
+pnpm dev          # start the development server
+pnpm type-check   # run TypeScript checks
+pnpm build        # create the production build without connecting to the database
+pnpm check        # type-check and build
+pnpm auth:migrate # apply the production auth schema
+pnpm run deploy -- --prod
+```
+
+## License
+
+MIT

package/templates/auth/farm.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from "@farm.js/core";
+
+export default defineConfig({
+  auth: true,
+  experimental: {
+    serverComponents: true,
+  },
+  deploy: {
+    target: "vercel",
+  },
+});

package/templates/auth/gitignore

@@ -0,0 +1,10 @@
+node_modules
+.farm
+.vercel
+.data
+.env
+.env.local
+.env.*.local
+dist
+*.log
+.DS_Store

package/templates/auth/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "farmjs-auth-starter",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "farm dev",
+    "build": "farm build",
+    "auth:migrate": "farm auth migrate",
+    "check": "pnpm type-check && pnpm build",
+    "deploy": "farm deploy",
+    "start": "farm start",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@farm.js/auth": "0.1.0-beta.22",
+    "@farm.js/core": "0.1.0-beta.22",
+    "@fontsource-variable/geist": "5.3.0",
+    "@fontsource-variable/geist-mono": "5.3.0",
+    "better-call": "1.3.2",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@farm.js/cli": "0.1.0-beta.22",
+    "@types/node": "20.19.9",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "tailwindcss": "^4.0.0",
+    "typescript": "^5.3.3"
+  },
+  "packageManager": "pnpm@11.18.0"
+}

package/templates/auth/pnpm-workspace.yaml

@@ -0,0 +1,13 @@
+packages:
+  - "."
+
+allowBuilds:
+  "@prisma/client": true
+  better-sqlite3: true
+  esbuild: true
+  sharp: true
+  vue-demi: true
+minimumReleaseAgeExclude:
+  - "@farm.js/auth"
+  - "@farm.js/cli"
+  - "@farm.js/core"

package/templates/auth/src/app/dashboard/middleware.ts

@@ -0,0 +1,13 @@
+import { auth } from "@farm.js/auth/server";
+
+export const config = {
+  runtime: "nodejs" as const,
+};
+
+export async function middleware(request: Request) {
+  const user = await auth.user({ request });
+
+  if (!user) {
+    return Response.redirect(new URL("/sign-in", request.url), 307);
+  }
+}