Registry / web-framework / vite-plugin-pilet

vite-plugin-pilet

library1.4.0jsnpmunverified

Vite plugin for building pilets (micro frontends) in the Piral ecosystem. Current stable version is 1.4.0, released with provenance attestation. This plugin integrates Piral's pilet build process into Vite, enabling fast development and HMR for micro frontend modules. It supports pilet schema v3, standard Vite config files (vite.config.js/ts), and works with both ESM and CJS since v1.2.0. Key differentiators: tight integration with Piral's toolchain, automatic code generation via companion plugin, and support for source maps and CSS handling.

web-framework devops

npm install vite-plugin-pilet

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-PILET

vite-plugin-pilet

web-frameworkjavascriptv1.4.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

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 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

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

default

✓ import vitePluginPilet from 'vite-plugin-pilet'

✗ const vitePluginPilet = require('vite-plugin-pilet')

ESM-only since v1.2.0; CJS require will fail.

vitePluginPilet

✓ import vitePluginPilet from 'vite-plugin-pilet'

✗ const { vitePluginPilet } = require('vite-plugin-pilet')

Default export, not named. Use the above import.

Plugin

✓ import type { Plugin } from 'vite'

✗ import { Plugin } from 'vite-plugin-pilet'

Plugin type is from Vite, not from this package. This package exports a function.

Shows how to configure Vite with vite-plugin-pilet in a vite.config.ts file, including required options.

import { defineConfig } from 'vite'; import vitePluginPilet from 'vite-plugin-pilet'; export default defineConfig({ plugins: [ vitePluginPilet({ // Options: specify pilet API, schema version, etc. api: 'https://your-piral-instance.com/api/v1/pilet', schemaVersion: 'v3', }), ], });

Debug

Known issues

breakingSince v1.2.0, the plugin switched to ESM-only. CJS require() calls will fail.

fix

Convert your project to ESM (use import syntax) or use dynamic import().

affects: >=1.2.0

deprecatedPilet schema v2 is no longer supported starting from v1.1.0. Use schema v3.

fix

Update your pilet configuration to use schemaVersion: 'v3'.

affects: >=1.1.0

gotchaThe plugin expects a `vite.config.js` (or .ts) file in the project root. If missing, it may fail silently.

fix

Ensure a valid Vite config file exists in the root directory of your pilet project.

affects: >=1.0.0

gotchaSource maps require explicit configuration; they are not generated by default since v1.0.1.

fix

Add `sourcemap: true` to your Vite config's build options.

affects: >=1.0.0

gotchaThe plugin automatically exposes `process.env.NODE_ENV`; avoid overriding it in your Vite config to prevent conflicts.

fix

Let the plugin manage NODE_ENV; remove any custom define for it.

affects: >=1.0.2

Errors

Common errors & fixes

Error: Cannot find module 'vite-plugin-pilet'

Package not installed or ESM/CJS mismatch.

fix

Run `npm install vite-plugin-pilet` and ensure your project uses ESM (type: module in package.json).

TypeError: vitePluginPilet is not a function

Incorrect import style (e.g., destructuring a default export).

fix

Use `import vitePluginPilet from 'vite-plugin-pilet'` (default import).

Error: Pilet schema version 'v2' is not supported. Use 'v3'.

Using deprecated schema v2.

fix

Set `schemaVersion: 'v3'` in the plugin options.

Error: Could not resolve './pilet-api'

Missing or incorrect API endpoint configuration.

fix

Provide a valid `api` option pointing to your Piral instance's pilet API.

Error: ENOENT: no such file or directory, open 'vite.config.js'

Vite config file not found in project root.

fix

Create a `vite.config.js` or `vite.config.ts` in the root directory of your pilet project.

Upgrade

Version history

1.4.0latest on npm

Audit

Dependencies

viterequiredPeer dependency: requires Vite as the build tool, version matching project's Vite version.

Agent activity

11 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/smapiot/piral-cli-vite ↗

packagehttps://www.npmjs.com/package/vite-plugin-pilet ↗

homepagehttps://piral.io ↗