Fusile

2.0.0 verified Fri May 01 auth: no javascript maintenance

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.

Common errors

error Error: Cannot find module 'babel' ↓

cause Installed babel v5 instead of babel-core v6+.

fix

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

error fusile: command not found ↓

cause Fusile not installed globally or not in PATH.

fix

npm install -g fusile or use npx fusile.

error Error: fuse device not found ↓

cause FUSE is not installed or loaded.

fix

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

Warnings

breaking v2.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/

gotcha Requires 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.

gotcha Transpilers 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.

deprecated Project 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.

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

fix Manually clear compiled directory or implement custom cleanup.

Install

npm install fusile

yarn add fusile

pnpm add fusile

Imports

default
wrong
```
const fusile = require('fusile')
```
correct
```
import fusile from '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.

Quickstart

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"