Registry / web-framework / vite-plugin-twig-drupal

vite-plugin-twig-drupal

JSON →
library1.6.2jsnpmunverified

A Vite plugin that compiles Twig templates to HTML with Drupal-specific features including Twig namespaces, includes, extends, and Drupal filter/function support. Current stable version 1.6.2, actively maintained, with monthly releases. Integrates with Storybook for component development. Supports Vite 4–7. Key differentiator: Drupal-aware Twig rendering without a Drupal backend, enabling frontend prototyping.

npm install vite-plugin-twig-drupal
INSTALL
IMPORT
SIG · VITE-PLUGIN-TWIG-D
V
vite-plugin-twig-drupal
web-frameworkjavascriptv1.6.2
Install
Import
Disk
Pass rate
0/ 6
Env Coverage0 / 6
glibc
1822
musl
1822
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 18223 runs
build_error
glibc
node 18223 runs
build_error
Code
Verified usage

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

default
import twigDrupal from 'vite-plugin-twig-drupal'
const twigDrupal = require('vite-plugin-twig-drupal')
ESM-only plugin, cannot use require()
drupalFilter
import { drupalFilter } from 'vite-plugin-twig-drupal'
Named export for custom filters
twig
import twigDrupal from 'vite-plugin-twig-drupal'; const plugins = [twigDrupal()]
import { twigDrupal } from 'vite-plugin-twig-drupal'
Default export is function, not object

Configures Vite to compile Twig templates with Drupal namespaces, enabling use of @components/ and @layouts/ prefixes in templates.

// vite.config.js import { defineConfig } from 'vite'; import twigDrupal from 'vite-plugin-twig-drupal'; export default defineConfig({ plugins: [ twigDrupal({ namespaces: { components: 'path/to/components', layouts: 'path/to/layouts', }, }), ], });
Debug
Known issues
breakingTrying to use require() to import the plugin
fix
Use ES module import syntax with 'import'
affects: >=1.0.0
gotchaTwig errors during build show unhelpful stack traces without template line numbers
fix
Enable source maps in Vite config: 'build.sourcemap: true'
affects: <=1.6.2
gotchaDrupal specific filters/ functions (e.g., '|trans') not available by default
fix
Register custom filters via the 'drupalFilter' export or configure them in plugin options
affects: >=1.0.0
deprecatedThe 'twig' option for custom Twig environment is deprecated in favor of 'twigOptions'
fix
Use 'twigOptions' instead of 'twig' in plugin config
affects: >=1.5.0
Errors
Common errors & fixes
Error: Cannot find module 'vite-plugin-twig-drupal'
Package not installed or wrong import path
fix
Run 'npm install vite-plugin-twig-drupal --save-dev' and ensure import path is correct
TypeError: twigDrupal is not a function
Using named import { twigDrupal } instead of default import
fix
Use 'import twigDrupal from 'vite-plugin-twig-drupal''
Error: Namespace '@components' not found
Missing namespace configuration in plugin options
fix
Add 'namespaces: { components: 'path/to/components' }' in vite.config.js
Upgrade
Version history
1.6.2latest on npm
Audit
Dependencies

No dependency data recorded yet.

Agent activity
6 hits · last 30 days
node
4
OpenAI (training)
2
Resources