fusile

library2.0.0jsnpmunverified

Fusile is a web asset precompiling file system proxy using FUSE to mount a virtual directory that compiles files on demand. Current stable version is v2.0.0, which switched from Babel 5 to Babel 6 (requires babel-core). It auto-loads installed transpilers (e.g., babel-core, coffee-script, less, node-sass, stylus) and compiles assets when accessed, with intelligent caching and optional file watching. Unlike build tools or module bundlers, it provides a proxy filesystem that serves compiled files transparently to any consumer (browser, server, linter). Maintained by Munter, now in maintenance mode.

web-framework devops

npm install fusile

github ↗package ↗

INSTALL

IMPORT

SIG · FUSILE

fusile

web-frameworkjavascriptv2.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

✓ import fusile from 'fusile'

✗ const fusile = require('fusile')

CLI tool used via command line; programmatic use is internal, no public API documented.

Fusile

✓ import { Fusile } from 'fusile'

If using TypeScript, type definitions may not exist; check @types/fusile.

config

✓ import { config } from 'fusile'

Config is not publicly documented; avoid relying on internal exports.

Mounts a FUSE filesystem that watches .jsx and .less files in ./src and compiles them on read in ./compiled.

fusile ./src ./compiled --watch "**/*.jsx" --watch "**/*.less"

fusile --version

Debug

Known issues

breakingv2.0.0 drops Babel 5 in favor of babel-core (Babel 6+). Existing setups using babel must upgrade to babel-core and add a .babelrc file.

fix

Replace 'babel' with 'babel-core' and create a .babelrc file. See https://babeljs.io/docs/usage/babelrc/

affects: >=2.0.0

gotchaRequires FUSE for macOS/Linux; not supported on Windows without third-party FUSE implementation.

fix

Install FUSE for macOS from osxfuse.github.io or for Linux via apt-get install fuse.

affects: >=0.0.0

gotchaTranspilers must be installed in the context of fusile (global or project root). Local devDependencies may not be found if fusile is installed globally.

fix

Install transpilers globally or run fusile from the project root where they are installed.

affects: >=0.0.0

deprecatedProject is in maintenance mode; no new features planned. v3.x roadmap items may never be implemented.

fix

Consider alternatives like webpack, vite, or esbuild for active development.

affects: >=1.0.0

gotchaFile watcher does not delete compiled files when source is removed; cache may serve stale files.

fix

Manually clear compiled directory or implement custom cleanup.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'babel'

Installed babel v5 instead of babel-core v6+.

fix

npm install babel-core --save and ensure .babelrc exists.

fusile: command not found

Fusile not installed globally or not in PATH.

fix

npm install -g fusile or use npx fusile.

Error: fuse device not found

FUSE is not installed or loaded.

fix

Install FUSE (e.g., osxfuse on macOS, fuse on Linux).

Upgrade

Version history

2.0.0latest on npm

Audit

Dependencies

babel-coreoptionalRequired for ES6+ transpilation (v2.0.0 broke compatibility with babel v5)

coffee-scriptoptionalOptional transpiler for CoffeeScript files

lessoptionalOptional transpiler for LESS files

node-sassoptionalOptional transpiler for Sass/SCSS files

stylusoptionalOptional transpiler for Stylus files

LiveScriptoptionalOptional transpiler for LiveScript files

cocooptionalOptional transpiler for Coco files

dogescriptoptionalOptional transpiler for Dogescript files

markedoptionalOptional transpiler for Markdown files

mythoptionalOptional transpiler for Myth CSS files

swigoptionalOptional transpiler for Swig templates

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/Munter/fusile ↗

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