Registry / web-framework / vite-plugin-single-spa

vite-plugin-single-spa

library1.1.1jsnpmunverified

Vite plugin (v1.1.1) to convert Vite-based projects into single-spa root or micro-frontend applications. Supports Vite 5, 6, and 7. Maintained by WJSoftware, but now in maintenance-only mode after the author's decision to discontinue feature development due to disputes. Key differentiator: opinionated integration of Vite with single-spa, handling asset naming, FOUC prevention, and CSS lifecycle exports. Provides TypeScript types and ESM-first exports.

web-framework

npm install vite-plugin-single-spa

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-SINGLE

vite-plugin-single-spa

web-frameworkjavascriptv1.1.1

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.

vitePluginSingleSpa

✓ import vitePluginSingleSpa from 'vite-plugin-single-spa'

✗ const vitePluginSingleSpa = require('vite-plugin-single-spa')

Default export is ESM-only; CommonJS require will fail.

vitePluginSingleSpa

✓ import { vitePluginSingleSpa } from 'vite-plugin-single-spa'

Also available as a named export, same as default.

type SingleSpaRootPluginOptions

✓ import type { SingleSpaRootPluginOptions } from 'vite-plugin-single-spa'

Type-only import for TypeScript users.

Configures a Vite project as a single-spa root config with import maps and plugin options.

// vite.config.ts import { defineConfig } from 'vite'; import vitePluginSingleSpa from 'vite-plugin-single-spa'; export default defineConfig({ plugins: [ vitePluginSingleSpa({ type: 'root', importMaps: { 'single-spa': 'https://cdn.jsdelivr.net/npm/single-spa@6.0.1/lib/system/single-spa.min.js' } }) ] });

Debug

Known issues

breakingDrop support for Vite v4 in v0.8.0. If using Vite 4, upgrade to Vite 5+ or stay on v0.7.0.

fix

Update Vite to ^5.0.0 || ^6.0.0 || ^7.0.0.

affects: >=0.8.0

deprecatedThe resolveId hook order changed to 'pre' in v0.9.0. May cause issues with other plugins that assume default order.

fix

Ensure compatibility with other Vite plugins that also use resolveId with 'pre' order.

affects: >=0.9.0

gotchaCSS collection moved to generateBundle hook in v1.1.1 for Vite 6 & 7 compatibility. Ensure your project uses generateBundle if relying on CSS lifecycle exports.

fix

Update plugin to v1.1.1 and verify CSS lifecycle works.

affects: >=1.1.1

gotchaProject is in maintenance mode only (as of 2025-04-13). No new features, only bug fixes. Consider alternatives for long-term support.

fix

Evaluate other single-spa integrations or contribute to this project.

affects: >=1.1.1

gotchaThe plugin requires a file src/spa.ts|js|jsx|tsx for micro-frontend projects. Missing this file will cause build errors.

fix

Create src/spa.ts exporting lifecycle functions.

affects: >=0.1.0

Errors

Common errors & fixes

Cannot read properties of undefined (reading 'viteMetadata')

This error occurred in v0.5.x when using certain Vite versions or configurations.

fix

Upgrade to v0.6.0 or later where this was fixed.

Error: The plugin 'vite-plugin-single-spa' doesn't support Vite v4. Minimum required version is 5.

Vite 4 support was dropped in v0.8.0.

fix

Upgrade Vite to ^5.0.0 or update plugin to v0.7.0.

Upgrade

Version history

1.1.1latest on npm

Audit

Dependencies

viterequiredPeer dependency: requires Vite 5, 6, or 7.

Agent activity

7 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/WJSoftware/vite-plugin-single-spa ↗

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