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
muslnode 18–223 runs
build_error
glibcnode 18–223 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
viteRtlCssPlugin
✓ import viteRtlCssPlugin from 'vite-plugin-rtl-css'
✗ const viteRtlCssPlugin = require('vite-plugin-rtl-css')
ESM-only; no default CommonJS support. Plugin is a default export.
Options
✓ import type { Options } from 'vite-plugin-rtl-css'
✗ import { Options } from 'vite-plugin-rtl-css'
Options is a type, not a value. Use type import for TypeScript.
ViteRtlCssPlugin (type)
✓ import viteRtlCssPlugin from 'vite-plugin-rtl-css';
// type of plugin function
The default export is a function; no separate named export for the plugin type.
Shows minimum Vite config with plugin, including all optional settings for filename mapping, sourcemaps, and rtlcss config.
import { defineConfig } from 'vite';
import viteRtlCssPlugin from 'vite-plugin-rtl-css';
export default defineConfig({
plugins: [
viteRtlCssPlugin({
fileNameMap: {
'.css': '[name].rtl.css',
'.min.css': '[name].rtl.min.css'
},
sourceMap: true,
rtlcssConfig: {
autoRename: true
}
})
]
});
Debug
Known issues
breakingVite plugin for rtlcssfixUse ESM imports only; CommonJS require() will fail.
affects: >=1.0.0
gorchartlcss library is a peer dependency; must be installed separatelyfixRun npm install rtlcss --save-dev
affects: >=1.0.0
deprecatedNo deprecated features reported.
Errors
Common errors & fixes
Error: Cannot find module 'rtlcss'
Missing peer dependency rtlcss
fixnpm install rtlcss --save-dev
TypeError: viteRtlCssPlugin is not a function
Using require() instead of import (ESM-only)
fixChange to dynamic import: const viteRtlCssPlugin = (await import('vite-plugin-rtl-css')).default; error TS2305: Module 'vite-plugin-rtl-css' has no exported member 'Options'
Importing Options as a value instead of type
fixUse import type { Options } from 'vite-plugin-rtl-css'; Audit
Dependencies
rtlcssrequiredCore dependency for CSS RTL transformation