Themis for Visual Studio Code

This extension makes Themis a native Visual Studio Code formatter for JavaScript, TypeScript, JSX, TSX, Svelte, and JSON.

The extension contains a bundled formatter, so it works without a global or project installation. In trusted workspaces it prefers a project-local @ikarii_warrior/themis dependency when one is available, allowing teams to pin the CLI, CI, and editor to the same version. Set themis.useLocalVersion to false to always use the bundled engine.

Format on save

Add this to .vscode/settings.json:

{
    "editor.formatOnSave": true,
    "[javascript][javascriptreact][typescript][typescriptreact][svelte][json]": {
        "editor.defaultFormatter": "ikarii.themis-formatter"
    }
}

The extension discovers themis.json and .themisignore exactly like the CLI. themis.configPath may select an explicit configuration file relative to the workspace folder. themis.typescriptQuotePreference and themis.respectObjectFormatting provide resource-level defaults; explicit values in themis.json take precedence.

Invalid syntax and invalid configuration are reported without changing the document. Ignored files are left untouched.

// themis-ignore, // themis-ignore-start, and // themis-ignore-end preserve targeted JavaScript/TypeScript syntax. They also work in supported Svelte script regions.

Local installation

Build and install the VSIX from the repository root:

npm run vscode:install
npm run vscode:package
code --install-extension editors/vscode/dist/themis-vscode-0.4.18.vsix

CSS formatting is outside Themis' scope. Remove Themis from existing [css] or [tailwindcss] default-formatter settings and use Format Document With… → Configure Default Formatter to select the built-in CSS formatter or your preferred language formatter.