Document Neovim Tailwind language server design

2026-06-27 17:50:48 +02:00
parent b62cfb719b
commit 789bc7514d
1 changed files with 32 additions and 0 deletions
@@ -0,0 +1,32 @@
+# Neovim Tailwind Language Server Design
+
+## Goal
+
+Add Tailwind CSS language-server support for the Laravel, Vue, and Inertia workflow without custom class extraction.
+
+## Design
+
+- Enable nvim-lspconfig's `tailwindcss` configuration with Neovim's current `vim.lsp.enable()` API.
+- Keep the server's default project-root detection, filetypes, and language mappings.
+- Let Mason install the `tailwindcss-language-server` package.
+- Extend the local Mason health check to report the Tailwind executable and include Tailwind in the Node runtime description.
+- Preserve the existing PHP, Vue, TypeScript, ESLint, HTML, CSS, JSON, and Emmet configuration.
+- Do not configure custom class helpers such as `clsx` or `cn`.
+
+## Files
+
+- Update `nvim/lua/tracer/plugins/lspconfig.lua` to enable `tailwindcss`.
+- Update `nvim/lua/mason/health.lua` to report `tailwindcss-language-server`.
+
+## Verification
+
+- Confirm the server is not enabled before the change.
+- Confirm Neovim loads the updated configuration without errors.
+- Confirm `tailwindcss` and the existing `vue_ls` and `ts_ls` configurations are enabled.
+- Confirm Mason installs the Tailwind language server and its executable is available.
+- Confirm the repository diff contains only the intended files.
+
+## Constraints
+
+- Preserve unrelated working-tree changes.
+- Do not use the tutorial's deprecated `require("lspconfig").tailwindcss.setup({})` API.