diff --git a/README.md b/README.md
index cc02601..36a5b58 100644
--- a/README.md
+++ b/README.md
@@ -1,18 +1,19 @@
 # sync-with-uv
 
+**Pin pre-commit hooks to the versions already resolved in your `uv.lock`.**
+One source of truth for black, ruff, mypy, and the rest.
+
+<p align="center">
+  <img src="./assets/readme/sync-flow.png" width="440"
+       alt="Versions resolved in uv.lock flow into .pre-commit-config.yaml: ruff rev v0.1.9 becomes v0.14.2, black rev 23.9.1 becomes 25.9.0">
+</p>
+
 [![Tests][tests-badge]][tests-link]
-[![uv][uv-badge]][uv-link]
-[![Ruff][ruff-badge]][ruff-link]
-[![Black][black-badge]][black-link]
 [![codecov][codecov-badge]][codecov-link]
-\
 [![PyPI version][pypi-version-badge]][pypi-link]
-[![PyPI platforms][pypi-platforms-badge]][pypi-link]
 [![Total downloads][pepy-badge]][pepy-link]
-\
 [![Made Using tsvikas/python-template][template-badge]][template-link]
 [![GitHub Discussion][github-discussions-badge]][github-discussions-link]
-[![PRs Welcome][prs-welcome-badge]][prs-welcome-link]
 
 ## Overview
 
@@ -162,24 +163,15 @@ using `${version}` as a placeholder for the package version.
 Interested in contributing?
 See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guideline.
 
-[black-badge]: https://img.shields.io/badge/code%20style-black-000000.svg
-[black-link]: https://github.com/psf/black
 [codecov-badge]: https://codecov.io/gh/tsvikas/sync-with-uv/graph/badge.svg
 [codecov-link]: https://codecov.io/gh/tsvikas/sync-with-uv
 [github-discussions-badge]: https://img.shields.io/static/v1?label=Discussions&message=Ask&color=blue&logo=github
 [github-discussions-link]: https://github.com/tsvikas/sync-with-uv/discussions
 [pepy-badge]: https://img.shields.io/pepy/dt/sync-with-uv
 [pepy-link]: https://pepy.tech/project/sync-with-uv
-[prs-welcome-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg
-[prs-welcome-link]: https://opensource.guide/how-to-contribute/
 [pypi-link]: https://pypi.org/project/sync-with-uv/
-[pypi-platforms-badge]: https://img.shields.io/pypi/pyversions/sync-with-uv
 [pypi-version-badge]: https://img.shields.io/pypi/v/sync-with-uv
-[ruff-badge]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json
-[ruff-link]: https://github.com/astral-sh/ruff
 [template-badge]: https://img.shields.io/badge/%F0%9F%9A%80_Made_Using-tsvikas%2Fpython--template-gold
 [template-link]: https://github.com/tsvikas/python-template
 [tests-badge]: https://github.com/tsvikas/sync-with-uv/actions/workflows/ci.yml/badge.svg
 [tests-link]: https://github.com/tsvikas/sync-with-uv/actions/workflows/ci.yml
-[uv-badge]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json
-[uv-link]: https://github.com/astral-sh/uv
diff --git a/assets/readme/sync-flow.png b/assets/readme/sync-flow.png
new file mode 100644
index 0000000..2e99ffe
Binary files /dev/null and b/assets/readme/sync-flow.png differ
diff --git a/assets/readme/sync-flow.svg b/assets/readme/sync-flow.svg
new file mode 100644
index 0000000..ce07f95
--- /dev/null
+++ b/assets/readme/sync-flow.svg
@@ -0,0 +1,67 @@
+<svg xmlns="http://www.w3.org/2000/svg"
+     width="400" height="600" viewBox="0 0 400 600"
+     role="img" aria-labelledby="flow-title flow-desc">
+  <title id="flow-title">How sync-with-uv updates a pre-commit config</title>
+  <desc id="flow-desc">The versions resolved in uv.lock (ruff 0.14.2, black 25.9.0, mypy 1.18.2) flow into .pre-commit-config.yaml, where rev v0.1.9 becomes v0.14.2 for ruff and 23.9.1 becomes 25.9.0 for black. The leading v is preserved per repository.</desc>
+
+  <defs>
+    <clipPath id="config-clip">
+      <rect x="24" y="316" width="352" height="252" rx="10"/>
+    </clipPath>
+    <style>
+      .mono { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; }
+    </style>
+  </defs>
+
+  <rect width="400" height="600" rx="16" fill="#0d1117"/>
+  <rect x="0.5" y="0.5" width="399" height="599" rx="15.5" fill="none" stroke="#21262d"/>
+
+  <g id="lock-source" class="mono">
+    <rect x="24" y="32" width="352" height="190" rx="10" fill="#161b22" stroke="#30363d"/>
+    <text x="44" y="64" font-size="16" font-weight="700" fill="#a371f7">uv.lock</text>
+    <path d="M 24 80 L 376 80" stroke="#30363d" stroke-width="1"/>
+
+    <g font-size="16">
+      <text x="44" y="118" fill="#7d8590">ruff</text>
+      <text x="200" y="118" fill="#adbac7">0.14.2</text>
+      <text x="44" y="152" fill="#7d8590">black</text>
+      <text x="200" y="152" fill="#adbac7">25.9.0</text>
+      <text x="44" y="186" fill="#7d8590">mypy</text>
+      <text x="200" y="186" fill="#adbac7">1.18.2</text>
+    </g>
+  </g>
+
+  <g id="flow-arrow">
+    <path d="M 200 246 L 200 292" stroke="#484f58" stroke-width="1.5"/>
+    <path d="M 194 284 L 200 292 L 206 284" fill="none" stroke="#484f58" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
+    <text class="mono" x="216" y="274" font-size="12" fill="#7d8590">sync</text>
+  </g>
+
+  <g id="config-target" class="mono">
+    <rect x="24" y="316" width="352" height="252" rx="10" fill="#161b22" stroke="#30363d"/>
+    <text x="44" y="348" font-size="14" fill="#7d8590">.pre-commit-config.yaml</text>
+    <path d="M 24 364 L 376 364" stroke="#30363d" stroke-width="1"/>
+
+    <g font-size="14" clip-path="url(#config-clip)">
+      <text x="64" y="396" fill="#7d8590">repo: astral-sh/ruff-pre-commit</text>
+
+      <rect x="25" y="404" width="350" height="28" fill="#f85149" fill-opacity="0.10"/>
+      <text x="44" y="423" fill="#f85149">-</text>
+      <text x="64" y="423" fill="#ffa198">rev: v0.1.9</text>
+
+      <rect x="25" y="432" width="350" height="28" fill="#3fb950" fill-opacity="0.12"/>
+      <text x="44" y="451" fill="#3fb950">+</text>
+      <text x="64" y="451" fill="#7ee787">rev: v0.14.2</text>
+
+      <text x="64" y="492" fill="#7d8590">repo: psf/black</text>
+
+      <rect x="25" y="500" width="350" height="28" fill="#f85149" fill-opacity="0.10"/>
+      <text x="44" y="519" fill="#f85149">-</text>
+      <text x="64" y="519" fill="#ffa198">rev: 23.9.1</text>
+
+      <rect x="25" y="528" width="350" height="28" fill="#3fb950" fill-opacity="0.12"/>
+      <text x="44" y="547" fill="#3fb950">+</text>
+      <text x="64" y="547" fill="#7ee787">rev: 25.9.0</text>
+    </g>
+  </g>
+</svg>