@tanstack/cta-engine 0.10.0-alpha.13 → 0.10.0-alpha.15

package/dist/cli.js

@@ -7,29 +7,30 @@ import { SUPPORTED_TOOLCHAINS } from './toolchain.js';
 import runServer from './mcp.js';
 import { listAddOns } from './add-ons.js';
 import { DEFAULT_FRAMEWORK, SUPPORTED_FRAMEWORKS } from './constants.js';
-// import { initAddOn } from './custom-add-on.js'
+import { initAddOn } from './custom-add-on.js';
 import { createDefaultEnvironment } from './environment.js';
+import { add } from './add.js';
 export function cli({ name, appName, forcedMode, forcedAddOns, }) {
     const program = new Command();
     program.name(name).description(`CLI to create a new ${appName} application`);
-    // program
-    //   .command('add')
-    //   .argument('add-on', 'Name of the add-on (or add-ons separated by commas)')
-    //   .action(async (addOn: string) => {
-    //     await add(addOn.split(',').map((addon) => addon.trim()))
-    //   })
-    // program
-    //   .command('update-add-on')
-    //   .description('Create or update an add-on from the current project')
-    //   .action(async () => {
-    //     await initAddOn('add-on')
-    //   })
-    // program
-    //   .command('update-overlay')
-    //   .description('Create or update a project overlay from the current project')
-    //   .action(async () => {
-    //     await initAddOn('overlay')
-    //   })
+    program
+        .command('add')
+        .argument('add-on', 'Name of the add-on (or add-ons separated by commas)')
+        .action(async (addOn) => {
+        await add(addOn.split(',').map((addon) => addon.trim()));
+    });
+    program
+        .command('update-add-on')
+        .description('Create or update an add-on from the current project')
+        .action(async () => {
+        await initAddOn('add-on');
+    });
+    program
+        .command('update-starter')
+        .description('Create or update a project starter from the current project')
+        .action(async () => {
+        await initAddOn('starter');
+    });
     program.argument('[project-name]', 'name of the project');
     if (!forcedMode) {
         program.option('--template <type>', 'project template (typescript, javascript, file-router)', (value) => {
@@ -48,7 +49,7 @@ export function cli({ name, appName, forcedMode, forcedAddOns, }) {
         }
         return value;
     }, DEFAULT_FRAMEWORK)
-        // .option('--overlay [url]', 'add an overlay from a URL', false)
+        .option('--starter [url]', 'initialize this project from a starter URL', false)
         .option(`--package-manager <${SUPPORTED_PACKAGE_MANAGERS.join('|')}>`, `Explicitly tell the CLI to use this package manager`, (value) => {
         if (!SUPPORTED_PACKAGE_MANAGERS.includes(value)) {
             throw new InvalidArgumentError(`Invalid package manager: ${value}. The following are allowed: ${SUPPORTED_PACKAGE_MANAGERS.join(', ')}`);
@@ -71,7 +72,7 @@ export function cli({ name, appName, forcedMode, forcedAddOns, }) {
     })
         .option('--list-add-ons', 'list all available add-ons', false)
         .option('--no-git', 'do not create a git repository')
-        .option('--target-dir <path>', 'the directory to create the project in')
+        .option('--target-dir <path>', 'the target directory for the application root')
         .option('--mcp', 'run the MCP server', false)
         .option('--mcp-sse', 'run the MCP server in SSE mode', false);
     program.action(async (projectName, options) => {

package/dist/create-app.js

@@ -332,9 +332,9 @@ export async function createApp(options, { silent = false, environment, cwd, app
                 }
             }
         }
-        if (options.overlay) {
-            if (options.overlay.shadcnComponents) {
-                for (const component of options.overlay.shadcnComponents) {
+        if (options.starter) {
+            if (options.starter.shadcnComponents) {
+                for (const component of options.starter.shadcnComponents) {
                     shadcnComponents.add(component);
                 }
             }
@@ -433,11 +433,11 @@ export async function createApp(options, { silent = false, environment, cwd, app
     }
     // Create the README.md
     await templateFile(templateDirBase, 'README.md.ejs');
-    // Adding overlay
-    if (options.overlay) {
-        s?.start(`Setting up overlay ${options.overlay.name}...`);
-        await runAddOn(options.overlay);
-        s?.stop(`Overlay ${options.overlay.name} setup complete`);
+    // Adding starter
+    if (options.starter) {
+        s?.start(`Setting up starter ${options.starter.name}...`);
+        await runAddOn(options.starter);
+        s?.stop(`Starter ${options.starter.name} setup complete`);
     }
     // Install dependencies
     s?.start(`Installing dependencies via ${options.packageManager}...`);
@@ -492,6 +492,6 @@ Use the following commands to start your app:
 % cd ${options.projectName}
 % ${startCommand}
 
-Please read the README.md for more information on testing, styling, adding routes, react-query, etc.${errorStatement}`);
+Please check the README.md for more information on testing, styling, adding routes, react-query, etc.${errorStatement}`);
     }
 }

package/dist/custom-add-on.js

@@ -9,11 +9,11 @@ import { finalizeAddOns } from './add-ons.js';
 import { readFileHelper } from './file-helper.js';
 const INFO_FILE = {
     'add-on': '.add-on/info.json',
-    overlay: 'overlay-info.json',
+    starter: 'starter-info.json',
 };
 const COMPILED_FILE = {
     'add-on': 'add-on.json',
-    overlay: 'overlay.json',
+    starter: 'starter.json',
 };
 const ADD_ON_DIR = '.add-on';
 const ASSETS_DIR = 'assets';
@@ -76,7 +76,7 @@ export default (parentRoute: RootRoute) => createRoute({
         .trim();
     return { url: path, code, name };
 }
-async function createOptions(json) {
+export async function createAppOptionsFromPersisted(json) {
     return {
         ...json,
         chosenAddOns: await finalizeAddOns(json.framework, json.mode, [...json.existingAddOns]),
@@ -154,12 +154,13 @@ To create an add-on, the project must be created with TypeScript.`);
         : {
             name: `${persistedOptions.projectName}-${mode}`,
             version: '0.0.1',
-            description: mode === 'add-on' ? 'Add-on' : 'Project overlay',
+            description: mode === 'add-on' ? 'Add-on' : 'Project starter',
             author: 'Jane Smith <jane.smith@example.com>',
             license: 'MIT',
             link: `https://github.com/jane-smith/${persistedOptions.projectName}-${mode}`,
             command: {},
             shadcnComponents: [],
+            framework: persistedOptions.framework,
             templates: [persistedOptions.mode],
             routes: [],
             warning: '',
@@ -173,7 +174,7 @@ To create an add-on, the project must be created with TypeScript.`);
             },
         };
     const compiledInfo = JSON.parse(JSON.stringify(info));
-    const originalOutput = await runCreateApp(await createOptions(persistedOptions));
+    const originalOutput = await runCreateApp(await createAppOptionsFromPersisted(persistedOptions));
     const originalPackageJson = JSON.parse(originalOutput.files[resolve(process.cwd(), 'package.json')]);
     const currentPackageJson = JSON.parse((await readFile('package.json')).toString());
     for (const script of Object.keys(currentPackageJson.scripts)) {
@@ -201,7 +202,7 @@ To create an add-on, the project must be created with TypeScript.`);
     // Find altered files
     const changedFiles = {};
     await compareFiles('.', IGNORE_FILES, originalOutput.files, changedFiles);
-    if (mode === 'overlay') {
+    if (mode === 'starter') {
         compiledInfo.files = changedFiles;
     }
     else {
@@ -235,7 +236,8 @@ To create an add-on, the project must be created with TypeScript.`);
     compiledInfo.routes = info.routes;
     compiledInfo.framework = persistedOptions.framework;
     compiledInfo.addDependencies = persistedOptions.existingAddOns;
-    if (mode === 'overlay') {
+    compiledInfo.packageAdditions = info.packageAdditions;
+    if (mode === 'starter') {
         compiledInfo.mode = persistedOptions.mode;
         compiledInfo.typescript = persistedOptions.typescript;
         compiledInfo.tailwind = persistedOptions.tailwind;

package/dist/index.js

@@ -1 +1,5 @@
 export { cli } from './cli.js';
+export { getAllAddOns } from './add-ons.js';
+export { createApp } from './create-app.js';
+export { createAppOptionsFromPersisted } from './custom-add-on.js';
+export { createMemoryEnvironment, createDefaultEnvironment, } from './environment.js';

package/dist/options.js

@@ -23,22 +23,22 @@ export async function normalizeOptions(cliOptions, forcedAddOns) {
             tailwind = true;
         }
         let mode = cliOptions.template === 'file-router' ? FILE_ROUTER : CODE_ROUTER;
-        const overlay = cliOptions.overlay
-            ? (await loadRemoteAddOn(cliOptions.overlay))
+        const starter = cliOptions.starter
+            ? (await loadRemoteAddOn(cliOptions.starter))
             : undefined;
-        if (overlay) {
-            tailwind = overlay.tailwind;
-            typescript = overlay.typescript;
-            cliOptions.framework = overlay.framework;
-            mode = overlay.mode;
+        if (starter) {
+            tailwind = starter.tailwind;
+            typescript = starter.typescript;
+            cliOptions.framework = starter.framework;
+            mode = starter.mode;
         }
         let addOns = false;
         let chosenAddOns = [];
         if (Array.isArray(cliOptions.addOns) ||
-            overlay?.dependsOn ||
+            starter?.dependsOn ||
             forcedAddOns) {
             addOns = true;
-            let finalAddOns = Array.from(new Set([...(overlay?.dependsOn || []), ...(forcedAddOns || [])]));
+            let finalAddOns = Array.from(new Set([...(starter?.dependsOn || []), ...(forcedAddOns || [])]));
             if (cliOptions.addOns && Array.isArray(cliOptions.addOns)) {
                 finalAddOns = Array.from(new Set([
                     ...(forcedAddOns || []),
@@ -64,7 +64,7 @@ export async function normalizeOptions(cliOptions, forcedAddOns) {
             addOns,
             chosenAddOns,
             variableValues: {},
-            overlay,
+            starter,
         };
     }
 }

package/dist/types/custom-add-on.d.ts

@@ -1,3 +1,6 @@
-type AddOnMode = 'add-on' | 'overlay';
+import type { Options } from './types.js';
+import type { PersistedOptions } from './config-file.js';
+type AddOnMode = 'add-on' | 'starter';
+export declare function createAppOptionsFromPersisted(json: PersistedOptions): Promise<Required<Options>>;
 export declare function initAddOn(mode: AddOnMode): Promise<void>;
 export {};

package/dist/types/index.d.ts

@@ -1 +1,7 @@
 export { cli } from './cli.js';
+export { getAllAddOns } from './add-ons.js';
+export { createApp } from './create-app.js';
+export { createAppOptionsFromPersisted } from './custom-add-on.js';
+export { createMemoryEnvironment, createDefaultEnvironment, } from './environment.js';
+export type { AddOn, Framework, Mode } from './types.js';
+export type { PersistedOptions } from './config-file.js';

package/dist/types/types.d.ts

@@ -3,6 +3,7 @@ import type { PackageManager } from './package-manager.js';
 import type { ToolChain } from './toolchain.js';
 export type Framework = 'solid' | 'react';
 export type TemplateOptions = 'typescript' | 'javascript' | 'file-router';
+export type Mode = typeof CODE_ROUTER | typeof FILE_ROUTER;
 export interface Options {
     framework: Framework;
     projectName: string;
@@ -10,12 +11,12 @@ export interface Options {
     tailwind: boolean;
     packageManager: PackageManager;
     toolchain: ToolChain;
-    mode: typeof CODE_ROUTER | typeof FILE_ROUTER;
+    mode: Mode;
     addOns: boolean;
     chosenAddOns: Array<AddOn>;
     git: boolean;
     variableValues: Record<string, string | number | boolean>;
-    overlay?: AddOn | undefined;
+    starter?: AddOn | undefined;
 }
 export interface CliOptions {
     template?: TemplateOptions;
@@ -29,7 +30,7 @@ export interface CliOptions {
     listAddOns?: boolean;
     mcp?: boolean;
     mcpSse?: boolean;
-    overlay?: string;
+    starter?: string;
     targetDir?: string;
 }
 export type Environment = {
@@ -69,7 +70,7 @@ export type AddOn = {
     id: string;
     name: string;
     description: string;
-    type: 'add-on' | 'example' | 'overlay';
+    type: 'add-on' | 'example' | 'starter';
     link: string;
     templates: Array<string>;
     routes: Array<{
@@ -94,13 +95,13 @@ export type AddOn = {
     files?: Record<string, string>;
     deletedFiles?: Array<string>;
 };
-export type Overlay = AddOn & {
-    type: 'overlay';
+export type Starter = AddOn & {
+    type: 'starter';
     version: string;
     author: string;
     link: string;
     license: string;
-    mode: typeof CODE_ROUTER | typeof FILE_ROUTER;
+    mode: Mode;
     framework: Framework;
     typescript: boolean;
     tailwind: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/cta-engine",
-  "version": "0.10.0-alpha.13",
+  "version": "0.10.0-alpha.15",
   "description": "Tanstack Application Builder Engine",
   "type": "module",
   "main": "./dist/index.js",

package/src/cli.ts

@@ -9,10 +9,10 @@ import { SUPPORTED_TOOLCHAINS } from './toolchain.js'
 import runServer from './mcp.js'
 import { listAddOns } from './add-ons.js'
 import { DEFAULT_FRAMEWORK, SUPPORTED_FRAMEWORKS } from './constants.js'
-// import { initAddOn } from './custom-add-on.js'
+import { initAddOn } from './custom-add-on.js'
 
 import { createDefaultEnvironment } from './environment.js'
-// import { add } from './add.js'
+import { add } from './add.js'
 
 import type { PackageManager } from './package-manager.js'
 import type { ToolChain } from './toolchain.js'
@@ -33,26 +33,26 @@ export function cli({
 
   program.name(name).description(`CLI to create a new ${appName} application`)
 
-  // program
-  //   .command('add')
-  //   .argument('add-on', 'Name of the add-on (or add-ons separated by commas)')
-  //   .action(async (addOn: string) => {
-  //     await add(addOn.split(',').map((addon) => addon.trim()))
-  //   })
+  program
+    .command('add')
+    .argument('add-on', 'Name of the add-on (or add-ons separated by commas)')
+    .action(async (addOn: string) => {
+      await add(addOn.split(',').map((addon) => addon.trim()))
+    })
 
-  // program
-  //   .command('update-add-on')
-  //   .description('Create or update an add-on from the current project')
-  //   .action(async () => {
-  //     await initAddOn('add-on')
-  //   })
+  program
+    .command('update-add-on')
+    .description('Create or update an add-on from the current project')
+    .action(async () => {
+      await initAddOn('add-on')
+    })
 
-  // program
-  //   .command('update-overlay')
-  //   .description('Create or update a project overlay from the current project')
-  //   .action(async () => {
-  //     await initAddOn('overlay')
-  //   })
+  program
+    .command('update-starter')
+    .description('Create or update a project starter from the current project')
+    .action(async () => {
+      await initAddOn('starter')
+    })
 
   program.argument('[project-name]', 'name of the project')
 
@@ -90,7 +90,11 @@ export function cli({
       },
       DEFAULT_FRAMEWORK,
     )
-    // .option('--overlay [url]', 'add an overlay from a URL', false)
+    .option(
+      '--starter [url]',
+      'initialize this project from a starter URL',
+      false,
+    )
     .option<PackageManager>(
       `--package-manager <${SUPPORTED_PACKAGE_MANAGERS.join('|')}>`,
       `Explicitly tell the CLI to use this package manager`,
@@ -133,7 +137,10 @@ export function cli({
     )
     .option('--list-add-ons', 'list all available add-ons', false)
     .option('--no-git', 'do not create a git repository')
-    .option('--target-dir <path>', 'the directory to create the project in')
+    .option(
+      '--target-dir <path>',
+      'the target directory for the application root',
+    )
     .option('--mcp', 'run the MCP server', false)
     .option('--mcp-sse', 'run the MCP server in SSE mode', false)
 

package/src/create-app.ts

@@ -529,9 +529,9 @@ export async function createApp(
         }
       }
     }
-    if (options.overlay) {
-      if (options.overlay.shadcnComponents) {
-        for (const component of options.overlay.shadcnComponents) {
+    if (options.starter) {
+      if (options.starter.shadcnComponents) {
+        for (const component of options.starter.shadcnComponents) {
           shadcnComponents.add(component)
         }
       }
@@ -714,11 +714,11 @@ export async function createApp(
   // Create the README.md
   await templateFile(templateDirBase, 'README.md.ejs')
 
-  // Adding overlay
-  if (options.overlay) {
-    s?.start(`Setting up overlay ${options.overlay.name}...`)
-    await runAddOn(options.overlay)
-    s?.stop(`Overlay ${options.overlay.name} setup complete`)
+  // Adding starter
+  if (options.starter) {
+    s?.start(`Setting up starter ${options.starter.name}...`)
+    await runAddOn(options.starter)
+    s?.stop(`Starter ${options.starter.name} setup complete`)
   }
 
   // Install dependencies
@@ -799,6 +799,6 @@ Use the following commands to start your app:
 % cd ${options.projectName}
 % ${startCommand}
 
-Please read the README.md for more information on testing, styling, adding routes, react-query, etc.${errorStatement}`)
+Please check the README.md for more information on testing, styling, adding routes, react-query, etc.${errorStatement}`)
   }
 }

package/src/custom-add-on.ts

@@ -12,15 +12,15 @@ import { readFileHelper } from './file-helper.js'
 import type { Framework, Options } from './types.js'
 import type { PersistedOptions } from './config-file.js'
 
-type AddOnMode = 'add-on' | 'overlay'
+type AddOnMode = 'add-on' | 'starter'
 
 const INFO_FILE: Record<AddOnMode, string> = {
   'add-on': '.add-on/info.json',
-  overlay: 'overlay-info.json',
+  starter: 'starter-info.json',
 }
 const COMPILED_FILE: Record<AddOnMode, string> = {
   'add-on': 'add-on.json',
-  overlay: 'overlay.json',
+  starter: 'starter.json',
 }
 
 const ADD_ON_DIR = '.add-on'
@@ -102,7 +102,7 @@ export default (parentRoute: RootRoute) => createRoute({
   return { url: path, code, name }
 }
 
-async function createOptions(
+export async function createAppOptionsFromPersisted(
   json: PersistedOptions,
 ): Promise<Required<Options>> {
   return {
@@ -198,12 +198,13 @@ To create an add-on, the project must be created with TypeScript.`)
     : {
         name: `${persistedOptions.projectName}-${mode}`,
         version: '0.0.1',
-        description: mode === 'add-on' ? 'Add-on' : 'Project overlay',
+        description: mode === 'add-on' ? 'Add-on' : 'Project starter',
         author: 'Jane Smith <jane.smith@example.com>',
         license: 'MIT',
         link: `https://github.com/jane-smith/${persistedOptions.projectName}-${mode}`,
         command: {},
         shadcnComponents: [],
+        framework: persistedOptions.framework,
         templates: [persistedOptions.mode],
         routes: [],
         warning: '',
@@ -220,7 +221,7 @@ To create an add-on, the project must be created with TypeScript.`)
   const compiledInfo = JSON.parse(JSON.stringify(info))
 
   const originalOutput = await runCreateApp(
-    await createOptions(persistedOptions),
+    await createAppOptionsFromPersisted(persistedOptions),
   )
 
   const originalPackageJson = JSON.parse(
@@ -264,7 +265,7 @@ To create an add-on, the project must be created with TypeScript.`)
   // Find altered files
   const changedFiles: Record<string, string> = {}
   await compareFiles('.', IGNORE_FILES, originalOutput.files, changedFiles)
-  if (mode === 'overlay') {
+  if (mode === 'starter') {
     compiledInfo.files = changedFiles
   } else {
     const assetsDir = resolve(ADD_ON_DIR, ASSETS_DIR)
@@ -302,8 +303,9 @@ To create an add-on, the project must be created with TypeScript.`)
   compiledInfo.routes = info.routes
   compiledInfo.framework = persistedOptions.framework
   compiledInfo.addDependencies = persistedOptions.existingAddOns
+  compiledInfo.packageAdditions = info.packageAdditions
 
-  if (mode === 'overlay') {
+  if (mode === 'starter') {
     compiledInfo.mode = persistedOptions.mode
     compiledInfo.typescript = persistedOptions.typescript
     compiledInfo.tailwind = persistedOptions.tailwind

package/src/index.ts

@@ -1 +1,11 @@
 export { cli } from './cli.js'
+export { getAllAddOns } from './add-ons.js'
+export { createApp } from './create-app.js'
+export { createAppOptionsFromPersisted } from './custom-add-on.js'
+export {
+  createMemoryEnvironment,
+  createDefaultEnvironment,
+} from './environment.js'
+
+export type { AddOn, Framework, Mode } from './types.js'
+export type { PersistedOptions } from './config-file.js'

package/src/options.ts

@@ -16,7 +16,7 @@ import { DEFAULT_TOOLCHAIN, SUPPORTED_TOOLCHAINS } from './toolchain.js'
 import { CODE_ROUTER, DEFAULT_FRAMEWORK, FILE_ROUTER } from './constants.js'
 import { finalizeAddOns, getAllAddOns, loadRemoteAddOn } from './add-ons.js'
 
-import type { AddOn, CliOptions, Options, Overlay, Variable } from './types.js'
+import type { AddOn, CliOptions, Options, Starter, Variable } from './types.js'
 
 // If all CLI options are provided, use them directly
 export async function normalizeOptions(
@@ -47,27 +47,27 @@ export async function normalizeOptions(
     let mode: typeof FILE_ROUTER | typeof CODE_ROUTER =
       cliOptions.template === 'file-router' ? FILE_ROUTER : CODE_ROUTER
 
-    const overlay = cliOptions.overlay
-      ? ((await loadRemoteAddOn(cliOptions.overlay)) as Overlay)
+    const starter = cliOptions.starter
+      ? ((await loadRemoteAddOn(cliOptions.starter)) as Starter)
       : undefined
 
-    if (overlay) {
-      tailwind = overlay.tailwind
-      typescript = overlay.typescript
-      cliOptions.framework = overlay.framework
-      mode = overlay.mode
+    if (starter) {
+      tailwind = starter.tailwind
+      typescript = starter.typescript
+      cliOptions.framework = starter.framework
+      mode = starter.mode
     }
 
     let addOns = false
     let chosenAddOns: Array<AddOn> = []
     if (
       Array.isArray(cliOptions.addOns) ||
-      overlay?.dependsOn ||
+      starter?.dependsOn ||
       forcedAddOns
     ) {
       addOns = true
       let finalAddOns = Array.from(
-        new Set([...(overlay?.dependsOn || []), ...(forcedAddOns || [])]),
+        new Set([...(starter?.dependsOn || []), ...(forcedAddOns || [])]),
       )
       if (cliOptions.addOns && Array.isArray(cliOptions.addOns)) {
         finalAddOns = Array.from(
@@ -102,7 +102,7 @@ export async function normalizeOptions(
       addOns,
       chosenAddOns,
       variableValues: {},
-      overlay,
+      starter,
     }
   }
 }

package/src/types.ts

@@ -6,6 +6,8 @@ export type Framework = 'solid' | 'react'
 
 export type TemplateOptions = 'typescript' | 'javascript' | 'file-router'
 
+export type Mode = typeof CODE_ROUTER | typeof FILE_ROUTER
+
 export interface Options {
   framework: Framework
   projectName: string
@@ -13,12 +15,12 @@ export interface Options {
   tailwind: boolean
   packageManager: PackageManager
   toolchain: ToolChain
-  mode: typeof CODE_ROUTER | typeof FILE_ROUTER
+  mode: Mode
   addOns: boolean
   chosenAddOns: Array<AddOn>
   git: boolean
   variableValues: Record<string, string | number | boolean>
-  overlay?: AddOn | undefined
+  starter?: AddOn | undefined
 }
 
 export interface CliOptions {
@@ -33,7 +35,7 @@ export interface CliOptions {
   listAddOns?: boolean
   mcp?: boolean
   mcpSse?: boolean
-  overlay?: string
+  starter?: string
   targetDir?: string
 }
 
@@ -81,7 +83,7 @@ export type AddOn = {
   id: string
   name: string
   description: string
-  type: 'add-on' | 'example' | 'overlay'
+  type: 'add-on' | 'example' | 'starter'
   link: string
   templates: Array<string>
   routes: Array<{
@@ -108,13 +110,13 @@ export type AddOn = {
   deletedFiles?: Array<string>
 }
 
-export type Overlay = AddOn & {
-  type: 'overlay'
+export type Starter = AddOn & {
+  type: 'starter'
   version: string
   author: string
   link: string
   license: string
-  mode: typeof CODE_ROUTER | typeof FILE_ROUTER
+  mode: Mode
   framework: Framework
   typescript: boolean
   tailwind: boolean

package/templates/react/add-on/clerk/assets/_dot_env.local.append

@@ -1,2 +1,2 @@
-# Clerk configuration, get this key from your [Dashboard](https://clerk.com/dashboard).
+# Clerk configuration, get this key from your [Dashboard](dashboard.clerk.com)
 VITE_CLERK_PUBLISHABLE_KEY=

package/templates/react/add-on/convex/assets/_dot_env.local.append

@@ -1,3 +1,3 @@
-# Convex configuration, get this URL from your [Dashboard](https://convex.dev/dashboard).
+# Convex configuration, get this URL from your [Dashboard](dashboard.convex.dev)
 CONVEX_DEPLOYMENT=
-VITE_CONVEX_URL=
+VITE_CONVEX_URL=

package/templates/react/add-on/tanstack-query/assets/src/integrations/tanstack-query/root-provider.tsx.ejs

@@ -13,7 +13,7 @@ function getUrl() {
     if (typeof window !== "undefined") return "";
     return `http://localhost:${process.env.PORT ?? 3000}`;
   })();
-  return base + "/api/trpc";
+  return `${base}/api/trpc`;
 }
 
 export const trpcClient = createTRPCClient<TRPCRouter>({
@@ -67,4 +67,4 @@ export function Provider({ children }: { children: React.ReactNode }) {
     <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>
   )
 }
-<% } %>
+<% } %>

package/templates/react/example/tanchat/assets/src/routes/api.messages.ts

@@ -0,0 +1,24 @@
+import { createAPIFileRoute } from "@tanstack/react-start/api";
+import { getEvent } from "vinxi/http";
+
+import { transports } from "@/utils/demo.sse";
+
+export const APIRoute = createAPIFileRoute("/api/messages")({
+  // @ts-ignore
+  POST: async ({ request, params }) => {
+    const body = await request.json();
+    const url = new URL(request.url);
+    const sessionId = url.searchParams.get("sessionId") as string;
+    const transport = transports[sessionId];
+    if (transport) {
+      try {
+        getEvent().node.res.statusCode = 200;
+        await transport.handleMessage(body);
+      } catch (error) {
+        getEvent().node.res.send("Error handling message");
+      }
+    } else {
+      getEvent().node.res.send("No transport found for sessionId");
+    }
+  },
+});

package/templates/react/example/tanchat/assets/src/routes/api.sse.ts

@@ -0,0 +1,23 @@
+import { createAPIFileRoute } from '@tanstack/react-start/api'
+import { getEvent } from 'vinxi/http'
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js'
+
+import { transports, server } from '@/utils/demo.sse'
+
+export const APIRoute = createAPIFileRoute('/api/sse')({
+  // @ts-ignore
+  GET: async ({}) => {
+    const transport = new SSEServerTransport(
+      '/api/messages',
+      getEvent().node.res,
+    )
+    transports[transport.sessionId] = transport
+    transport.onerror = (error) => {
+      console.error(error)
+    }
+    getEvent().node.res.on('close', () => {
+      delete transports[transport.sessionId]
+    })
+    await server.connect(transport)
+  },
+})

package/templates/react/example/tanchat/assets/src/utils/demo.sse.ts

@@ -0,0 +1,31 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
+import { getWebRequest } from "vinxi/http";
+
+import guitars from "@/data/example-guitars";
+
+export const server = new McpServer({
+  name: "guitar-server",
+  version: "1.0.0",
+});
+export const transports: { [sessionId: string]: SSEServerTransport } = {};
+
+server.tool("getGuitars", {}, async ({}) => {
+  const port = new URL(getWebRequest().url).port;
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(
+          guitars.map((guitar) => ({
+            id: guitar.id,
+            name: guitar.name,
+            description: guitar.description,
+            price: guitar.price,
+            image: `http://localhost:${port}${guitar.image}`,
+          }))
+        ),
+      },
+    ],
+  };
+});

package/templates/react/example/tanchat/package.json

@@ -2,6 +2,7 @@
   "dependencies": {
     "@ai-sdk/anthropic": "^1.1.17",
     "@ai-sdk/react": "^1.1.23",
+    "@modelcontextprotocol/sdk": "^1.8.0",
     "ai": "^4.1.65",
     "highlight.js": "^11.11.1",
     "react-markdown": "^9.0.1",