Add Worker-safe create manifest export (#475)

add worker-safe create manifest export

Author: tannerlinsley

.changeset/slow-buses-build.md

@@ -0,0 +1,5 @@
+---
+"@tanstack/create": patch
+---
+
+Add a Worker-safe edge export backed by a build-time generated template and add-on manifest.

.gitignore

@@ -19,3 +19,5 @@ my-app
 coverage
 playwright-report
 test-results
+
+packages/create/src/generated/

docs/cli-reference.md

@@ -44,6 +44,45 @@ tanstack create --list-add-ons --framework React --json
 tanstack create --addon-details drizzle --framework React --json
 ```
 
+### Worker-safe programmatic generation
+
+Use `@tanstack/create/edge` in Cloudflare Workers and other runtimes that do not expose a Node package filesystem. The default `@tanstack/create` export is still the Node/CLI path and scans framework templates from disk.
+
+```ts
+import {
+  createApp,
+  createMemoryEnvironment,
+  finalizeAddOns,
+  getFrameworkById,
+  populateAddOnOptionsDefaults,
+} from '@tanstack/create/edge'
+
+const framework = getFrameworkById('react')!
+const chosenAddOns = await finalizeAddOns(framework, 'file-router', [
+  'tanstack-query',
+  'cloudflare',
+])
+const addOnOptions = populateAddOnOptionsDefaults(chosenAddOns)
+const { environment, output } = createMemoryEnvironment('/app')
+
+await createApp(environment, {
+  projectName: 'app',
+  targetDir: '/app',
+  framework,
+  mode: 'file-router',
+  typescript: true,
+  tailwind: true,
+  packageManager: 'pnpm',
+  git: false,
+  install: false,
+  intent: false,
+  chosenAddOns,
+  addOnOptions,
+})
+
+// output.files contains generated files for ZIP creation.
+```
+
 ---
 
 ## tanstack add

eslint.config.js

@@ -10,6 +10,7 @@ export default [
     ignores: [
       '**/assets/**',
       '**/dist/**',
+      '**/src/generated/**',
     ],
   },
   ...tanstackConfig,

packages/create/package.json

@@ -5,12 +5,32 @@
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./edge": {
+      "types": "./dist/types/edge.d.ts",
+      "import": "./dist/edge.js",
+      "default": "./dist/edge.js"
+    },
+    "./manifest": {
+      "types": "./dist/types/manifest.d.ts",
+      "import": "./dist/manifest.js",
+      "default": "./dist/manifest.js"
+    },
+    "./dist/*": "./dist/*",
+    "./package.json": "./package.json"
+  },
   "scripts": {
-    "build": "tsc && npm run copy-assets",
+    "build": "npm run generate-manifest && tsc && npm run copy-assets",
+    "generate-manifest": "node ./scripts/generate-manifest.mjs",
     "copy-assets": "node -e \"const fs=require('fs');const path=require('path');function copyDir(src,dest){if(!fs.existsSync(dest))fs.mkdirSync(dest,{recursive:true});for(const entry of fs.readdirSync(src,{withFileTypes:true})){const srcPath=path.join(src,entry.name);const destPath=path.join(dest,entry.name);if(entry.isDirectory())copyDir(srcPath,destPath);else fs.copyFileSync(srcPath,destPath)}}['react','solid'].forEach(fw=>{['add-ons','toolchains','hosts','examples','project'].forEach(dir=>{const src='src/frameworks/'+fw+'/'+dir;const dest='dist/frameworks/'+fw+'/'+dir;if(fs.existsSync(src))copyDir(src,dest)})})\"",
-    "dev": "tsc --watch",
-    "test": "eslint ./src && vitest run",
-    "test:watch": "vitest",
+    "dev": "npm run generate-manifest && tsc --watch",
+    "test": "npm run generate-manifest && eslint ./src && vitest run",
+    "test:watch": "npm run generate-manifest && vitest",
     "test:coverage": "vitest run --coverage"
   },
   "repository": {