Source: https://subagentura.tech/css-variables/

# CSS Variables LSP. Know which value wins.

Project-wide autocomplete, hover, navigation, rename, diagnostics, and color tools for CSS custom properties—not only the file currently open.

[Install for VS Code](https://marketplace.visualstudio.com/items?itemName=miclmn451.css-variables-vscode) [Install for Zed](https://zed.dev/extensions/css-variables)

[32,599 Zed gallery downloads](https://subagentura.tech/css-variables/#distribution)  Observed 21 Oct 2026 Six packaged targets

## Follow a variable through the whole project.

CSS custom properties are dynamic and contextual. The server keeps the speed of editor tooling while accounting for the cascade that decides what users see.

### One workspace view

Index definitions and usages in stylesheets, HTML, component files, and supported static Astro and Vite config. Parse supported CSS-in-JS in open JS/TS files.

### The value that applies

Hover accounts for !important, specificity, source order, and DOM context so competing definitions appear in useful order.

### Move and refactor

Jump to definitions, find references, and rename variables across the indexed workspace without losing fallbacks.

### Fix the rough edges

Diagnose undefined variables, create missing :root definitions, add fallbacks, and replace literal colors with existing tokens.

## Workspace-wide completion, for real.

A real Zed session running the Rust LSP. Suggestions include variables indexed from Astro, HTML, Svelte, SCSS, and JavaScript sources. Supported config is statically analyzed; arbitrary JavaScript is never executed.

Zed showing CSS variable autocomplete with values and definition paths from Astro, HTML, Svelte, SCSS, and JavaScript files

CSS Variables · project-wide suggestions in Zed [Evidence: resolved issue #16 ↗](https://github.com/lmn451/css-variables-zed/issues/16#issuecomment-4885155079)

## Choose the shortest install path.

Dedicated clients for VS Code and Zed; standalone Rust and TypeScript servers everywhere else.

VS CODE

### Install the extension

Native Rust servers for major platforms with a TypeScript fallback.

[Marketplace ↗](https://marketplace.visualstudio.com/items?itemName=miclmn451.css-variables-vscode) [Source ↗](https://github.com/lmn451/css-variables-vscode)

ZED

### Install from Zed

Native server discovery, download, caching, and fallback resolution.

[Zed gallery ↗](https://zed.dev/extensions/css-variables) [Source ↗](https://github.com/lmn451/css-variables-zed)

ANY LSP EDITOR

### Run the Rust server

Use Neovim, Helix, Emacs, or any client that launches an LSP over stdio.

[crates.io ↗](https://crates.io/crates/css-variable-lsp) [Source ↗](https://github.com/lmn451/css-lsp-rust)

UNIVERSAL FALLBACK

### Use the npm server

The TypeScript implementation remains available for Node-compatible environments.

[npm package ↗](https://www.npmjs.com/package/css-variable-lsp) [Source ↗](https://github.com/lmn451/css-lsp)

## Native first. Portable by design.

Four public components have separate versions and distribution paths. The feature descriptions above refer to the Rust server; the TypeScript fallback differs in cascade modeling and code actions.

CLIENT / A

### VS Code

Bundled native binaries with an automatic TypeScript fallback.

CLIENT / B

### Zed

Native discovery, download, caching, and fallback resolution.

CORE / C

### Rust LSP

Standalone stdio server and embeddable library. Release v0.3.7 provides Linux, macOS, and Windows binaries for x86_64 and aarch64.

FALLBACK / D

### TypeScript LSP

npm v1.0.22 supports Node 20 or Node 22 and later. Cascade modeling is best-effort and does not model DOM nesting or selector combinators.

## CSS Variables distribution snapshot.

Observed 21 October 2026. These public counters have different definitions and periods. They are not unique users, active usage, installs, or performance benchmarks, and must not be summed.

[Download the sourced JSON snapshot](https://subagentura.tech/css-variables/stats.json)

| Counter | Value | Scope and source |
| --- | --- | --- |
| Zed gallery downloads | 32,599 | Gallery counter at observation time; [official Zed listing](https://zed.dev/extensions/css-variables) . No time window is asserted. |
| npm TypeScript server · 30 days | 131 | [2026-09-19 through 2026-10-18, inclusive](https://api.npmjs.org/downloads/point/2026-09-19:2026-10-18/css-variable-lsp) . Package downloads can include repeat and automated downloads. |
| npm TypeScript server · 7 days | 5 | [2026-10-12 through 2026-10-18, inclusive](https://api.npmjs.org/downloads/point/2026-10-12:2026-10-18/css-variable-lsp) . Package downloads can include repeat and automated downloads. |

| Component | Version | Release or listing |
| --- | --- | --- |
| Rust language server | 0.3.7 | [Primary source](https://github.com/lmn451/css-lsp-rust/releases/tag/v0.3.7) |
| VS Code extension | 0.3.6 | [Primary source](https://marketplace.visualstudio.com/items?itemName=miclmn451.css-variables-vscode) |
| Zed extension | 0.1.1 | [Primary source](https://zed.dev/extensions/css-variables) |
| TypeScript language server | 1.0.22 | [Primary source](https://registry.npmjs.org/css-variable-lsp/latest) |

The Zed gallery labels its v0.1.1 listing updated 14 August 2026. The Rust v0.3.7 release was published 11 September 2026. The VS Code v0.3.6 documentation labels Windows ARM64 experimental. Later repository changes, including opt-in eager JS/TS scanning, are separate from those published releases.

## CSS Variables LSP questions.

Practical answers before you install or use the code.

### Which editors can use CSS Variables LSP?

VS Code and Zed have dedicated extensions. The standalone Rust server speaks LSP over stdio; its documentation includes Neovim and Helix setup examples. Other editors need a configured stdio LSP client.

### Does CSS Variables LSP scan CSS-in-JS?

The Rust server extracts CSS from supported string and tagged-template literals in open JS/TS documents. Opt-in eager scanning of unopened JS/TS files is documented in a later repository revision, after the published v0.3.7 release. Astro and Vite configuration support analyzes documented static structures; it does not execute arbitrary configuration code.

### Does hover show which CSS variable value applies?

The Rust implementation uses specificity, !important, source order, and DOM-aware matching. The TypeScript fallback documents best-effort cascade ordering without modeling DOM nesting or selector combinators. Feature descriptions on this page refer to the Rust implementation unless stated otherwise.

### Do I need Node.js to run the language server?

The standalone Rust release runs without Node.js; building the Rust server from source requires Rust 1.95 or later. The npm TypeScript server supports Node 20 or Node 22 and later. Editor extensions manage their own server-discovery and fallback paths.

### What license applies to the components?

The Rust server, TypeScript server, and Zed extension identify as GPL-3.0. As reviewed on 21 October 2026, the VS Code repository's LICENSE file says MIT while its README and Marketplace-rendered README say GPL-3.0. Those statements need reconciliation; this site does not assign one license to the whole product family.

## Sources and review.

Reviewed by [lmn451](https://github.com/lmn451)  on 21 October 2026.

The gallery and package counters are dated distribution snapshots. Editor support and feature details come from the linked component sources; they are not a browser-runtime correctness or speed benchmark.

- [Published Rust v0.3.7 documentation and editor setup](https://github.com/lmn451/css-lsp-rust/blob/2b1aa60d5d73ee30454e3906dc41ca70ab88ed04/README.md)

- [Later Rust source: opt-in eager JS scanning](https://github.com/lmn451/css-lsp-rust/blob/122eef369ca158b1d014fa8a161e85ec87da53f0/README.md)

- [VS Code v0.3.6 documentation and license files](https://github.com/lmn451/css-variables-vscode/tree/c672068f0c606e3385d32307ad709cb6c24fc4a6)

- [Zed v0.1.1 release source](https://github.com/lmn451/css-variables-zed/tree/f4dde4a2a075f916ec6bd08d0d48001eba0352f5)

- [TypeScript server documentation and limits](https://github.com/lmn451/css-lsp/blob/a84d4424961b0d95a723920fcbc01bcc41005843/README.md)

## Behind the build

- [Building a CSS variable language server](https://subagentura.tech/blog/building-a-css-variable-language-server/)
