{"id":20084,"library":"gulp-nf-prettier","title":"gulp-nf-prettier","description":"A Gulp plugin to format code using Prettier, forked from gulp-prettier with Netflix-specific requirements. Current stable version is 6.0.0 (pure ESM, Node 18+). Prettier is a peer dependency, allowing independent upgrades. Key differentiators: supports editorconfig, includes a `check` method for CI (errors on unformatted files), and offers options like `printWidth`, `parser`, `singleQuote`. Successor to v3.0.0 (Prettier v2) and v5.0.0 (Prettier v3). Alternative to gulp-prettier.","status":"active","version":"3.0.0","language":"javascript","source_language":"en","source_url":"https://github.com/bhargavrpatel/gulp-prettier","tags":["javascript","gulp","prettier","gulp-prettier","gulp-nf-prettier"],"install":[{"cmd":"npm install gulp-nf-prettier","lang":"bash","label":"npm"},{"cmd":"yarn add gulp-nf-prettier","lang":"bash","label":"yarn"},{"cmd":"pnpm add gulp-nf-prettier","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency required at runtime","package":"prettier","optional":false}],"imports":[{"note":"ESM-only since v6.0.0. CommonJS require will fail.","wrong":"const prettier = require('gulp-nf-prettier')","symbol":"default","correct":"import prettier from 'gulp-nf-prettier'"},{"note":"The package exports a single default function. Named export does not exist.","wrong":"import { prettier } from 'gulp-nf-prettier'","symbol":"prettier","correct":"import prettier from 'gulp-nf-prettier'"},{"note":"The check option is passed via the options object, not called as a separate method.","wrong":"prettier.check({ parser: 'babel' })","symbol":"gulp-nf-prettier options","correct":"prettier({ check: true, parser: 'babel' })"}],"quickstart":{"code":"import gulp from 'gulp';\nimport prettier from 'gulp-nf-prettier';\n\nexport function format() {\n  return gulp\n    .src('src/**/*.js', { base: './' })\n    .pipe(prettier({\n      printWidth: 100,\n      tabWidth: 2,\n      singleQuote: true,\n      trailingComma: 'es5',\n      bracketSpacing: true,\n      parser: 'babel'\n    }))\n    .pipe(gulp.dest('./'));\n}","lang":"javascript","description":"Demonstrates basic formatting task with gulp-nf-prettier, applying Prettier options and writing files back."},"warnings":[{"fix":"Upgrade Node.js to version 18 or later.","message":"Requires Node 18+. Dropped Node 12 and 14 in v5.0.0, Node 10 in v4.0.0.","severity":"breaking","affected_versions":">=5.0.0"},{"fix":"Use import syntax and ensure project is ESM (e.g., type: 'module' in package.json).","message":"Pure ESM since v6.0.0. CommonJS require() will throw.","severity":"breaking","affected_versions":">=6.0.0"},{"fix":"Review Prettier 3.0 migration guide. Options like trailingComma may need updating.","message":"Prettier upgrade to v3.0.0 in v5.0.0 introduced breaking changes in Prettier's API and defaults.","severity":"breaking","affected_versions":">=5.0.0"},{"fix":"Ensure Node >=10 and review Prettier 2.0 breaking changes.","message":"Upgrade to Prettier v2.0.0 in v3.0.0 dropped Node 4, 6, 8 support and included Prettier breaking changes.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Consider using the upstream gulp-prettier or other alternatives if Netflix-specific features aren't needed.","message":"gulp-nf-prettier is a fork; original gulp-prettier may have different maintenance.","severity":"deprecated","affected_versions":"all"},{"fix":"Run npm install prettier --save-dev.","message":"Prettier is a peer dependency; must be installed separately.","severity":"gotcha","affected_versions":"all"},{"fix":"Set check: false or handle build errors appropriately.","message":"The 'check' option errors on unformatted files; may break builds in CI if not expecting errors.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Install from GitHub: npm install https://github.com/bhargavrpatel/gulp-prettier","cause":"gulp-nf-prettier is a scoped or private fork; may not be published on npm.","error":"Cannot find module 'gulp-nf-prettier'"},{"fix":"Switch to import syntax or downgrade to v5.0.0.","cause":"Using CommonJS require() with v6.0.0+ (pure ESM).","error":"require() of ES Module not supported"},{"fix":"Install prettier: npm install prettier --save-dev","cause":"Peer dependency prettier not installed.","error":"Error: Cannot find module 'prettier'"},{"fix":"Use default import: import prettier from 'gulp-nf-prettier'","cause":"Trying to call a non-existent named export prettier.check() or using wrong import style.","error":"TypeError: prettier is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}