Registry / devops / vite-plugin-typo3

vite-plugin-typo3

library3.0.0jsnpmunverified

Vite plugin for collecting and bundling entry points from TYPO3 extensions in a Composer-based TYPO3 setup. Version 3.0.0 adds support for Vite 8, drops CommonJS (ESM-only), and requires vite_asset_collector v1.16.0+. Provides automatic alias creation (EXT:/@), CORS defaults, and watcher ignore lists. Flexible configuration for project or extension mode. Actively maintained with monthly releases.

devops web-framework

npm install vite-plugin-typo3

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-TYPO3

vite-plugin-typo3

devopsjavascriptv3.0.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 (typo3)

✓ import typo3 from 'vite-plugin-typo3'

✗ const typo3 = require('vite-plugin-typo3')

ESM-only since v3.0.0; CommonJS require() will throw.

getDefaultAllowedOrigins

✓ import { getDefaultAllowedOrigins } from 'vite-plugin-typo3'

✗ const { getDefaultAllowedOrigins } = require('vite-plugin-typo3')

Named export; also ESM-only.

getDefaultIgnoreList

✓ import { getDefaultIgnoreList } from 'vite-plugin-typo3'

✗ import getDefaultIgnoreList from 'vite-plugin-typo3'

Named export, not default.

Minimal vite.config setup that integrates TYPO3 extension entry points. Requires EXT:my_extension/Configuration/ViteEntrypoints.json for actual entry collection.

import { defineConfig } from 'vite'; import typo3 from 'vite-plugin-typo3'; export default defineConfig({ plugins: [typo3()], });

Debug

Known issues

breakingDropped support for CommonJS. require() will fail.

fix

Use ESM imports (import typo3 from 'vite-plugin-typo3').

affects: >=3.0.0

breakingRequires vite_asset_collector v1.16.0+ and Vite 7 or 8.

fix

Update vite_asset_collector TYPO3 extension to v1.16.0 and update Vite to ^7.0 || ^8.0.

affects: >=3.0.0

breakingStrict CORS rules applied by default (v2+).

fix

Add custom origins via server.cors.origin using getDefaultAllowedOrigins() as a base.

affects: >=2.0.0

gotchaEntrypoint file default path is Configuration/ViteEntrypoints.json (not ViteEntrypoints.json).

fix

Place the JSON file at EXT:my_extension/Configuration/ViteEntrypoints.json or set custom path via entrypointFile option.

affects: >=1.0.0

gotchaAliases are only created for installed extensions with valid composer.json.

fix

Ensure TYPO3 extension has proper composer.json in its root.

affects: >=1.1.0

Errors

Common errors & fixes

Error: The plugin 'vite-plugin-typo3' doesn't appear to be a valid Vite plugin.

Using an outdated Vite version (<7) or conflicting plugin interface.

fix

Update Vite to ^7.0 (or ^8.0) which is the peer dependency for v3.

Cannot find module 'vite-plugin-typo3'

Package not installed or missing from package.json.

fix

Run 'npm install --save-dev vite-plugin-typo3' and ensure your project root contains node_modules.

The requested module 'vite-plugin-typo3' does not provide an export named 'getDefaultAllowedOrigins'

Using named import from a CJS context or incorrect version.

fix

Use ESM in your config file (e.g., .mjs or type: module) and ensure v3.0.0+.

Upgrade

Version history

3.0.0latest on npm

Audit

Dependencies

viterequiredPeer dependency; plugin integrates with Vite's build and dev server.

Agent activity

5 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/s2b/vite-plugin-typo3 ↗

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