@farm.js/create-app 0.1.0-beta.100 → 0.1.0-beta.102

package/README.md

@@ -5,7 +5,7 @@ Create a new FARMJS application
 FARMJS is currently in beta.
 
 ```bash
-pnpm --config.minimumReleaseAge=0 create @farm.js/app@beta my-app --template basic
+PNPM_CONFIG_DLX_CACHE_MAX_AGE=0 PNPM_CONFIG_MINIMUM_RELEASE_AGE_EXCLUDE='["@farm.js/*"]' pnpm create @farm.js/app@beta my-app --template basic
 cd my-app
 pnpm dev
 ```
@@ -15,13 +15,24 @@ automatically. Every starter also registers the official
 [`@farm.js/devtools`](https://farmjs.dev/docs/plugins/devtools) workspace, available at
 `/__farm/devtools` (or `Command/Ctrl + Shift + .`) during `pnpm dev`. 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.
-The command scopes `minimumReleaseAge=0` to the initializer so pnpm 11 can resolve a beta published
-within the last 24 hours. Pass `--skip-install` when you only want to generate the project files.
+`PNPM_CONFIG_DLX_CACHE_MAX_AGE=0` refreshes pnpm's one-day `create`/`dlx` cache so the `beta`
+dist-tag is resolved on every run. `PNPM_CONFIG_MINIMUM_RELEASE_AGE_EXCLUDE` keeps pnpm's default
+release-age protection enabled for third-party packages while allowing newly published
+`@farm.js/*` betas. Generated pnpm projects preserve that scoped exclusion. Pass `--skip-install`
+when you only want to generate the project files.
+
+In PowerShell, set the same variables before running the command:
+
+```powershell
+$env:PNPM_CONFIG_DLX_CACHE_MAX_AGE = "0"
+$env:PNPM_CONFIG_MINIMUM_RELEASE_AGE_EXCLUDE = '["@farm.js/*"]'
+pnpm create @farm.js/app@beta my-app --template basic
+```
 
 Choose React, Preact, Solid, Vue, or Svelte for the Basic and Better Auth starters:
 
 ```bash
-pnpm --config.minimumReleaseAge=0 create @farm.js/app@beta my-app --template better-auth --renderer solid
+PNPM_CONFIG_DLX_CACHE_MAX_AGE=0 PNPM_CONFIG_MINIMUM_RELEASE_AGE_EXCLUDE='["@farm.js/*"]' pnpm create @farm.js/app@beta my-app --template better-auth --renderer solid
 ```
 
 React remains the default when `--renderer` is omitted. The interactive Basic and Better Auth
@@ -30,7 +41,7 @@ flows also offer a renderer chooser.
 List every starter:
 
 ```bash
-pnpm --config.minimumReleaseAge=0 create @farm.js/app@beta --list-templates
+PNPM_CONFIG_DLX_CACHE_MAX_AGE=0 PNPM_CONFIG_MINIMUM_RELEASE_AGE_EXCLUDE='["@farm.js/*"]' pnpm create @farm.js/app@beta --list-templates
 ```
 
 Available templates:
@@ -45,7 +56,7 @@ home page, and setup documentation. Better Auth has renderer-native UI for all f
 other integration templates currently use React. For example:
 
 ```bash
-pnpm --config.minimumReleaseAge=0 create @farm.js/app@beta stripe-app --template stripe
+PNPM_CONFIG_DLX_CACHE_MAX_AGE=0 PNPM_CONFIG_MINIMUM_RELEASE_AGE_EXCLUDE='["@farm.js/*"]' pnpm create @farm.js/app@beta stripe-app --template stripe
 ```
 
 See the [FARMJS repository](https://github.com/farming-labs/farm.js) for documentation, examples, and support.

package/dist/index.js

@@ -3164,6 +3164,7 @@ async function createApp(projectName, options = {}) {
 	await fs_promises.default.mkdir(projectPath, { recursive: true });
 	const integrationResult = await copyTemplate(template, projectPath, renderer);
 	await updatePackageJson(projectPath, projectName, packageManager);
+	await updatePackageManagerInstructions(projectPath, packageManager.name);
 	require_utils.logger.success(`🚜 Created ${projectName}`);
 	if (!options.skipInstall) {
 		require_utils.logger.info(`Installing dependencies with ${packageManager.name}...`);
@@ -3176,7 +3177,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("");
-	for (const instruction of templateDetails[template]?.instructions ?? []) require_utils.logger.info(instruction);
+	for (const instruction of templateDetails[template]?.instructions ?? []) require_utils.logger.info(rewritePackageManagerCommands(instruction, packageManager.name));
 	if (integrationResult) {
 		const details = templateDetails[template].integration;
 		require_utils.logger.info(`Open ${details.route} for the ${details.label} starter.`);
@@ -3217,6 +3218,14 @@ async function copyTemplate(template, projectPath, renderer) {
 }
 async function applyRendererTemplate(projectPath, renderer, basePackageJson) {
 	const rendererTemplatePath = path.default.join(__dirname, "..", "templates", "_renderers", renderer);
+	await Promise.all([
+		fs_promises.default.rm(path.default.join(projectPath, "docs.config.ts"), { force: true }),
+		fs_promises.default.rm(path.default.join(projectPath, "docs.json"), { force: true }),
+		fs_promises.default.rm(path.default.join(projectPath, "src", "app", "docs"), {
+			recursive: true,
+			force: true
+		})
+	]);
 	if (renderer === "vue" || renderer === "svelte") await Promise.all([
 		fs_promises.default.rm(path.default.join(projectPath, "src", "app", "page.tsx"), { force: true }),
 		fs_promises.default.rm(path.default.join(projectPath, "src", "app", "layout.tsx"), { force: true }),
@@ -3234,7 +3243,13 @@ function mergeRendererPackageJson(base, renderer) {
 		...base.devDependencies,
 		...renderer.devDependencies
 	};
-	for (const name of ["react", "react-dom"]) delete dependencies[name];
+	for (const name of [
+		"@farming-labs/docs",
+		"@farming-labs/farmjs",
+		"@farming-labs/theme",
+		"react",
+		"react-dom"
+	]) delete dependencies[name];
 	for (const name of ["@types/react", "@types/react-dom"]) delete devDependencies[name];
 	return {
 		...base,
@@ -3460,6 +3475,35 @@ function getDevCommand(packageManager) {
 	if (packageManager === "npm" || packageManager === "bun") return `${packageManager} run dev`;
 	return `${packageManager} dev`;
 }
+function getRunCommand(packageManager, script) {
+	if (packageManager === "npm" || packageManager === "bun") return `${packageManager} run ${script}`;
+	return `${packageManager} ${script}`;
+}
+function rewritePackageManagerCommands(content, packageManager) {
+	let output = content.replace(/\bpnpm install\b/g, `${packageManager} install`);
+	output = output.replace(/\bpnpm run (dev|auth:migrate|type-check|build|check|deploy|experiment)\b/g, (match, script) => packageManager === "pnpm" ? match : getRunCommand(packageManager, script));
+	return output.replace(/\bpnpm (dev|auth:migrate|type-check|build|check|deploy|experiment)\b/g, (_match, script) => getRunCommand(packageManager, script));
+}
+async function updatePackageManagerInstructions(projectPath, packageManager) {
+	await Promise.all([
+		"package.json",
+		"README.md",
+		"farm.config.ts",
+		"src/app/page.tsx",
+		"src/app/page.jsx",
+		"src/app/page.vue",
+		"src/app/page.svelte"
+	].map(async (file) => {
+		const entryPath = path.default.join(projectPath, file);
+		try {
+			const content = await fs_promises.default.readFile(entryPath, "utf8");
+			const nextContent = rewritePackageManagerCommands(content, packageManager);
+			if (nextContent !== content) await fs_promises.default.writeFile(entryPath, nextContent, "utf8");
+		} catch (error) {
+			if (error.code !== "ENOENT") throw error;
+		}
+	}));
+}
 //#endregion
 exports.createApp = createApp;
 exports.detectPackageManager = detectPackageManager;