Settings

The extension contributes a small set of settings and defaults. Configure them in your VS Code settings.json (User or Workspace).

ree.reettierPath

• Type: string
• Default: ""

Absolute path to the reettier executable used for formatting. Leave it empty to use reettier from your PATH. Set it when Reettier is installed somewhere that isn't on your PATH:

{
    "ree.reettierPath": "/Users/you/.local/bin/reettier"
}

ree.formatOnSave

• Type: boolean
• Default: false

When enabled, formats JavaScript, TypeScript, CSS, and SQL files when you save them. Ree Templates uses reettier for JavaScript, TypeScript, and CSS, and reesql for SQL.

{
    "ree.formatOnSave": true
}

ree.translation.defaultLocale

• Type: string
• Default: "en-US"

Locale used for translation inline decorations, translation hover, and the locale selected for go-to-definition when a key exists in several locale files.

ree.envVarDescriptionsPath

• Type: string
• Default: "config/env_var_descriptions.ts"

Project-relative path to a TypeScript file exporting an ENV_VAR_DESCRIPTIONS object. The language server uses it for environment variable hovers in JavaScript and TypeScript files. It recognises documented Bun.env.NAME, process.env.NAME, bracket access, and require_env("NAME").

export const ENV_VAR_DESCRIPTIONS: Record<string, string> = {
    DEV_CONNECTION_STRING: "Development database connection string.",
};

The file is optional. The default descriptions file is watched and reloads when it changes.

Language defaults

The extension applies these defaults for the ree language automatically - you can override them, but you rarely need to set them yourself:

{
    "[ree]": {
        "editor.defaultFormatter": "reepolee.ree-templates"
    },
    "emmet.includeLanguages": {
        "ree": "html"
    }
}

• editor.defaultFormatter makes the extension the formatter for .ree files, so Format Document and format-on-save use reettier.
• emmet.includeLanguages enables Emmet HTML abbreviations inside Ree files.

Language server overrides

The extension normally starts the language server bundled in the installed VSIX. These settings are overrides for development or troubleshooting:

The bundled server provides diagnostics, completions, hover, go-to-definition, symbols, folding, and formatting for .ree files. It is not separately installed or distributed as a project dependency.

Commands

Related

• Formatting - how formatting works
• Reettier - the formatter binary behind the extension