blaze-install

👑 Why Blaze is Better Than the Competition

Auto-install as you code: blaze watch detects new require()/import statements and installs missing packages instantly. No more manual installs or broken builds.
Batch install: All missing packages are installed in one go for a smooth, fast workflow.
Plugin system: Add features like license checks, security audits, and more—no waiting for core updates.
Node.js core module filtering: Never installs fake or placeholder packages for built-in modules (fs, path, etc.).
Monorepo native: Handles workspaces and multi-package projects out of the box.
Modern CLI UX: Fast, clear output, progress bars, and actionable diagnostics.
Open, hackable, and community-driven: Easy to extend, transparent, and responsive to real developer needs.

Feature	Blaze	npm	pnpm	yarn	bun
Install dependencies	✅	✅	✅	✅	✅
Add a package	✅	✅	✅	✅	✅
Uninstall a package	✅	✅	✅	✅	✅
Update a package	✅	✅	✅	✅	✅
List installed packages	✅	✅	✅	✅	✅
Show outdated packages	✅	✅	✅	✅	✅
Show package info	✅	✅	✅	✅	⚠️
Publish a package	✅	✅	✅	✅	⚠️
Bump version	✅	✅	✅	✅	⚠️
Clean node_modules & cache	✅	✅	✅	✅	✅
Prune lockfile	✅	⚠️	✅	✅	❌
Full dependency tree resolution	✅	✅	✅	✅	⚠️
Blazing fast installs	✅	⚠️	✅	✅	✅
Global cache/store	✅	✅	✅	✅	✅
Offline mode	✅	✅	✅	✅	✅
Prefetch/cache warming	✅	❌	⚠️	⚠️	❌
Audit/security checks	✅	✅	✅	✅	⚠️
Audit fix	✅	✅	✅	✅	❌
Self-healing & diagnostics	✅	⚠️	⚠️	⚠️	❌
Robust error handling	✅	⚠️	⚠️	⚠️	❌
Peer/optional dep support	✅	✅	✅	✅	⚠️
Lifecycle scripts	✅	✅	✅	✅	⚠️
Beautiful CLI	✅	⚠️	✅	✅	✅
Interactive mode	✅	❌	⚠️	⚠️	❌
Modern UX	✅	⚠️	✅	✅	✅
Workspaces/monorepo support	✅	⚠️	✅	✅	⚠️
Dependency graph	✅	❌	❌	❌	❌
Plugin system	✅	❌	⚠️	⚠️	❌
.blazerc config	✅	❌	❌	❌	❌
.npmrc support	✅	✅	✅	✅	⚠️
Advanced flags	✅	✅	✅	✅	⚠️
Comprehensive CLI help/docs	✅	✅	✅	✅	⚠️
Website documentation	✅	✅	✅	✅	⚠️
Extensible plugin hooks	✅	❌	⚠️	⚠️	❌
Workspace/monorepo details	✅	⚠️	✅	✅	⚠️
Config files: .blazerc, .npmrc	✅	✅	✅	✅	⚠️

✅ = Best-in-class ⚠️ = Partial/complex/needs config ❌ = Not available

Blaze is the only package manager that truly keeps up with how you code—auto-installing, protecting, and empowering you as you work.
No more "missing module" errors, no more manual busywork, and a plugin system that adapts to your needs.

⚡

Blazing Fast Installs

Parallel downloads, global cache, metadata caching, and deduplication for instant installs.

📦

Full Dependency Tree Resolution

Handles all dependencies and lockfile support.

🏗️

Workspaces/Monorepo Support

Native, fast, and simple workspace management.

🎨

Beautiful CLI

Colored output, progress bars, and interactive upgrades.

🔒

Audit/Security Checks

Built-in blaze audit using the npm audit API.

🧩

Peer & Optional Dependency Support

Clear warnings and auto-install prompts for missing/incompatible peers.

🔄

Lifecycle Scripts

Full support for preinstall, install, postinstall, and more.

🛠️

Uninstall & Update

blaze uninstall <package>, blaze update <package>, and lockfile auto-pruning.

🧹

Lockfile Pruning

Only keeps what's needed—no stale dependencies.

💥

Robust Error Handling

Clear, actionable error messages and reporting.

🌍

Global Cache/Store

Dedupes across projects for cross-project speed.

🩺

Self-Healing & Diagnostics

blaze doctor checks and auto-fixes common issues.

📴

Offline Mode

Install from local cache only, no network required.

🚚

Prefetch/Cache Warming

blaze prefetch downloads and caches all dependencies for offline use.

🧑‍💻

Interactive Mode

Guided, menu-driven workflow for all major commands.

🔌

Plugin System

Extend and automate with before/after hooks for all major commands.

🕸️

Dependency Graph

Visualize dependencies with blaze graph (Mermaid.js output).

⚙️

.blazerc Config

Project-level defaults for CLI options.

🔑

.npmrc Support

Reads registry/auth settings from both project and user .npmrc.

✨

Modern UX

Progress bars, color, and clear output make every install or update a pleasure.

🛡️

Advanced Flags

--audit-fix, --no-lockfile, --ci, --offline, --json, --symlink, and more.

📚

Comprehensive Documentation

Full usage, advanced flags, and migration guides.

Official Blaze Plugins

Blaze supports a powerful plugin system. Here are the official plugins you can use or extend:

Plugin Name	Description	Lifecycle Hooks
licenseChecker	Reports non-allowed licenses for installed packages.	afterInstall, afterUpdate
notifyOnInstall	Notifies when install finishes.	afterInstall
securityAuditReporter	Reports security issues after install/update.	afterInstall, afterUpdate
dependencySizeReporter	Reports largest dependencies by size.	afterInstall, afterUpdate
customScriptRunner	Runs user-defined scripts before/after install/uninstall.	beforeInstall, afterInstall, afterUninstall
changelogNotifier	Notifies about changelog after update.	afterUpdate
outdatedDependencyNotifier	Warns if dependencies are outdated.	afterInstall, afterUpdate
postInstallScriptRunner	Runs a user-defined script after every install.	afterInstall
preCommitDepChecker	Blocks commit if dependencies are outdated/missing.	afterInstall, afterUpdate
duplicatePackageDetector	Warns if multiple versions of the same package are installed.	afterInstall, afterUpdate
unusedDependencyLinter	Scans for unused dependencies and suggests removal.	afterInstall, afterUpdate
tscTypeChecker	Runs TypeScript type check after install/update.	afterInstall, afterUpdate
eslintPrettierRunner	Runs ESLint/Prettier after install/update.	afterInstall, afterUpdate
githubIssueNotifier	Notifies if any installed package has open security issues on GitHub.	afterInstall, afterUpdate
changelogFetcher	Fetches and displays changelogs for updated packages.	afterUpdate
depAgeReporter	Warns if any dependency hasn't been updated in X months.	afterInstall, afterUpdate
nodeVersionChecker	Warns if any package is incompatible with current Node.js version.	afterInstall, afterUpdate
installProfiler	Reports how long each package took to install.	afterInstall
socialNotifier	Sends notification to Twitter/Discord/Slack after install/update.	afterInstall, afterUpdate
banner	Prints custom banner/ASCII art after install/update.	afterInstall, afterUpdate
healthScore	Scores all dependencies based on maintenance, popularity, security.	afterInstall, afterUpdate
peerAutoInstaller	Auto-installs all missing peer dependencies after install/update.	afterInstall, afterUpdate
sizeAnalyzer	Reports install size of each package, flags large ones.	afterInstall, afterUpdate
historyLogger	Logs every install/uninstall event to a file.	afterInstall, afterUninstall
mirrorSwitcher	Auto-switches to faster/closer npm registry mirror if default is slow.	beforeInstall, beforeUpdate
openDocs	Opens docs page for any newly installed package in browser.	afterInstall
vulnAutoReporter	Auto-files GitHub issue or sends email if critical vuln found.	afterInstall, afterUpdate
monorepoCrossLinkChecker	Ensures all workspace packages are properly linked and up to date.	afterInstall, afterUpdate

To test all plugins and their hooks, run:
node test-blaze-plugins.js

For more details on writing your own plugins, see the Plugin Development Guide.

Quick Start

npm install -g blaze-install

blaze install

blaze upgrade

blaze doctor

blaze graph

See README for full usage & advanced flags.

Auto-fix: blaze fix

blaze fix

Runs ESLint and Prettier in auto-fix mode on all source directories (src/, plugins/, test/) if they exist.
Removes unused dependencies from package.json and node_modules.
Updates outdated dependencies to their latest versions in package.json.
Runs blaze doctor with auto-fix to repair common project issues (lockfile, node_modules, symlinks, etc.).
Runs a security audit auto-fix if available.

Each step prints a summary and any actions taken. If no source directories are found, lint/fix is skipped with a clear message. If no unused or outdated dependencies are found, those steps are skipped.

Why blaze-install?

King of Node.js Installers: Unmatched speed, reliability, and developer experience.
All-in-one: Handles installs, upgrades, diagnostics, security, and more—no extra tools needed.
Modern, beautiful CLI: Progress bars, color, and actionable errors make every install a pleasure.
Monorepo ready: Native workspace support, blazing fast even in huge projects.
Extensible: Plugin system and config files for deep customization.
Offline & CI friendly: Cache warming, offline mode, and reproducible installs for any workflow.
Open source & community-driven: MIT licensed, transparent, and always improving.

All Features

📴 Offline Mode: Install fully from local cache with --offline.
🚚 Prefetch/Cache Warming: blaze prefetch downloads and caches all dependencies and tarballs for offline use.
🩺 Self-Healing & Diagnostics: blaze doctor --fix auto-repairs common issues (missing node_modules, lockfile, broken symlinks).
🧩 Enhanced Peer Dependency Handling: Clear warnings and auto-install prompt for missing/incompatible peers.
🕸️ Visual Dependency Graphs: blaze graph outputs Mermaid.js diagrams of your dependency tree.
⬆️ Interactive Upgrades: blaze upgrade for interactive, guided upgrades of outdated dependencies.
🏗️ Monorepo/Workspaces Support: Native, fast, and simple workspace management with --workspaces flag.
🔌 Plugin System: Before/after hooks for all major commands (install, uninstall, update, audit, clean). Deep extensibility.
⚡ Parallelized Installs: Parallel downloads, metadata caching, and deduplication for maximum speed.
📦 Full Dependency Tree Resolution: Handles all dependencies and lockfile support.
🛠️ Uninstall & Update: blaze uninstall <package>, blaze update <package>, and lockfile auto-pruning.
🔒 Audit/Security Checks: Built-in blaze audit using the npm audit API.
🔄 Lifecycle Script Support: Full support for preinstall, install, postinstall, and more.
💥 Robust Error Handling: Clear, actionable error messages and reporting.
🎨 Beautiful CLI: Colored output, progress bars, and interactive upgrades.
🧹 Lockfile Pruning: Only keeps what's needed—no stale dependencies.
🌍 Global Cache/Store: Dedupes across projects for cross-project speed.
⚙️ Modern Config: .blazerc for project-level defaults, .npmrc for registry/auth.
📚 Comprehensive Documentation: Full usage, advanced flags, and migration guides.
👑 Open Source & Community-Driven: MIT licensed, transparent, and always improving.

How does blaze-install compare to all major package managers?

Feature / Task	blaze-install	npm	yarn	pnpm	bun
Speed	🚀 Blazing fast: parallel downloads, global cache, deduplication	Slower, sequential	Fast, but less aggressive cache	Very fast, unique symlinked store	Extremely fast, native engine
Lockfile Cleanliness	Always pruned, no stale deps	Can become bloated	Can become bloated	Pruned, but can be complex	Pruned, but less mature
Workspaces/Monorepo	Native, fast, simple	Supported, but slower	Native, good UX	Native, very fast	Basic support
Beautiful CLI/UX	Progress bars, color, interactive upgrades	Minimal feedback	Progress bars, color	Progress bars, color	Minimal, but fast
Audit/Security	Built-in, fast, clear	Built-in, mature	Built-in	Built-in	Basic, still evolving
Plugin System	Yes, with hooks	No	No	Yes (via hooks)	No
Self-Healing/Doctor	Yes (`blaze doctor`)	No	No	No	No
Offline Mode	Yes, with prefetch	Limited	Yes	Yes	Yes
Global Cache/Store	Yes, dedupes across projects	No	Yes	Yes, unique store	Yes, but less mature
Peer/Optional Deps	Clear, robust handling	Sometimes cryptic	Sometimes cryptic	Clear, robust	Basic, improving
Lifecycle Scripts	Full parity	Supported	Supported	Supported	Supported
Dependency Graph	Yes (`blaze graph`)	No	No	No	No
Advanced Flags	Many (`--audit-fix`, `--no-lockfile`, `--ci`, etc.)	Some	Some	Many	Some
Modern Config	`.blazerc`, `.npmrc`	`.npmrc`	`.yarnrc`	`.npmrc`, `.pnpmfile.cjs`	`bunfig.toml`
Open Source	MIT, community-driven	Yes	Yes	Yes	Yes

What's New

✨ Interactive upgrades with blaze upgrade
🩺 Doctor diagnostics with blaze doctor
🕸️ Dependency graph with blaze graph
🧩 Plugin system for deep customization
🏗️ Workspaces and monorepo support
⚡ Faster installs and improved lockfile handling
🎨 Beautiful CLI with themes and progress bars

🔄 Auto-Install with `blaze watch`

blaze watch keeps your dependencies in sync with your code as you work.

Automatic install: Scans your project for require() and import statements and auto-installs any missing npm packages.
Batch install: Installs all missing packages in a single command for speed and convenience.
Node.js core module filtering: Never tries to install built-in Node.js modules (like fs, path, os, etc.)—only real npm packages are installed.
Works before and after: Detects missing packages both before you start the watcher (on startup) and as you add new imports/requires while coding.

blaze watch

Start the watcher in your project root, add any require('some-pkg') or import ... from 'some-pkg' to your code, and blaze will detect and install missing npm packages automatically. No more manual installs or missing dependency errors!

👑 Why Blaze is Better Than the Competition

Official Blaze Plugins

🔄 Auto-Install with blaze watch

🔄 Auto-Install with `blaze watch`