{"id":22777,"library":"vite-plugin-pilet","title":"vite-plugin-pilet","description":"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.","status":"active","version":"1.4.0","language":"javascript","source_language":"en","source_url":"https://github.com/smapiot/piral-cli-vite","tags":["javascript","vite","pilet","piral","microfrontends","plugin","typescript"],"install":[{"cmd":"npm install vite-plugin-pilet","lang":"bash","label":"npm"},{"cmd":"yarn add vite-plugin-pilet","lang":"bash","label":"yarn"},{"cmd":"pnpm add vite-plugin-pilet","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency: requires Vite as the build tool, version matching project's Vite version.","package":"vite","optional":false}],"imports":[{"note":"ESM-only since v1.2.0; CJS require will fail.","wrong":"const vitePluginPilet = require('vite-plugin-pilet')","symbol":"default","correct":"import vitePluginPilet from 'vite-plugin-pilet'"},{"note":"Default export, not named. Use the above import.","wrong":"const { vitePluginPilet } = require('vite-plugin-pilet')","symbol":"vitePluginPilet","correct":"import vitePluginPilet from 'vite-plugin-pilet'"},{"note":"Plugin type is from Vite, not from this package. This package exports a function.","wrong":"import { Plugin } from 'vite-plugin-pilet'","symbol":"Plugin","correct":"import type { Plugin } from 'vite'"}],"quickstart":{"code":"import { defineConfig } from 'vite';\nimport vitePluginPilet from 'vite-plugin-pilet';\n\nexport default defineConfig({\n  plugins: [\n    vitePluginPilet({\n      // Options: specify pilet API, schema version, etc.\n      api: 'https://your-piral-instance.com/api/v1/pilet',\n      schemaVersion: 'v3',\n    }),\n  ],\n});","lang":"typescript","description":"Shows how to configure Vite with vite-plugin-pilet in a vite.config.ts file, including required options."},"warnings":[{"fix":"Convert your project to ESM (use import syntax) or use dynamic import().","message":"Since v1.2.0, the plugin switched to ESM-only. CJS require() calls will fail.","severity":"breaking","affected_versions":">=1.2.0"},{"fix":"Update your pilet configuration to use schemaVersion: 'v3'.","message":"Pilet schema v2 is no longer supported starting from v1.1.0. Use schema v3.","severity":"deprecated","affected_versions":">=1.1.0"},{"fix":"Ensure a valid Vite config file exists in the root directory of your pilet project.","message":"The plugin expects a `vite.config.js` (or .ts) file in the project root. If missing, it may fail silently.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Add `sourcemap: true` to your Vite config's build options.","message":"Source maps require explicit configuration; they are not generated by default since v1.0.1.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Let the plugin manage NODE_ENV; remove any custom define for it.","message":"The plugin automatically exposes `process.env.NODE_ENV`; avoid overriding it in your Vite config to prevent conflicts.","severity":"gotcha","affected_versions":">=1.0.2"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run `npm install vite-plugin-pilet` and ensure your project uses ESM (type: module in package.json).","cause":"Package not installed or ESM/CJS mismatch.","error":"Error: Cannot find module 'vite-plugin-pilet'"},{"fix":"Use `import vitePluginPilet from 'vite-plugin-pilet'` (default import).","cause":"Incorrect import style (e.g., destructuring a default export).","error":"TypeError: vitePluginPilet is not a function"},{"fix":"Set `schemaVersion: 'v3'` in the plugin options.","cause":"Using deprecated schema v2.","error":"Error: Pilet schema version 'v2' is not supported. Use 'v3'."},{"fix":"Provide a valid `api` option pointing to your Piral instance's pilet API.","cause":"Missing or incorrect API endpoint configuration.","error":"Error: Could not resolve './pilet-api'"},{"fix":"Create a `vite.config.js` or `vite.config.ts` in the root directory of your pilet project.","cause":"Vite config file not found in project root.","error":"Error: ENOENT: no such file or directory, open 'vite.config.js'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}