{"id":23027,"library":"zova-vite","title":"Zova Vite","description":"Zova Vite is a Vite plugin/framework integration for Zova, a TypeScript-first Node.js framework. Version 1.1.19 is the current stable release. It provides a streamlined development experience with hot module replacement (HMR), TypeScript support out of the box, and tight integration with Vite's build pipeline. Unlike generic Vite setups, it offers opinionated defaults for Zova projects, reducing configuration overhead. The plugin is actively maintained with frequent updates aligned to Vite's release cadence. Key differentiators include zero-config setup for Zova apps, automatic route generation, and built-in support for server-side rendering (SSR) when used with Zova.","status":"active","version":"1.1.19","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","framework","zova"],"install":[{"cmd":"npm install zova-vite","lang":"bash","label":"npm"},{"cmd":"yarn add zova-vite","lang":"bash","label":"yarn"},{"cmd":"pnpm add zova-vite","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"ESM-only since v1.0; no CommonJS support.","wrong":"const zovaVitePlugin = require('zova-vite')","symbol":"zovaVitePlugin","correct":"import { zovaVitePlugin } from 'zova-vite'"},{"note":"Type import; not a runtime value.","wrong":"import { ZovaViteOptions } from 'zova-vite'","symbol":"ZovaViteOptions","correct":"import type { ZovaViteOptions } from 'zova-vite'"},{"note":"Alias is allowed but not recommended; prefer named import as-is.","wrong":"import { defineConfig as dc } from 'zova-vite'","symbol":"defineConfig","correct":"import { defineConfig } from 'zova-vite'"}],"quickstart":{"code":"// vite.config.ts\nimport { defineConfig, zovaVitePlugin } from 'zova-vite';\n\nexport default defineConfig({\n  plugins: [\n    zovaVitePlugin({\n      ssr: true,\n      apiKey: process.env.ZOVA_API_KEY ?? ''\n    })\n  ]\n});\n","lang":"typescript","description":"Shows basic usage of zova-vite plugin in a Vite config with SSR enabled and an API key from environment."},"warnings":[{"fix":"Switch to ESM imports or use dynamic import() if in CJS context.","message":"zova-vite v1.0 dropped CommonJS support; require() will fail.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Use `ssr: true` instead of `enableSSR: true`.","message":"The 'enableSSR' option was renamed to 'ssr' in v1.1.0.","severity":"deprecated","affected_versions":">=1.1.0"},{"fix":"Set `moduleResolution: 'bundler'` or `'node16'`.","message":"When using TypeScript, ensure 'moduleResolution' is set to 'bundler' or 'node16' in tsconfig.json.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Replace `import ZovaVite from 'zova-vite'` with `import { zovaVitePlugin } from 'zova-vite'`.","message":"The default export has been removed; use named export 'zovaVitePlugin'.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Wrap client-side code inside `if (typeof window !== 'undefined')` or use `onSSR` option.","message":"During SSR, avoid using window/document in your plugin config.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run `npm install zova-vite --save-dev` and ensure you have `@types/node` if needed.","cause":"Package not installed or missing type definitions.","error":"Cannot find module 'zova-vite' or its corresponding type declarations."},{"fix":"Change to `import { zovaVitePlugin } from 'zova-vite'` and ensure project uses ESM.","cause":"Using require() with ESM-only package.","error":"TypeError: (0 , zova_vite_1.zovaVitePlugin) is not a function"},{"fix":"Add `import { defineConfig, zovaVitePlugin } from 'zova-vite'`.","cause":"Missing import for defineConfig.","error":"Uncaught ReferenceError: defineConfig is not defined"},{"fix":"Set `\"type\": \"module\"` in package.json or rename file to .mts.","cause":"Using ESM syntax in a CommonJS module.","error":"[vite] Internal server error: Unexpected token 'export'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}