@netlify/vite-plugin-tanstack-start 0.0.0

package/README.md

@@ -0,0 +1,44 @@
+# @netlify/vite-plugin-tanstack-start
+
+This Vite plugin configures your TanStack Start app for **deployment** to Netlify and provides full local emulation of
+the Netlify platform directly in `vite dev`.
+
+## Features
+
+- Configures `vite build` to prepare your app's production build for deployment to Netlify
+  - See
+    [full TanStack Start deployment docs for more](https://docs.netlify.com/build/frameworks/framework-setup-guides/tanstack-start/#deploy-to-netlify)
+- Configures `vite dev` to behave just like the production Netlify platform, but locally on your machine
+  - This has all the same features as `@netlify/vite-plugin`.
+    [Check out its docs for details](/packages/vite-plugin/README.md).
+
+## Installation
+
+```bash
+npm install -D @netlify/vite-plugin-tanstack-start
+```
+
+## Configuration options
+
+The plugin accepts the following options:
+
+```typescript
+{
+  edgeSSR: boolean, // Deploy your app to Netlify Edge Functions (default: false)
+}
+```
+
+## Usage
+
+Add the plugin to your `vite.config.js` or `vite.config.ts`:
+
+```js
+import { defineConfig } from 'vite'
+import { tanstackStart } from '@tanstack/react-start/plugin/vite'
+import react from '@vitejs/plugin-react'
+import netlify from '@netlify/vite-plugin-tanstack-start'
+
+export default defineConfig({
+  plugins: [tanstackStart(), react(), netlify()],
+})
+```

package/dist/main.d.ts

@@ -0,0 +1,17 @@
+import * as vite from 'vite';
+import { Features } from '@netlify/dev';
+
+interface PluginOptions {
+    /**
+     * Deploy SSR handler to Netlify Edge Functions instead of Netlify Functions (default: false).
+     */
+    edgeSSR?: boolean;
+    /**
+     * Optional configuration of Netlify dev features
+     * @see {link https://www.npmjs.com/package/@netlify/vite-plugin}
+     */
+    dev?: Features;
+}
+declare function createNetlifyTanstackStartPlugin(options?: PluginOptions): vite.Plugin<any>[];
+
+export { type PluginOptions, createNetlifyTanstackStartPlugin as default };

package/dist/main.js

@@ -0,0 +1,15 @@
+// src/main.ts
+import createNetlifyPlugin from "@netlify/vite-plugin";
+function createNetlifyTanstackStartPlugin(options = {}) {
+  const netlifyPlugin = createNetlifyPlugin({
+    build: {
+      enabled: true,
+      edgeSSR: options.edgeSSR ?? false
+    },
+    ...options.dev
+  });
+  return netlifyPlugin;
+}
+export {
+  createNetlifyTanstackStartPlugin as default
+};

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@netlify/vite-plugin-tanstack-start",
+  "version": "0.0.0",
+  "description": "Vite plugin for TanStack Start on Netlify",
+  "type": "module",
+  "engines": {
+    "node": "^22.12.0"
+  },
+  "main": "./dist/main.js",
+  "exports": "./dist/main.js",
+  "types": "./dist/main.d.ts",
+  "files": [
+    "dist/**/*"
+  ],
+  "scripts": {
+    "build": "tsup-node",
+    "prepack": "npm run build",
+    "test": "vitest run",
+    "test:dev": "vitest",
+    "test:ci": "vitest run",
+    "dev": "tsup-node --watch",
+    "publint": "npx -y publint --strict"
+  },
+  "keywords": [
+    "netlify",
+    "tanstack",
+    "tanstack-start",
+    "vite-plugin",
+    "dev",
+    "build"
+  ],
+  "license": "MIT",
+  "repository": "netlify/primitives",
+  "bugs": {
+    "url": "https://github.com/netlify/primitives/issues"
+  },
+  "author": "Netlify Inc.",
+  "devDependencies": {
+    "@netlify/dev-utils": "^4.1.3",
+    "@types/node": "^22.18.5",
+    "normalize-package-data": "^8.0.0",
+    "playwright": "^1.52.0",
+    "tsup": "^8.0.0",
+    "vite": "^7.1.5",
+    "vitest": "^3.0.0"
+  },
+  "dependencies": {
+    "@netlify/dev": "^4.5.9",
+    "@netlify/vite-plugin": "^2.5.10"
+  },
+  "peerDependencies": {
+    "@tanstack/react-start": "alpha",
+    "@tanstack/solid-start": "alpha",
+    "vite": ">=7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@tanstack/react-start": {
+      "optional": true
+    },
+    "@tanstack/solid-start": {
+      "optional": true
+    }
+  }
+}