Flux is a lightweight, minimalistic package manager designed to streamline dependency management in JavaScript projects. It offers fast, reliable tools for installing, updating, removing, and managing packages — with more powerful features on the roadmap.
-
Initialize a new project
flux init
-
Install a package
flux install package-name
-
Install dependencies from package.json
flux install
-
Uninstall a package
flux uninstall package-name
-
Reinstall a package
flux reinstall package-name
-
Update a package
flux update package-name
-
List installed packages
flux list
-
Check for outdated packages
flux outdated
-
Search the package registry
flux search package-name
-
Run scripts defined in package.json
flux run script-name
- Dependency tree viewer (
flux tree) - Lockfile support for deterministic installs
- Custom registry support (e.g., Verdaccio, pnpm registry)
- Enhanced caching for faster installs
- Parallel installation of packages
- Improved error handling and diagnostics
- Support for workspace and monorepo management
- Interactive CLI prompts for easier usage
- Integration with popular CI/CD pipelines
- Automatic semantic versioning and changelog generation
- Offline mode for working without internet connection
- Package audit and vulnerability scanning
The current alpha release is available as a Windows installer.
-
Executable location in repo:
flux/install/install_flux.exe -
Direct download: Flux Installer v0.1.0-alpha
- Download the
.exeinstaller. - Run as Administrator.
If prompted by Windows Defender, click “Run anyway.”
(Note: The warning appears because we don’t yet have a signed publisher certificate. You can review the
install_flux.ps1script to verify its safety.)
To update Flux, simply re-run the latest installer — it will handle the update automatically.
Here’s a quick example to get you started:
flux init
flux install express
flux list
flux update express
flux uninstall express
flux run buildFor detailed documentation, visit the Wiki (coming soon).
We welcome contributors of all levels! Here’s how to get involved:
-
Fork this repository.
-
Create a feature branch:
git checkout -b feature/your-feature-name
-
Commit your changes and push:
git push origin feature/your-feature-name
-
Open a pull request with a clear description.
👉 Check the issues tab for open tasks, feature requests, or bugs.
Be part of building a better package manager for JavaScript developers!
- Download the alpha
- Share feedback or bug reports
- Submit pull requests
- Star the repository to show your support ⭐
Flux is open-source software, licensed under the MIT License.
✅ Note: As an alpha project, Flux is rapidly evolving — expect frequent changes and improvements as we move toward a stable release.