Global Configuration

Starting in dprint 0.51, you can maintain a global configuration file that applies formatting config when the current folder does not have a local dprint configuration file.

Initializing a Global Configuration

Create a global configuration file by running:

dprint init --global

This creates a dprint.jsonc file in your system's configuration directory. The default location is:

• Linux/macOS: ~/.config/dprint/dprint.jsonc (or $XDG_CONFIG_HOME/dprint/dprint.jsonc)
  • Note: On macOS, it will use the config file in $HOME/Library/Application Support/dprint if that folder exists.
• Windows: %APPDATA%\dprint\dprint.jsonc

You can customize the global config directory by setting the DPRINT_CONFIG_DIR environment variable.

Managing the Global Configuration

Add plugins to your global configuration (alternatively use the -g alias instead of --global):

dprint config add --global typescript

Update plugins in your global configuration:

dprint config update --global

Edit your global configuration file:

dprint config edit --global

The editor to use for the global config follows the same rules as Editing Config via CLI (set the DPRINT_EDITOR environment variable to customize it)

Using the Global Configuration

Once setup, the global configuration will be used by default when there's no dprint configuration file in the current directory tree; however, to prevent accidentally formatting such directories, a prompt is shown when calling dprint fmt:

> dprint fmt
Warning You're not in a dprint project. Format '/home/david/dev/scratch' anyway? (Y/n) █

Hint: Specify the directory to bypass this prompt in the future (ex. `dprint fmt .`)

As the hint states, you can bypass the confirmation prompt by providing the current directory:

> dprint fmt .
Formatted 1 file.

To format files using only the global configuration and ignore local configuration files use:

dprint fmt --config-discovery=global