`@pierre/diffs` is an open source diff and file rendering library that uses [Shiki](https://shiki.style/) with its JavaScript regex engine by default, with optional Shiki WebAssembly and Highlights backends. It's super customizable and packed with the fea
@pierre/diffs is an open source diff and file rendering library that uses
Shiki with its JavaScript regex engine by default, with
optional Shiki WebAssembly and Highlights backends. It's super customizable and
packed with the features you need. Made with love by
The Pierre Computer Company. Available as vanilla
JavaScript and React components.
View examples and read documentation on Diffs.com.
Features
Diff file versions, patches, and arbitrary files
Split or stacked layout
Automatically adapts to Shiki themes
Supports light and dark mode
Options for diff highlight styles, in-line highlighting, wrapping, line
numbers, and more
Supports custom fonts and font-feature-settings
Flexible annotation framework for injecting comments, annotations, and more
Add your own accept/reject changes UI
Select and highlight lines
Install
pnpm add @pierre/diffs
Agent skill
Install the agent skill for this package with the
Skills CLI:
We use pnpm for workspace package management and Bun for tests.
# From the root of the monorepo: setup dependenciespnpm install# Start the demo vite test servermoonx demo:dev# To run the docs (diffs site)moonx docs:dev-diffs
Testing
# Run tests and related command from within the package directorybun test# Update snapshotsbun test --update-snapshots# Type checkingmoonx diffs:typecheck
Tests are located in the test/ folder and use Bun's native testing framework
with snapshot support.
Publishing
Applicable to the Pierre team only.
# You may need to login first:pnpm login# Always run publish from within the package directory.cd packages/diffspnpm publish# In a CI-marked shell: CI= pnpm publish
Building the sprite
The diff UI uses an SVG sprite built from @pierre/icons. From the monorepo
root:
moonx root:icons
This reads SVGs from node_modules/@pierre/icons/svg and writes
packages/diffs/src/sprite.ts. Run after updating @pierre/icons or changing
sprite.config.js.