{"id":22959,"library":"vituum","title":"Vituum","description":"Vituum is a fast static site generator and plugin for Vite that enables rapid prototyping with template engines (Nunjucks, Liquid, Handlebars, etc.). The current stable version is 2.0.2, released with a focus on stability and compatibility with Vite 5+. It is maintained actively with regular updates. Key differentiators include its minimalist core that leverages Vite's native features, straightforward configuration, and built-in support for multiple template engines without needing additional plugins. It is ideal for building static sites, email templates, and rapid prototypes directly within the Vite ecosystem.","status":"active","version":"2.0.2","language":"javascript","source_language":"en","source_url":"https://github.com/vituum/vituum","tags":["javascript","vituum","vite","vite-plugin","typescript"],"install":[{"cmd":"npm install vituum","lang":"bash","label":"npm"},{"cmd":"yarn add vituum","lang":"bash","label":"yarn"},{"cmd":"pnpm add vituum","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Core runtime dependency - Vituum is a Vite plugin","package":"vite","optional":false}],"imports":[{"note":"Vituum is ESM-only and provides a default export. Using require() will fail.","wrong":"const vituum = require('vituum')","symbol":"vituum","correct":"import vituum from 'vituum'"},{"note":"VituumOptions is a type, so use type import to avoid runtime bundle inclusion.","wrong":"import { VituumOptions } from 'vituum'","symbol":"VituumOptions","correct":"import type { VituumOptions } from 'vituum'"},{"note":"defineConfig is a named export, not default. Version 2.0+ only.","wrong":"import defineConfig from 'vituum'","symbol":"defineConfig","correct":"import { defineConfig } from 'vituum'"}],"quickstart":{"code":"// Install: npm i vituum --save-dev\n// vite.config.js\nimport vituum from 'vituum'\nimport { defineConfig } from 'vite'\n\nexport default defineConfig({\n  plugins: [\n    vituum({\n      // Optional: configure template engine, e.g., Nunjucks\n      // templates: { engine: 'nunjucks' }\n    })\n  ]\n})","lang":"typescript","description":"Shows minimal Vite configuration with Vituum plugin and optional template engine setup."},"warnings":[{"fix":"Update to Vite 5 and Node.js 20 LTS or newer.","message":"Vituum v2 requires Vite 5+ and Node.js >=20.19.0 or >=22.12.0","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Update import to default export: import vituum from 'vituum' (no named import of vituum).","message":"Default export changed from vituum to a function that returns an object in v2","severity":"breaking","affected_versions":"<2.0.0"},{"fix":"Remove presets and configure plugins directly in Vite's plugins array.","message":"The 'presets' option is deprecated in v2 in favor of direct plugin configuration","severity":"deprecated","affected_versions":">=1.0.0 <2.0.0"},{"fix":"Install required engine, e.g., npm install nunjucks","message":"Template engines must be installed separately; Vituum does not bundle them","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Ensure no other plugin uses the same name 'vituum' in the same project.","message":"Vituum's default export includes a 'name' property that may conflict with other plugins","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Convert to ESM: use import statements and ensure package.json has type: module.","message":"Vituum v2 no longer supports CommonJS (require)","severity":"breaking","affected_versions":">=2.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run npm install vituum --save-dev","cause":"Vituum not installed or missing from dependencies","error":"Cannot find module 'vituum'"},{"fix":"Use import instead of require, and ensure your project is ESM (type: module in package.json).","cause":"Using require() to import an ESM-only package","error":"ERR_REQUIRE_ESM"},{"fix":"Use import vituum from 'vituum' (default import).","cause":"Incorrect import: importing named export instead of default","error":"TypeError: vituum is not a function"},{"fix":"Install the engine (e.g., npm install ejs) and check spelling in config.","cause":"Template engine not installed or not supported","error":"Unknown engine 'ejs'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}