Repository navigation
First tagged release of esgun: npm-compatible dependency management and frontend bundling in one Go binary, without Node, npm, or Bun.
Included
- npm dependency management, frozen installs, package-lock.json v3, SHA-512 tarball verification, and OSV auditing.
- Staged ESM/IIFE builds, named profiles, static copies, and curated tree copies.
- Config-aware watching, including atomic manifest saves and safe watch-path reloads (#1).
- Optional deterministic gzip output, with configurable extensions/level and original-file retention (#2).
- Opt-in
preserveRootpublishing for mounted output directories, with backup/rollback and private-directory permission protection (#3). - Updated installation and configuration docs, executable combined example, and changelog (#4). The project-tool install command is
go get -tool.
Install
Download an archive matching your OS and architecture below, extract it, and put esgun (or esgun.exe) on your PATH. Verify the archive against SHA256SUMS.
Or install from source with Go 1.25.10 or newer:
go install github.com/oddship/esgun@v0.1.0For a project-pinned tool:
go get -tool github.com/oddship/esgun@v0.1.0
go tool esgun buildCompatibility and validation
Gzip and preserveRoot are opt-in. Mounted-root publishing is not an atomic directory swap and requires backup space; readers may see partially populated output during publication. The resolver remains flat and single-package; workspaces, private-registry authentication, and package publishing are not supported.
The reviewed source passes race-enabled tests and go vet on Go 1.25.10, including cross-filesystem publication and permission/rollback checks. Combined CLI and documented-example checks pass. All six targets cross-compile with CGO disabled; the extracted Linux amd64 archive also passed an executable build/gzip/root-preservation smoke test. Archives include clean source/build metadata and third-party license notices.