Registry / devops / vite-plugin-vinext-zephyr

vite-plugin-vinext-zephyr

JSON →
library1.0.2jsnpmunverified

Vite plugin for deploying Vinext applications (Next.js-compatible framework built on Vite) to Zephyr Cloud. Currently at v1.0.2, with active development and patch releases every few weeks. Key differentiators: tightly integrated with Zephyr's deployment platform, handles build and upload of Vinext apps, supports ESM-only usage, and includes security fixes for dependency vulnerabilities. Alternative to manual deployment scripts or cloud-specific plugins.

npm install vite-plugin-vinext-zephyr
INSTALL
IMPORT
SIG · VITE-PLUGIN-VINEXT
V
vite-plugin-vinext-zephyr
devopsjavascriptv1.0.2
Install
Import
Disk
Pass rate
0/ 6
Env Coverage0 / 6
glibc
1822
musl
1822
Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
node 18223 runs
build_error
glibc
node 18223 runs
build_error
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

vitePluginVinextZephyr
import { vitePluginVinextZephyr } from 'vite-plugin-vinext-zephyr'
const { vitePluginVinextZephyr } = require('vite-plugin-vinext-zephyr')
ESM-only package; CommonJS require is not supported.
default
import vitePluginVinextZephyr from 'vite-plugin-vinext-zephyr'
import { default } from 'vite-plugin-vinext-zephyr'
Default export is available but named export is preferred. Only the default export is documented, but the named export also exists.
type imports
import type { ZephyrOptions } from 'vite-plugin-vinext-zephyr'
Types are shipped, but no explicit type exports are documented; use `typeof vitePluginVinextZephyr` if needed.

Configures Vite with the Vinext Zephyr plugin using environment variables for authentication.

// vite.config.ts import { vitePluginVinextZephyr } from 'vite-plugin-vinext-zephyr'; import { defineConfig } from 'vite'; export default defineConfig({ plugins: [ vitePluginVinextZephyr({ // Optional: Zephyr configuration // If not provided, uses environment variables orgSlug: process.env.ZEPHYR_ORG_SLUG ?? '', projectSlug: process.env.ZEPHYR_PROJECT_SLUG ?? '', apiKey: process.env.ZEPHYR_API_KEY ?? '', }) ], }); // Ensure environment variables are set before building: // ZEPHYR_ORG_SLUG=my-org ZEPHYR_PROJECT_SLUG=my-project ZEPHYR_API_KEY=xxx npx vite build
Debug
Known issues
gotchaThe plugin requires Vite ^7.0.0 || ^8.0.0. Using older Vite versions will cause errors.
fix
Update Vite to 7.x or 8.x.
affects: >=1.0.0
breakingv1.0.0 introduced breaking changes from v0.x; see changelog for migration.
fix
Review migration guide at https://github.com/ZephyrCloudIO/zephyr-packages/releases/tag/v1.0.0
affects: >=1.0.0 <1.0.0
deprecatedUsing default import may change in future; named export is preferred.
fix
Use import { vitePluginVinextZephyr } from 'vite-plugin-vinext-zephyr'
affects: >=1.0.0
gotchaThe plugin's API relies on environment variables for authentication; missing env vars can lead to silent failures.
fix
Explicitly pass options or set ZEPHYR_ORG_SLUG, ZEPHYR_PROJECT_SLUG, ZEPHYR_API_KEY before build.
affects: >=0.1.0
Errors
Common errors & fixes
Cannot find module 'vite-plugin-vinext-zephyr' or its corresponding type declarations.
Package is ESM-only; CommonJS require or missing tsconfig settings.
fix
Ensure your project uses ESM (type: module in package.json) and TypeScript has moduleResolution set to 'bundler' or 'node16'.
TypeError: Plugin configuration is invalid: plugins must be an array of Vite plugins.
Passing the plugin as a function call without instantiation (e.g., using vitePluginVinextZephyr instead of vitePluginVinextZephyr()).
fix
Use vitePluginVinextZephyr() (call the function) in the plugins array.
Error: [Zephyr] API_KEY is required for authentication. Please provide via environment variable or options.
Missing ZEPHYR_API_KEY or options.apiKey.
fix
Set ZEPHYR_API_KEY environment variable or pass apiKey in plugin options.
Upgrade
Version history
1.0.2latest on npm
Audit
Dependencies
viterequiredPeer dependency: required to function as a Vite plugin
Agent activity
36 hits · last 30 days
node
30
Resources
vite-plugin-vinext-zephyr — npm install vite-plugin-vinext-zephyr · libregistry