catullus

library2.0.0jsnpmunverified

Catullus is a transpiler that compiles modern JavaScript syntax to compatible versions for older environments. It acts as a wrapper around Babel and presets to simplify build configuration. The current stable version is 2.0.0, with no active release cadence apparent from the metadata. Key differentiators: it provides a CLI command (catullus babel) and integrates with .babelrc. Compared to plain Babel, Catullus aims to reduce boilerplate but enters a space already well-covered by higher-level tools like Parcel or Webpack. The project appears unmaintained with sparse documentation and limited community adoption.

devops

npm install catullus

github ↗package ↗

INSTALL

IMPORT

SIG · CATULLUS

catullus

devopsjavascriptv2.0.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

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

default (command line)

✓ catullus babel src --out-dir lib/

✗ npx catullus

CLI usage: catullus is invoked directly as a command, not imported.

.babelrc

✓ Create a .babelrc file with presets and plugins.

✗ Using a different configuration file like babel.config.js

Catullus expects .babelrc; other formats may not work.

script in package.json

✓ "build": "catullus babel src --out-dir lib/"

✗ "build": "catullus src --out-dir lib/"

The 'babel' subcommand is required; omitting it will fail.

Quickstart showing installation, .babelrc setup, and CLI usage for transpiling a Node project.

npm install --save-dev catullus # Create .babelrc: echo '{"presets":[["env",{"targets":{"node":"6.9"}}]],"plugins":["transform-object-rest-spread"]}' > .babelrc # Add build script to package.json: # "build": "catullus babel src --out-dir lib/" # Then run: npm run build

catullus --version

Debug

Known issues

deprecatedCatullus relies on deprecated Babel 6 packages (e.g., babel-preset-env, babel-plugin-add-module-exports).

fix

Use Babel 7+ directly: replace with @babel/preset-env and update plugins.

affects: >=2.0.0

gotchaCatullus only processes .js files; other extensions are ignored.

fix

For non-JS files (e.g., .jsx, .ts), use Webpack or another bundler.

affects: >=2.0.0

gotchaThe command must include 'babel' subcommand (e.g., `catullus babel src`).

fix

Use `catullus babel` instead of just `catullus`.

affects: >=2.0.0

breakingPotential breaking change if moving from Babel 6 to Babel 7; Catullus is locked to Babel 6 presets.

fix

Migrate to @babel/preset-env (Babel 7) directly; Catullus may not support it.

affects: >=2.0.0

Errors

Common errors & fixes

Error: Cannot find module 'babel-preset-env'

Missing required Babel 6 dependency; Catullus expects these old packages.

fix

Install old Babel presets: npm install babel-preset-env babel-preset-react babel-preset-stage-2

Error: Command failed: catullus babel src --out-dir lib/

Missing .babelrc or invalid syntax in the configuration file.

fix

Create a valid .babelrc file in the project root.

Error: The 'babel' subcommand was not recognized.

Catullus requires 'babel' as a subcommand; calling 'catullus src' fails.

fix

Use 'catullus babel src' instead.

Upgrade

Version history

2.0.0latest on npm

Audit

Dependencies

@babel/corerequiredCore compilation engine

@babel/clirequiredCommand-line interface for transpilation

babel-preset-envoptionalPreset for environment targeting

babel-preset-reactoptionalPreset for React JSX

babel-preset-stage-2optionalPreset for stage-2 proposals

babel-plugin-transform-object-rest-spreadoptionalPlugin for object rest/spread

babel-plugin-transform-decorators-legacyoptionalPlugin for decorators

babel-plugin-add-module-exportsoptionalPlugin for CommonJS exports

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/Yann-Wang/catullus ↗

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