fflt

library0.0.5jsnpmunverified

A CLI tool to format, fix, lint, and typecheck only files that have been changed compared to another branch. Version 0.0.5, early development stage. Designed for incremental checks in Git workflows, reducing overhead on large codebases by focusing on diffed files. Supports custom branch, cached files, ignore patterns, and verbose output. Requires Node >=18.

devops

npm install fflt

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · FFLT

fflt

devopsjavascriptv0.0.5

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 fflt from 'fflt'

✗ const fflt = require('fflt')

Package is ESM-only; does not support CommonJS require()

runCommand

✓ import { runCommand } from 'fflt'

✗ import runCommand from 'fflt'

Named export for running commands programmatically

CLI

✓ import { CLI } from 'fflt'

CLI class for programmatic usage; introduced in v0.0.5

Initialize a config file and run fflt to only lint changed files compared to main branch.

npx fflt init npx fflt command 'eslint --fix' --branch main # or programmatically: import { runCommand } from 'fflt'; await runCommand('eslint --fix', { branch: 'main', cached: true });

Debug

Known issues

breakingfflt version 0.0.1 did not have the 'init' command; config was created manually.

fix

Upgrade to >=0.0.2 or manually create fflt.config.js.

affects: =0.0.1

deprecatedThe '--cached' flag is deprecated in favor of '--cached' (same spelling, but will be removed in future versions).

fix

Use '--cached' as before; no change needed yet.

affects: 0.0.3

gotchaRequires Node >=18.0; older versions throw engine error.

fix

Update Node to >=18.0.

affects: >=0.0.0

gotchaThe package does not include its own formatter/linter; it runs external tools like ESLint/Prettier. Ensure those are installed separately.

fix

Install required tools (e.g., npm install -D eslint prettier) before using fflt.

affects: >=0.0.0

Errors

Common errors & fixes

Error: Cannot find module 'fflt'

Package not installed or used with wrong module system (CommonJS).

fix

Install: npm install -D fflt. Use ESM import syntax (import fflt from 'fflt').

fflt: command not found

fflt not installed globally or not in PATH.

fix

Use npx fflt or add node_modules/.bin to PATH.

Error: fflt requires a clean git working tree. Commit or stash your changes.

fflt operates on git diff and needs a clean working tree to detect changes correctly.

fix

Commit or stash changes before running fflt.

Upgrade

Version history

0.0.5latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/vantaboard/fflt ↗

packagefflt ↗

homepagehttps://github.com/vantaboard/fflt#readme ↗