Vale: Your style, our editor

Heads up!

You can override the default StylesPath by manually defining a VALE_STYLES_PATH environment variable.

The StylesPath specifies where Vale should look for its external resources (e.g., styles and ignore files). The path value may be absolute or relative to the location of the parent .vale.ini file.

ini
# Here's an example of a relative path:
#
# .vale.ini
# ci/
# ├── vale/
# │   ├── styles/
StylesPath = ci/vale/styles

[*.md]
# `MyStyle` is a directory within
# `ci/vale/styles`.
BasedOnStyles = MyStyle

If you don’t specify a StylesPath in your .vale.ini file, Vale will use its default location:

OS	Search Locations
Windows	`%LOCALAPPDATA%\vale\styles`
macOS	`$HOME/Library/Application Support/vale/styles`
Unix	`$XDG_DATA_HOME/vale/styles`

(Run the vale ls-dirs command to see the exact locations on your system.)

Structure

A StylesPath contains two types of entries: styles and the special config directory.

console
$ tree styles
├───config     <-- Special directory
└───write-good <-- A style

The config directory is used internally by Vale and contains the following:

Directory	Description
`vocabularies`	Project-specific terminology lists.
`dictionaries`	Hunspell-compatible spelling dictionaries.
`templates`	Output format templates.
`actions`	Solutions to your custom rules.
`filters`	Configuration filters.
`scripts`	Tengo scripts.