Zephyr Plugins

Zephyr Cloud | Zephyr Docs | Discord | Twitter | LinkedIn

---

Contributing

We welcome contributions! Please read our contributing guidelines for more information.

Plugins

Plugins within this repository are built for applications to deploy with Zephyr. This repository also includes utility packages for building npm plugins with Zephyr.

Public Plugins

• create-zephyr-apps - Create new applications with Zephyr integration
• parcel-reporter-zephyr - A Parcel reporter plugin for deploying with Zephyr
• rollup-plugin-zephyr - A Rollup plugin for deploying with Zephyr
• vite-plugin-zephyr - A Vite plugin for deploying with Zephyr
• zephyr-nuxt-module - A Nuxt module for deploying with Zephyr
• vite-plugin-vinext-zephyr - A Vite plugin for deploying Vinext apps with Zephyr
• zephyr-modernjs-plugin - A Modern.js plugin for deploying with Zephyr
• zephyr-repack-plugin - A Rspack plugin for deploying with Zephyr building with React Native and Re.Pack
• zephyr-rolldown-plugin - A Rolldown plugin for deploying with Zephyr
• zephyr-rspack-plugin - A Rspack plugin for deploying with Zephyr
• zephyr-tap-runtime - A host-owned TAP lifecycle runtime plugin for Module Federation
• zephyr-webpack-plugin - A Webpack plugin for deploying with Zephyr

Utility Packages

• zephyr-agent - The main internal package to build bundler integration with Zephyr. Public plugins mostly interact with this package.
• zephyr-xpack-internal - Sharing types, module federation capabilities and utilities for bundler built on top of webpack or Rspack.
• zephyr-edge-contract - Provide typings, constants and smaller utilites for Zephyr plugins.

AI Agent Skills

Every published package ships Agent Skills for AI coding agents, versioned with the package. Zephyr does not need them at runtime. To let your coding agent use them, opt in with TanStack Intent in your project:

pnpm add -D @tanstack/intent
pnpm dlx @tanstack/intent@latest install

Each plugin README names its skill.

Repository Structure

This is a Turborepo monorepo. Libraries are built with Rslib, tests run with Rstest, and repository checks use Oxlint, Oxfmt, and Publint.

• libs - Contains all the plugins and utility packages.
• examples - Contains examples to use and test the plugins.

Using this repository

pnpm install

For the opaque tap-app build-target contract, see the target documentation.

Available Scripts

Development

• pnpm build - Builds every package under libs
• pnpm build-all - Builds all packages and examples in dependency order
• pnpm typecheck - Type-checks the TypeScript project-reference graph

Testing

• pnpm test - Runs the test suite
• pnpm test:affected - Runs tests affected by the current branch
• pnpm test:coverage - Runs the repository-wide Rstest coverage suite
• pnpm test:examples - Runs example unit tests and the production deployment E2E suite

PR CI builds and deploys affected examples by default. Apply the ci:force-example-builds label to rerun required PR CI, build and deploy every example with a build script, and refresh the Zephyr preview links. Remove the label to return future PR updates to affected-only builds.

Linting & Formatting

• pnpm lint - Checks code for linting errors
• pnpm publint - Checks built npm packages for packaging errors and warnings
• pnpm format:check - Checks formatting with Oxfmt
• pnpm format - Formats code with Oxfmt

Version Management

• Stable releases are prepared by Release Please from Conventional Commits on main.
• Merge the generated release PR to update every package and plugin manifest, create the vX.Y.Z tag and GitHub Release, and publish packages to npm.
• Manual pnpm bump-* scripts and hand-created stable tags are retired.

See Release automation for the complete release policy.

Note: Please ensure you have run pnpm install before executing any of these commands.