vituum

library2.0.2jsnpmunverified

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.

web-framework

npm install vituum

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · VITUUM

vituum

web-frameworkjavascriptv2.0.2

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.

vituum

✓ import vituum from 'vituum'

✗ const vituum = require('vituum')

Vituum is ESM-only and provides a default export. Using require() will fail.

VituumOptions

✓ import type { VituumOptions } from 'vituum'

✗ import { VituumOptions } from 'vituum'

VituumOptions is a type, so use type import to avoid runtime bundle inclusion.

defineConfig

✓ import { defineConfig } from 'vituum'

✗ import defineConfig from 'vituum'

defineConfig is a named export, not default. Version 2.0+ only.

Shows minimal Vite configuration with Vituum plugin and optional template engine setup.

// Install: npm i vituum --save-dev // vite.config.js import vituum from 'vituum' import { defineConfig } from 'vite' export default defineConfig({ plugins: [ vituum({ // Optional: configure template engine, e.g., Nunjucks // templates: { engine: 'nunjucks' } }) ] })

vituum --version

Debug

Known issues

breakingVituum v2 requires Vite 5+ and Node.js >=20.19.0 or >=22.12.0

fix

Update to Vite 5 and Node.js 20 LTS or newer.

affects: >=2.0.0

breakingDefault export changed from vituum to a function that returns an object in v2

fix

Update import to default export: import vituum from 'vituum' (no named import of vituum).

affects: <2.0.0

deprecatedThe 'presets' option is deprecated in v2 in favor of direct plugin configuration

fix

Remove presets and configure plugins directly in Vite's plugins array.

affects: >=1.0.0 <2.0.0

gotchaTemplate engines must be installed separately; Vituum does not bundle them

fix

Install required engine, e.g., npm install nunjucks

affects: >=1.0.0

gotchaVituum's default export includes a 'name' property that may conflict with other plugins

fix

Ensure no other plugin uses the same name 'vituum' in the same project.

affects: >=1.0.0

breakingVituum v2 no longer supports CommonJS (require)

fix

Convert to ESM: use import statements and ensure package.json has type: module.

affects: >=2.0.0

Errors

Common errors & fixes

Cannot find module 'vituum'

Vituum not installed or missing from dependencies

fix

Run npm install vituum --save-dev

ERR_REQUIRE_ESM

Using require() to import an ESM-only package

fix

Use import instead of require, and ensure your project is ESM (type: module in package.json).

TypeError: vituum is not a function

Incorrect import: importing named export instead of default

fix

Use import vituum from 'vituum' (default import).

Unknown engine 'ejs'

Template engine not installed or not supported

fix

Install the engine (e.g., npm install ejs) and check spelling in config.

Upgrade

Version history

2.0.2latest on npm

Audit

Dependencies

viterequiredCore runtime dependency - Vituum is a Vite plugin

Agent activity

5 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/vituum/vituum ↗

packagehttps://www.npmjs.com/package/vituum ↗

homepagehttps://vituum.dev ↗