@tanstack/create 0.63.8 → 0.64.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @tanstack/create
 
+## 0.64.0
+
+### Minor Changes
+
+- feat(cli): auto-install TanStack Intent during scaffolding ([#442](https://github.com/TanStack/cli/pull/442))
+
+  `tanstack create` and `tanstack add` now run `npx @tanstack/intent install`
+  after dependency installation, wiring up skill mappings for coding agents.
+  The behavior is controlled by a new `--intent` / `--no-intent` flag (default
+  on) and persists to `.cta.json` so subsequent `add` invocations honor the
+  original choice. Failures are surfaced as warnings instead of aborting the
+  scaffold.
+
+## 0.63.9
+
+### Patch Changes
+
+- fix(create): correct netlify.toml key, eslint scripts, and missing eslint dep ([`e38729f`](https://github.com/TanStack/cli/commit/e38729fe0b6a16e8d34417d2334baf2b2db94942))
+
+  - The generated `netlify.toml` for both React and Solid used `dir` under
+    `[build]`, which is not a valid Netlify configuration key. Per Netlify's
+    TanStack Start guide it must be `publish`. Closes #423.
+  - The eslint toolchain had `format` and `check` scripts swapped: `format`
+    ran prettier in read-only mode while `check` mutated files. Swap them so
+    `format` writes (`prettier --write . && eslint --fix`) and `check` is
+    read-only (`prettier --check .`). Closes #403.
+  - `@tanstack/eslint-config` lists `eslint` as a peer dependency, so eslint
+    was not installed by package managers that don't auto-install peers. Add
+    `eslint` to `devDependencies` in the eslint toolchain. Closes #417.
+
 ## 0.63.8
 
 ### Patch Changes

package/dist/add-to-app.js

@@ -11,6 +11,7 @@ import { isBase64, recursivelyGatherFilesFromEnvironment, } from './file-helpers
 import { mergePackageJSON } from './package-json.js';
 import { runSpecialSteps } from './special-steps/index.js';
 import { loadStarter } from './custom-add-ons/starter.js';
+import { setupIntent } from './integrations/intent.js';
 export async function hasPendingGitChanges(environment, cwd) {
     const { stdout } = await environment.execute('git', ['status', '--porcelain'], cwd);
     return stdout.length > 0;
@@ -29,6 +30,7 @@ async function createOptions(json, addOns, targetDir) {
         ]),
         targetDir,
         starter,
+        intent: json.intent ?? false,
     };
 }
 async function runCreateApp(options) {
@@ -203,6 +205,9 @@ export async function addToApp(environment, addOns, cwd, options) {
     }
     // Handle new commands
     await runNewCommands(environment, persistedOptions, cwd, output);
+    const intent = options?.intent ?? persistedOptions.intent ?? true;
+    newOptions.intent = intent;
+    await setupIntent(environment, cwd, newOptions);
     environment.startStep({
         id: 'write-config-file',
         type: 'file',

package/dist/create-app.js

@@ -8,6 +8,7 @@ import { resolvePackageJSONLatest } from './npm-resolver.js';
 import { createTemplateFile } from './template-file.js';
 import { installShadcnComponents } from './integrations/shadcn.js';
 import { setupGit } from './integrations/git.js';
+import { setupIntent } from './integrations/intent.js';
 import { runSpecialSteps } from './special-steps/index.js';
 function isDemoFilePath(path) {
     if (!path)
@@ -214,6 +215,7 @@ async function runCommandsAndInstallDependencies(environment, options) {
         s.stop(`${options.starter.name} commands complete`);
     }
     await installShadcnComponents(environment, options.targetDir, options);
+    await setupIntent(environment, options.targetDir, options);
 }
 async function seedEnvValues(environment, options) {
     const envVarValues = options.envVarValues || {};

package/dist/custom-add-ons/shared.js

@@ -60,6 +60,7 @@ export async function createAppOptionsFromPersisted(json) {
         starter: json.starter ? await loadStarter(json.starter) : undefined,
         chosenAddOns,
         addOnOptions: populateAddOnOptionsDefaults(chosenAddOns),
+        intent: json.intent ?? false,
     };
 }
 export function createSerializedOptionsFromPersisted(json) {
@@ -78,6 +79,7 @@ export function createSerializedOptionsFromPersisted(json) {
         framework: json.framework,
         starter: json.starter,
         addOnOptions: {},
+        intent: json.intent ?? false,
     };
 }
 export async function runCreateApp(options) {

package/dist/frameworks/react/hosts/netlify/assets/netlify.toml

@@ -1,6 +1,6 @@
 [build]
   command = "vite build"
-  dir = "dist/client"
+  publish = "dist/client"
 [dev]
   command = "npm run dev"
   targetPort = 3000

package/dist/frameworks/react/toolchains/eslint/package.json

@@ -1,11 +1,12 @@
 {
   "scripts": {
     "lint": "eslint",
-    "format": "prettier --check .",
-    "check": "prettier --write . && eslint --fix"
+    "format": "prettier --write . && eslint --fix",
+    "check": "prettier --check ."
   },
   "devDependencies": {
     "@tanstack/eslint-config": "latest",
+    "eslint": "^9.20.0",
     "prettier": "^3.8.1"
   }
 }

package/dist/frameworks/solid/hosts/netlify/assets/netlify.toml

@@ -1,6 +1,6 @@
 [build]
   command = "vite build"
-  dir = "dist/client"
+  publish = "dist/client"
 [dev]
   command = "npm run dev"
   targetPort = 3000

package/dist/frameworks/solid/toolchains/eslint/package.json

@@ -1,11 +1,12 @@
 {
   "scripts": {
     "lint": "eslint",
-    "format": "prettier --check .",
-    "check": "prettier --write . && eslint --fix"
+    "format": "prettier --write . && eslint --fix",
+    "check": "prettier --check ."
   },
   "devDependencies": {
     "@tanstack/eslint-config": "latest",
+    "eslint": "^9.20.0",
     "prettier": "^3.8.1"
   }
 }

package/dist/integrations/intent.js

@@ -0,0 +1,25 @@
+import { resolve } from 'node:path';
+import { packageManagerExecute } from '../package-manager.js';
+export async function setupIntent(environment, targetDir, options) {
+    if (!options.intent) {
+        return;
+    }
+    const s = environment.spinner();
+    s.start('Setting up TanStack Intent skill mappings...');
+    environment.startStep({
+        id: 'setup-intent',
+        type: 'command',
+        message: 'Setting up TanStack Intent skill mappings...',
+    });
+    try {
+        await packageManagerExecute(environment, resolve(targetDir), options.packageManager, '@tanstack/intent', ['install']);
+        environment.finishStep('setup-intent', 'TanStack Intent configured');
+        s.stop('TanStack Intent configured');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        environment.finishStep('setup-intent', `TanStack Intent setup skipped: ${message}`);
+        s.stop('TanStack Intent setup skipped');
+        environment.warn('TanStack Intent setup failed', `Continuing without it. You can run it later with: npx @tanstack/intent install\n\n${message}`);
+    }
+}

package/dist/types/add-to-app.d.ts

@@ -14,4 +14,5 @@ export declare function runNewCommands(environment: Environment, originalOptions
 }): Promise<void>;
 export declare function addToApp(environment: Environment, addOns: Array<string>, cwd: string, options?: {
     forced?: boolean;
+    intent?: boolean;
 }): Promise<void>;

package/dist/types/integrations/intent.d.ts

@@ -0,0 +1,2 @@
+import type { Environment, Options } from '../types.js';
+export declare function setupIntent(environment: Environment, targetDir: string, options: Options): Promise<void>;

package/dist/types/types.d.ts

@@ -1461,6 +1461,7 @@ export interface Options {
     packageManager: PackageManager;
     git: boolean;
     install?: boolean;
+    intent: boolean;
     chosenAddOns: Array<AddOn>;
     addOnOptions: Record<string, Record<string, any>>;
     starter?: Starter | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/create",
-  "version": "0.63.8",
+  "version": "0.64.0",
   "description": "TanStack Application Builder Engine",
   "type": "module",
   "main": "./dist/index.js",

package/src/add-to-app.ts

@@ -18,6 +18,7 @@ import {
 import { mergePackageJSON } from './package-json.js'
 import { runSpecialSteps } from './special-steps/index.js'
 import { loadStarter } from './custom-add-ons/starter.js'
+import { setupIntent } from './integrations/intent.js'
 
 import type { Environment, Options } from './types.js'
 import type { PersistedOptions } from './config-file.js'
@@ -54,6 +55,7 @@ async function createOptions(
     ]),
     targetDir,
     starter,
+    intent: json.intent ?? false,
   } as Options
 }
 
@@ -230,6 +232,7 @@ export async function addToApp(
   cwd: string,
   options?: {
     forced?: boolean
+    intent?: boolean
   },
 ) {
   const persistedOptions = await getCurrentConfiguration(environment, cwd)
@@ -318,6 +321,10 @@ export async function addToApp(
 
   await runNewCommands(environment, persistedOptions, cwd, output)
 
+  const intent = options?.intent ?? persistedOptions.intent ?? true
+  newOptions.intent = intent
+  await setupIntent(environment, cwd, newOptions)
+
   environment.startStep({
     id: 'write-config-file',
     type: 'file',

package/src/create-app.ts

@@ -13,6 +13,7 @@ import { resolvePackageJSONLatest } from './npm-resolver.js'
 import { createTemplateFile } from './template-file.js'
 import { installShadcnComponents } from './integrations/shadcn.js'
 import { setupGit } from './integrations/git.js'
+import { setupIntent } from './integrations/intent.js'
 import { runSpecialSteps } from './special-steps/index.js'
 
 import type { Environment, FileBundleHandler, Options } from './types.js'
@@ -294,6 +295,8 @@ async function runCommandsAndInstallDependencies(
   }
 
   await installShadcnComponents(environment, options.targetDir, options)
+
+  await setupIntent(environment, options.targetDir, options)
 }
 
 async function seedEnvValues(environment: Environment, options: Options) {

package/src/custom-add-ons/shared.ts

@@ -82,6 +82,7 @@ export async function createAppOptionsFromPersisted(
     starter: json.starter ? await loadStarter(json.starter) : undefined,
     chosenAddOns,
     addOnOptions: populateAddOnOptionsDefaults(chosenAddOns),
+    intent: json.intent ?? false,
   }
 }
 
@@ -103,6 +104,7 @@ export function createSerializedOptionsFromPersisted(
     framework: json.framework,
     starter: json.starter,
     addOnOptions: {},
+    intent: json.intent ?? false,
   }
 }
 

package/src/frameworks/react/hosts/netlify/assets/netlify.toml

@@ -1,6 +1,6 @@
 [build]
   command = "vite build"
-  dir = "dist/client"
+  publish = "dist/client"
 [dev]
   command = "npm run dev"
   targetPort = 3000

package/src/frameworks/react/toolchains/eslint/package.json

@@ -1,11 +1,12 @@
 {
   "scripts": {
     "lint": "eslint",
-    "format": "prettier --check .",
-    "check": "prettier --write . && eslint --fix"
+    "format": "prettier --write . && eslint --fix",
+    "check": "prettier --check ."
   },
   "devDependencies": {
     "@tanstack/eslint-config": "latest",
+    "eslint": "^9.20.0",
     "prettier": "^3.8.1"
   }
 }

package/src/frameworks/solid/hosts/netlify/assets/netlify.toml

@@ -1,6 +1,6 @@
 [build]
   command = "vite build"
-  dir = "dist/client"
+  publish = "dist/client"
 [dev]
   command = "npm run dev"
   targetPort = 3000

package/src/frameworks/solid/toolchains/eslint/package.json

@@ -1,11 +1,12 @@
 {
   "scripts": {
     "lint": "eslint",
-    "format": "prettier --check .",
-    "check": "prettier --write . && eslint --fix"
+    "format": "prettier --write . && eslint --fix",
+    "check": "prettier --check ."
   },
   "devDependencies": {
     "@tanstack/eslint-config": "latest",
+    "eslint": "^9.20.0",
     "prettier": "^3.8.1"
   }
 }

package/src/integrations/intent.ts

@@ -0,0 +1,47 @@
+import { resolve } from 'node:path'
+
+import { packageManagerExecute } from '../package-manager.js'
+
+import type { Environment, Options } from '../types.js'
+
+export async function setupIntent(
+  environment: Environment,
+  targetDir: string,
+  options: Options,
+) {
+  if (!options.intent) {
+    return
+  }
+
+  const s = environment.spinner()
+  s.start('Setting up TanStack Intent skill mappings...')
+  environment.startStep({
+    id: 'setup-intent',
+    type: 'command',
+    message: 'Setting up TanStack Intent skill mappings...',
+  })
+
+  try {
+    await packageManagerExecute(
+      environment,
+      resolve(targetDir),
+      options.packageManager,
+      '@tanstack/intent',
+      ['install'],
+    )
+    environment.finishStep('setup-intent', 'TanStack Intent configured')
+    s.stop('TanStack Intent configured')
+  } catch (error) {
+    const message =
+      error instanceof Error ? error.message : 'Unknown error'
+    environment.finishStep(
+      'setup-intent',
+      `TanStack Intent setup skipped: ${message}`,
+    )
+    s.stop('TanStack Intent setup skipped')
+    environment.warn(
+      'TanStack Intent setup failed',
+      `Continuing without it. You can run it later with: npx @tanstack/intent install\n\n${message}`,
+    )
+  }
+}

package/src/types.ts

@@ -214,6 +214,7 @@ export interface Options {
   packageManager: PackageManager
   git: boolean
   install?: boolean
+  intent: boolean
 
   chosenAddOns: Array<AddOn>
   addOnOptions: Record<string, Record<string, any>>