Zephyr

1.0.2 verified Sat Apr 25 auth: no javascript

Zephyr is a modern cloud deployment platform for frontend applications, offering a Webpack plugin to seamlessly integrate deployments into your build pipeline. The current stable version is 1.0.2, with a monthly release cadence. Key differentiators include support for incremental builds, SSR, and Nuxt/Vite integrations, plus a focus on security audits and vulnerability remediation. Unlike alternatives, Zephyr provides a unified CLI and plugin ecosystem for Webpack, Vite, and Slidev, with TypeScript types included.

Common errors

error Error: Cannot find module 'zephyr-webpack-plugin' ↓

cause Missing local installation or incorrect path.

fix

Run npm install zephyr-webpack-plugin or check node_modules.

error TypeError: ZephyrWebpackPlugin is not a constructor ↓

cause Using default import instead of named import in ESM.

fix

Use import { ZephyrWebpackPlugin } from 'zephyr-webpack-plugin'.

error Error: The 'token' option is required. Please provide a valid Zephyr API token. ↓

cause Missing or empty token in plugin options.

fix

Set process.env.ZEPHYR_TOKEN or pass token property.

Warnings

breaking Version 1.0.0 dropped CommonJS support; use ESM imports. ↓

fix Switch to ESM imports: import { ZephyrWebpackPlugin } from 'zephyr-webpack-plugin'

deprecated The v0.x API property `authToken` was renamed to `token` in v1.0.0. ↓

fix Replace `authToken` with `token` in plugin options.

breaking Webpack 4 support removed in v0.2.0; Webpack 5 required. ↓

fix Upgrade to Webpack 5 and set peer dependency webpack@^5.0.0.

gotcha Plugin must be placed after other webpack plugins to ensure build stats are captured correctly. ↓

fix Add ZephyrWebpackPlugin as the last plugin in the array.

Install

npm install zephyr-webpack-plugin

yarn add zephyr-webpack-plugin

pnpm add zephyr-webpack-plugin

Imports

ZephyrWebpackPlugin

wrong

const ZephyrWebpackPlugin = require('zephyr-webpack-plugin')

correct

import { ZephyrWebpackPlugin } from 'zephyr-webpack-plugin'

ESM-only since v1.0.0; CommonJS not supported.

ZephyrWebpackPlugin

wrong

const ZephyrWebpackPlugin = require('zephyr-webpack-plugin').default

correct

const { ZephyrWebpackPlugin } = require('zephyr-webpack-plugin')

Use destructured require for CJS; default export is not available.

ZephyrConfigOptions

wrong

import { ZephyrConfigOptions } from 'zephyr-webpack-plugin'

correct

import type { ZephyrConfigOptions } from 'zephyr-webpack-plugin'

ZephyrConfigOptions is a TypeScript type-only export; use import type.

Quickstart

Shows basic plugin configuration with required token, project name, and organization.

// webpack.config.js
const { ZephyrWebpackPlugin } = require('zephyr-webpack-plugin');

module.exports = {
  plugins: [
    new ZephyrWebpackPlugin({
      token: process.env.ZEPHYR_TOKEN ?? '',
      projectName: 'my-app',
      organization: 'my-org',
    }),
  ],
};