Get paths for storing things like data, config, cache, etc
Uses the correct OS-specific paths. Most developers get this wrong.
$ npm install env-paths
const envPaths = require('env-paths');
const paths = envPaths('MyApp');
paths.data;
//=> '/home/sindresorhus/.local/share/MyApp-nodejs'
paths.config
//=> '/home/sindresorhus/.config/MyApp-nodejs'
Note: It only generates the path strings. It doesn’t create the directories for you. You could use make-dir
to create the directories.
Type: string
Name of your project. Used to generate the paths.
Type: object
Type: string
Default: 'nodejs'
Don’t use this option unless you really have to!
Suffix appended to the project name to avoid name conflicts with native
apps. Pass an empty string to disable it.
Directory for data files.
Example locations (with the default nodejs
suffix):
~/Library/Application Support/MyApp-nodejs
%LOCALAPPDATA%\MyApp-nodejs\Data
(for example, C:\Users\USERNAME\AppData\Local\MyApp-nodejs\Data
)~/.local/share/MyApp-nodejs
(or $XDG_DATA_HOME/MyApp-nodejs
)Directory for config files.
Example locations (with the default nodejs
suffix):
~/Library/Preferences/MyApp-nodejs
%APPDATA%\MyApp-nodejs\Config
(for example, C:\Users\USERNAME\AppData\Roaming\MyApp-nodejs\Config
)~/.config/MyApp-nodejs
(or $XDG_CONFIG_HOME/MyApp-nodejs
)Directory for non-essential data files.
Example locations (with the default nodejs
suffix):
~/Library/Caches/MyApp-nodejs
%LOCALAPPDATA%\MyApp-nodejs\Cache
(for example, C:\Users\USERNAME\AppData\Local\MyApp-nodejs\Cache
)~/.cache/MyApp-nodejs
(or $XDG_CACHE_HOME/MyApp-nodejs
)Directory for log files.
Example locations (with the default nodejs
suffix):
~/Library/Logs/MyApp-nodejs
%LOCALAPPDATA%\MyApp-nodejs\Log
(for example, C:\Users\USERNAME\AppData\Local\MyApp-nodejs\Log
)~/.local/state/MyApp-nodejs
(or $XDG_STATE_HOME/MyApp-nodejs
)Directory for temporary files.
Example locations (with the default nodejs
suffix):
/var/folders/jf/f2twvvvs5jl_m49tf034ffpw0000gn/T/MyApp-nodejs
%LOCALAPPDATA%\Temp\MyApp-nodejs
(for example, C:\Users\USERNAME\AppData\Local\Temp\MyApp-nodejs
)/tmp/USERNAME/MyApp-nodejs