git-delta: Beautiful Syntax-Highlighted Diffs in Your Terminal

Why git-delta?

Replace plain text git diffs with colorful, syntax-highlighted, side-by-side diffs. Configure delta for line numbers, word-level diffs, and hyperlinks.

git-delta renders diffs with syntax highlighting, line numbers, and side-by-side comparison. It replaces Git's default pager with something you actually want to read.

By the end of this 7 min guide, you'll have a working git-delta setup and practical git-delta workflows you can use immediately.

• Understand what git-delta does and why it matters for Development
• Install and configure git-delta for your environment
• Build git-delta-specific workflows with real examples
• Troubleshoot common git-delta issues with concrete fixes

Installation & Git Config

Install git-delta:

brew install git-delta

• Development environment with appropriate permissions
• No prior git-delta experience needed
• A terminal with true color support
• Git for version-controlling your config

Syntax Themes & Side-by-Side

Add delta to your .gitconfig as the pager. The config options control side-by-side, line numbers, and theme — all customizable per repo.

Here's a foundational configuration to start with:

# .gitconfig
[core]
pager = delta
[interactive]
diffFilter = delta --color-only
[delta]
navigate = true
side-by-side = true
line-numbers = true

• Begin with this config and make small, incremental changes
• Document each setting with inline comments
• Test changes one at a time to isolate issues
• Keep your config in a Git repo for easy rollback and sharing

Line Numbers & Hunk Headers

With git-delta configured, these git-delta-specific workflows will save you time every day:

• Syntax-highlighted diffs in terminal
• Side-by-side comparison mode
• Line numbers and hunk headers
• Works with git diff, git show, git log -p

Interactive Diff Review

Once you're comfortable with git-delta basics, these advanced techniques will transform your git-delta workflow:

• Custom themes matching your editor
• Side-by-side with delta.side-by-side = true
• Hyperlinks to files and line numbers
• Integration with LazyGit for visual diffs

Rendering & Encoding Issues

Here are the most common git-delta issues and how to fix them:

• No colors? Ensure core.pager = delta in .gitconfig
• Side-by-side too wide? Use a narrower font or wider terminal
• Theme not found? Run delta --list-syntax-themes
• Slow on large diffs? It's instant — check terminal rendering

Diff Perfection

Congratulations — you now have a solid git-delta foundation. Here's where to go next:

• Explore the official git-delta documentation for features not covered here
• Join the git-delta community (GitHub Discussions, Discord, or Reddit)
• Check the related tutorials below for deeper git-delta dives
• Build your own git-delta configuration and share it with the community