Fusion uses cache, configuration, and state directories as defined by environment variables and the root package identifier.
Note
If Fusion is used standalone, the root package is Fusion itself with
identifier valvoid/fusion. If Fusion is used as a dependency, for example as described in the
extensions chapter,
the root package identifier corresponds to the
top-level project, such as valvoid/package.
Linux / macOS
On Linux and macOS, Fusion follows the XDG Base Directory specification and checks the following environment variables:
$XDG_CACHE_HOME: preferred location for cache files$XDG_CONFIG_HOME: preferred location for configuration files$XDG_STATE_HOME: preferred location for state files
If the XDG variables are not set, Fusion falls back to the user home directory:
$HOME/.cache: default location for cache files$HOME/.config: default location for configuration files$HOME/.local/state: default location for state files
In addition, the paths are suffixed with the root package identifier in
lowercase. For example, for user jane with a standalone Fusion installation
and no XDG variables set, the paths would be:
/home/jane/.cache/valvoid/fusion: cache files/home/jane/.config/valvoid/fusion: configuration files/home/jane/.local/state/valvoid/fusion: state files
Windows
On Windows, Fusion checks the following environment variables:
%LOCALAPPDATA%: preferred location for user-specific application data%USERPROFILE%: fallback if preferred location not set
In addition, the paths are suffixed with the root package identifier, with
capitalization applied to each segment. For example, for user Jane with a
standalone Fusion installation, the paths would be:
C:\Users\Jane\AppData\Local\Valvoid\Fusion\cache: cache filesC:\Users\Jane\AppData\Local\Valvoid\Fusion\config: configuration filesC:\Users\Jane\AppData\Local\Valvoid\Fusion\state: state files