Dprint

dprint

Fast pluggable code formatter.

Config Resolution

CC Misconception: "dprint is project-local only." Wrong. dprint supports:

1. Ancestor lookup - walks UP directory tree for dprint.json
2. Global fallback - ~/.config/dprint/dprint.json (or DPRINT_CONFIG_DIR)
3. Explicit path - dprint fmt -c /path/to/config.json

No config found anywhere → dprint errors.

Plugins

Plugins are WASM files loaded via URL in dprint.json:

{
  "plugins": [
    "https://plugins.dprint.dev/typescript-0.95.13.wasm",
    "https://plugins.dprint.dev/json-0.21.1.wasm",
    "https://plugins.dprint.dev/markdown-0.20.0.wasm"
  ]
}

Common plugins:

• typescript - TS/JS/JSX/TSX
• json - JSON/JSONC
• markdown - Markdown
• toml - TOML
• g-plane/pretty_yaml - YAML
• g-plane/malva - CSS/SCSS/Less
• g-plane/pretty_graphql - GraphQL

Plugin config - top-level keys match plugin name:

{
  "typescript": { "quoteStyle": "preferSingle", "semiColons": "asi" },
  "markdown": { "lineWidth": 100, "textWrap": "maintain" }
}

Update plugins: Check https://plugins.dprint.dev for latest versions.

CLI Commands

dprint fmt                    # Format files, write to disk
dprint check                  # Check if files need formatting (CI)
dprint fmt --diff             # Show diff without writing
dprint fmt --staged           # Format only git staged files
dprint fmt --stdin ts         # Format stdin as TypeScript
dprint fmt "src/**/*.ts"      # Format specific patterns
dprint init                   # Create dprint.json
dprint config update          # Update plugin versions
dprint clear-cache            # Clear plugin cache
dprint lsp                    # Start language server

Editor Integration

Zed

{
  "formatter": {
    "external": {
      "command": "dprint",
      "arguments": ["fmt", "--stdin", "{buffer_path}"]
    }
  }
}

VS Code

Install "dprint" extension. It uses dprint LSP automatically.

Neovim

Use null-ls or conform.nvim with dprint as formatter.

Dotfiles Pattern

For consistent formatting across all projects:

# 1. Create config in dotfiles
~/<dotfiles>/dprint/dprint.json

# 2. Set global config location (in shell rc)
export DPRINT_CONFIG_DIR="$HOME/<dotfiles>/dprint"

# Alternative: symlink to default location
mkdir -p ~/.config/dprint
ln -s ~/<dotfiles>/dprint/dprint.json ~/.config/dprint/dprint.json

Projects with local dprint.json override global. Projects without use global.

Excludes

{
  "excludes": [
    "**/node_modules",
    "**/*-lock.json",
    "**/dist",
    "**/build"
  ]
}

Reference

dprint help              # All commands
dprint help fmt          # Format command options
dprint output-resolved-config  # Debug: show effective config