Back to Explore

sindresorhus/env-paths

GitHub
2 watchersOpen source

Last release:

env-paths provides OS-specific filesystem paths for common app storage needs like data, config, cache, logs, and temp files. It generates path strings based on your project name, and you can use those paths to create the directories yourself.

Project status

  • Actively maintained: the most recent upstream updates are recent, with a v4.0.0 update on 2026-01-24 (and no long gap apparent since then), indicating continued maintenance rather than a dormant state.
  • Update cadence: cadence is moderate to low in earlier years (for example, 2021 to 2026), but the latest update is within the last year, so momentum looks current as of 2026-09-10.

AI summary generated

AI-generated from public sources. May be inaccurate. Report

Recent updates

  • v4.0.0

    Release v4.0.0 primarily upgrades the package to require Node.js 20. The code changes also introduce stricter filename safety validation for the `name` (and the appended `suffix`) used to construct paths, and update TypeScript declarations and package export metadata.

    Breaking
  • v3.0.0

    v3.0.0 converts env-paths to a pure ESM package and raises the supported Node.js version. The implementation and TypeScript declaration files were updated to match ESM usage.

    Breaking
  • v2.2.1

    v2.2.1 primarily updates documentation and type definition comments for env-paths by adding platform specific example locations for generated directories. It also updates the docs to clarify that the library only returns path strings and does not create directories, and modernizes the project CI configuration.

    Features
  • v2.2.0

    v2.2.0 primarily refactors the TypeScript type definitions to be CommonJS compatible. The code diff also includes a small runtime interop change to expose a `default` property on the CommonJS export, plus test tooling updates for TypeScript definition checking.

    Breaking
  • v2.1.0

    v2.1.0 primarily adds TypeScript type definitions for env-paths. The code changes are minimal and mostly focused on exporting for better interop with TypeScript/ESM tooling.

    Features
  • v2.0.0

    This release includes a major upgrade that enforces Node.js 6 as the minimum runtime. It also changes how the library resolves the `.config` path on Windows, moving from `%LOCALAPPDATA%` to `%APPDATA%`, which affects where your configuration files are stored.

    Breaking