Vite Plugin TanStack Start Zephyr

1.0.2 verified Mon Apr 27 auth: no javascript

Vite plugin (v1.0.2) integrating TanStack Start with Zephyr cloud deployment platform. Enables deploying TanStack Start applications to Zephyr with minimal configuration. Requires vite 7 or 8, and @tanstack/react-start 1+. Ships TypeScript types. Active development with frequent security patches and feature releases.

Common errors

error ReferenceError: require is not defined ↓

cause Using CommonJS `require` to import an ESM-only package.

fix

Switch to ESM: add "type": "module" in package.json or use .mjs extension, then use import.

error TypeError: plugin is not a function ↓

cause Calling `zephyrPlugin` instead of using it as a factory: `zephyrPlugin()`

fix

Invoke the default export: zephyrPlugin() in plugins array.

error Error: The plugin 'vite-plugin-tanstack-start-zephyr' requires @tanstack/react-start@^1.0.0 ↓

cause Peer dependency not met.

fix

Install @tanstack/react-start@^1.0.0.

Warnings

breaking Requires vite ^7.0.0 || ^8.0.0. Not compatible with older vite versions. ↓

fix Upgrade vite to 7.x or 8.x.

breaking Requires @tanstack/react-start ^1.0.0. Not compatible with v0.x. ↓

fix Upgrade @tanstack/react-start to 1.x.

deprecated Use of CommonJS `require` will cause a runtime error. ↓

fix Use ESM `import` syntax.

Install

npm install vite-plugin-tanstack-start-zephyr

yarn add vite-plugin-tanstack-start-zephyr

pnpm add vite-plugin-tanstack-start-zephyr

Imports

default

wrong

const zephyrPlugin = require('vite-plugin-tanstack-start-zephyr')

correct

import zephyrPlugin from 'vite-plugin-tanstack-start-zephyr'

ESM-only; CommonJS require will fail.

Quickstart

Minimal setup to add Zephyr deployment support to a TanStack Start project.

// vite.config.ts
import { defineConfig } from 'vite';
import zephyrPlugin from 'vite-plugin-tanstack-start-zephyr';

export default defineConfig({
  plugins: [
    zephyrPlugin()
  ]
});