@pierre/diffs is an open source diff and code rendering library. It's built on Shiki for syntax highlighting and theming, is super customizable, and comes packed with features. Made with love by The Pierre Computer Company.
Currently v1.0.1
Choose from stacked (unified) or split (side-by-side). Both use CSS Grid and Shadow DOM under the hood, meaning fewer DOM nodes and faster rendering.
We built @pierre/diffs on top of Shiki for syntax highlighting and general theming. Our components automatically adapt to blend in with your theme selection, including across color modes.
Love the Pierre themes? Install our Pierre VS Code Theme pack with light and dark flavors.
Your diffs, your choice. Render changed lines with classic diff indicators (+/–), full-width background colors, or vertical bars. You can even highlight inline changes—character or word based—and toggle line wrapping, hide numbers, and more.
@pierre/diffs adapts to any font, font-size, line-height, and even font-feature-settings you may have set. Configure font options with your preferred CSS method globally or on a per-component basis.
38 unmodified lines39 if !exists {40 return nil, false41 }42
43 now := time.Now()44 expired := now.After(item.ExpiresAt)45 if expired {43 if time.Now().After(item.ExpiresAt) {44 delete(c.items, key)47 c.onEviction(key, item.Value)45 return nil, false46 }47
48 return item.Value, true10 unmodified lines@pierre/diffs provide a flexible annotation framework for injecting additional content and context. Use it to render your own line comments, annotations from CI jobs, and other third-party content.
2 unmodified lines3from typing import Optional4
5SECRET_KEY = "your-secret-key"6
7def create_token(user_id: str, expires_in: int = 3600) -> str:7def create_token(user_id: str, role: str = "user", expires_in: int = 3600) -> str:8 payload = {9 "sub": user_id,10 "role": role,11 "exp": time.time() + expires_in12 }13 return jwt.encode(payload, SECRET_KEY, algorithm="HS256")14
14def verify_token(token: str) -> Optional[str]:15def verify_token(token: str) -> Optional[dict]:16 try:17 payload = jwt.decode(token, SECRET_KEY, algorithms=["HS256"])18 if payload["exp"] < time.time():19 return None19 return payload["sub"]20 return {"user_id": payload["sub"], "role": payload["role"]}Should we validate the role parameter? We could restrict it to a set of allowed values.
Good idea, maybe use a Literal type or an enum.
Agreed, we should also update verify_token to return the role.
Annotations can also be used to build interactive code review interfaces similar to AI-assisted coding tools like Cursor. Use it to track the state of each change, inject custom UI like accept/reject buttons, and provide immediate visual feedback.
4 unmodified lines5 <title>Welcome</title>6</head>7<body>8 <header>9 <h1>Welcome</h1>10 <p>Thanks for visiting</p>9 <h1>Welcome to Our Site</h1>10 <p>We're glad you're here</p>11 <a href="/about" class="btn">Learn More</a>Turn on line selection with enableLineSelection: true. When enabled, clicking a line number will select that line. Click and drag to select multiple lines, or hold Shift and click to extend your selection. You can also control the selection programmatically. Also selections will elegantly manage the differences between split and unified views.
In addition to rendering standard Git diffs and patches, you can pass any two files in @pierre/diffs and get a diff between them. This is especially useful when comparing across generative snapshots where linear history isn't always available. Edit the css below to see the diff.
1.pizza {2 display: flex;3 justify-content: center;3}Our team has decades of cumulative experience in open source, developer tools, and more. We’ve worked on projects like Coinbase, GitHub, Bootstrap, Twitter, Medium, and more. This stuff is our bread and butter, and we’re happy to share it with you.