No description

Find a file

Barrett Ruth c51d625dc6 fix(parser): detect filetype from existing buffer Files detected via shebang or modeline (e.g., `build` with `#!/bin/bash`) weren't getting syntax highlighting because `vim.filetype.match()` only does filename-based detection. Now `get_ft_from_filename()` first checks if a buffer already exists for the file and uses its detected filetype. This requires knowing the repo root to construct the full path, so: - `parse_buffer()` reads `b:diffs_repo_root` or `b:git_dir` (fugitive) - `commands.lua` sets `b:diffs_repo_root` on diff buffers it creates Co-authored-by: phanen <phanen@qq.com>		2026-02-05 00:13:32 -05:00
.github	fix: remove useless ci script	2026-02-04 15:39:27 -05:00
doc	docs: add fugitive status buffer keymaps documentation	2026-02-04 23:37:39 -05:00
lua/diffs	fix(parser): detect filetype from existing buffer	2026-02-05 00:13:32 -05:00
plugin	feat(fugitive): add status buffer keymaps for unified diffs	2026-02-04 22:23:21 -05:00
spec	fix(parser): detect filetype from existing buffer	2026-02-05 00:13:32 -05:00
.busted	feat(test): testing infrastructure	2026-02-01 23:09:05 -05:00
.editorconfig	feat: initial setup files	2026-02-01 16:30:24 -05:00
.gitignore	feat: initial setup files	2026-02-01 16:30:24 -05:00
.luarc.json	feat: initial setup files	2026-02-01 16:30:24 -05:00
.pre-commit-config.yaml	fix: use yaml, not yml YAML file extension	2026-02-02 22:14:04 -05:00
.prettierignore	feat: initial setup files	2026-02-01 16:30:24 -05:00
.prettierrc	fix: use yaml, not yml YAML file extension	2026-02-02 22:14:04 -05:00
diffs.nvim-scm-1.rockspec	feat: rename everything	2026-02-02 22:09:13 -05:00
LICENSE	feat: initial setup files	2026-02-01 16:30:24 -05:00
README.md	docs: add fugitive status buffer keymaps documentation	2026-02-04 23:37:39 -05:00
selene.toml	feat: initial setup files	2026-02-01 16:30:24 -05:00
stylua.toml	feat: initial setup files	2026-02-01 16:30:24 -05:00
vim.toml	cleanup	2026-02-02 14:06:58 -05:00

README.md

diffs.nvim

Syntax highlighting for diffs in Neovim

Enhance vim-fugitive and Neovim's built-in diff mode with language-aware syntax highlighting.

Features

Treesitter syntax highlighting in :Git diffs and commit views
Diff header highlighting (diff --git, index, ---, +++)
:Gdiffsplit / :Gvdiffsplit syntax through diff backgrounds
:Gdiff unified diff against any git revision with syntax highlighting
Fugitive status buffer keymaps (du/dU) for unified diffs
Background-only diff colors for any &diff buffer (:diffthis, vimdiff)
Vim syntax fallback for languages without a treesitter parser
Hunk header context highlighting (@@ ... @@ function foo())
Configurable debouncing, max lines, and diff prefix concealment

Requirements

Neovim 0.9.0+

Installation

Install with your package manager of choice or via luarocks:

luarocks install diffs.nvim

Documentation

:help diffs.nvim

Known Limitations

Incomplete syntax context: Treesitter parses each diff hunk in isolation without surrounding code context. When a hunk shows lines added to an existing block (e.g., adding a plugin inside return { ... }), the parser doesn't see the return statement and may produce incorrect highlighting. This is inherent to parsing code fragments—no diff tooling solves this without significant complexity.
Syntax flashing: diffs.nvim hooks into the FileType fugitive event triggered by vim-fugitive, at which point the buffer is preliminarily painted. The buffer is then re-painted after debounce_ms milliseconds, causing an unavoidable visual "flash" even when debounce_ms = 0.
Conflicting diff plugins: diffs.nvim may not interact well with other plugins that modify diff highlighting. Known plugins that may conflict:
- diffview.nvim - provides its own diff highlighting and conflict resolution UI
- mini.diff - visualizes buffer differences with its own highlighting system
- gitsigns.nvim - generally compatible, but both plugins modifying line highlights may produce unexpected results
- git-conflict.nvim - conflict marker highlighting may overlap with diffs.nvim