difflicious 0.12.0

A sleek web-based git diff visualization tool for developers

Difflicious

A local web application for reviewing git diffs. Run it in your working directory and view your changes in a browser with side-by-side visualization, syntax highlighting, and context expansion.

Screenshots

Light mode	Dark mode

To regenerate: uv run python scripts/screenshot.py Prerequisites: uv add --dev playwright && uv run playwright install chromium

Installation

pip install difflicious
difflicious

Open http://localhost:5000 in your browser.

See INSTALLATION.md for Docker, source installation, and full configuration options.

Features

• Side-by-side diff view with line numbering
• Syntax highlighting for 100+ languages (via Pygments)
• Context expansion to see more surrounding code
• Search and filter across files
• Light and dark themes
• Live auto-reload on file changes (SSE)
• Font customization via DIFFLICIOUS_FONT environment variable

Configuration

Set environment variables to configure behavior:

Variable	Default	Description
DIFFLICIOUS_PORT	5000	Port to listen on
DIFFLICIOUS_HOST	127.0.0.1	Host to bind to
DIFFLICIOUS_FONT	jetbrains-mono	Code font (see --list-fonts)
DIFFLICIOUS_DISABLE_GOOGLE_FONTS	false	Use system fonts only
DIFFLICIOUS_AUTO_RELOAD	true	Auto-reload on file changes
DIFFLICIOUS_DEBUG	false	Verbose debug logging

See INSTALLATION.md for full configuration details.

Technology

• Backend: Flask, GitPython, Pygments, unidiff
• Frontend: Alpine.js, Tailwind CSS
• Real-time: Server-Sent Events

Documentation

• INSTALLATION.md — installation options, configuration, environment variables
• DEVELOPING.md — development setup, testing, code conventions
• CHANGELOG.md — version history
• docs/CSS-STYLE-GUIDE.md — CSS conventions and design tokens
• docs/TROUBLESHOOTING.md — common issues

Contributing

See CONTRIBUTING.md.

License

MIT License — see LICENSE file for details.