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

package/README.md

@@ -1,16 +1,49 @@
 # @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 --config.minimumReleaseAge=0 create @farm.js/app@beta my-app --template basic
 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 FARMJS, React by default, 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.
+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.
 
-See the [Farm.js repository](https://github.com/farming-labs/farm.js) for documentation, examples, and support.
+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
+```
+
+React remains the default when `--renderer` is omitted. The interactive Basic and Better Auth
+flows also offer a renderer chooser.
+
+List every starter:
+
+```bash
+pnpm --config.minimumReleaseAge=0 create @farm.js/app@beta --list-templates
+```
+
+Available templates:
+
+- Core: `basic`, `auth`, `better-auth`
+- Auth: `auth0`, `authjs`, `clerk`, `supabase`, `workos`
+- Billing: `autumn`, `polar`, `stripe`
+- Product integrations: `ai`, `jobs-inngest`, `jobs-trigger`, `resend`, `unkey`
+
+Integration templates include provider wiring, a local UI feature, `.env.example`, a minimal dark
+home page, and setup documentation. Better Auth has renderer-native UI for all five renderers;
+other integration templates currently use React. For example:
+
+```bash
+pnpm --config.minimumReleaseAge=0 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/bin/create-farm-app.js

@@ -6,15 +6,20 @@ 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")
-  .option("--typescript", "Use TypeScript template")
+  .option(
+    "-r, --renderer <renderer>",
+    "Rendering library to use (react, preact, solid, vue, or svelte)",
+  )
+  .option("--list-templates", "List all available starter templates")
+  .option("--typescript", "TypeScript is included by default (deprecated)")
   .option("--skip-install", "Skip installing dependencies")
   .action(async (projectName, options) => {
     try {
-      await createApp(projectName, options);
+      await createApp(projectName, { ...options, telemetryPackageVersion: version });
     } catch (error) {
       console.error("Failed to create app:", error);
       process.exit(1);