diff --git a/README.md b/README.md
index a95ed32..6e9fbd3 100644
--- a/README.md
+++ b/README.md
@@ -219,19 +219,19 @@ after that:
    *"pkgtui" Not Opened* since the binary isn't notarized — click
    **Done** (not Move to Bin), it's already on your `PATH`.
 
-   <img src="https://raw.githubusercontent.com/padovanl/pkgtui/main/assets/macos-first-run/01-not-opened.png" alt="macOS dialog reading pkgtui Not Opened, with Done and Move to Bin buttons" width="420">
+   <img src="https://raw.githubusercontent.com/padovanl/pkgtui/main/assets/macos-first-run/01-not-opened.png" alt="macOS dialog reading pkgtui Not Opened, with Done and Move to Bin buttons" width="260">
 
 2. Open **System Settings → Privacy & Security**, scroll down to the
    note that *"pkgtui" was blocked to protect your Mac*, and click
    **Allow Anyway**.
 
-   <img src="https://raw.githubusercontent.com/padovanl/pkgtui/main/assets/macos-first-run/02-allow-anyway.png" alt="macOS Privacy and Security settings showing pkgtui was blocked, with an Allow Anyway button" width="420">
+   <img src="https://raw.githubusercontent.com/padovanl/pkgtui/main/assets/macos-first-run/02-allow-anyway.png" alt="macOS Privacy and Security settings showing pkgtui was blocked, with an Allow Anyway button" width="260">
 
 3. Open a terminal and run `pkgtui` again — an *Open "pkgtui"?* prompt
    appears, click **Open Anyway**, then enter your password when asked.
    `pkgtui` starts normally from then on.
 
-   <img src="https://raw.githubusercontent.com/padovanl/pkgtui/main/assets/macos-first-run/03-open-anyway.png" alt="macOS dialog asking Open pkgtui, with Move to Bin, Open Anyway and Done buttons" width="420">
+   <img src="https://raw.githubusercontent.com/padovanl/pkgtui/main/assets/macos-first-run/03-open-anyway.png" alt="macOS dialog asking Open pkgtui, with Move to Bin, Open Anyway and Done buttons" width="260">
 
 (Thanks to [@Sk8teb0arder](https://github.com/Sk8teb0arder) for walking
 through this and sharing the screenshots.)
diff --git a/docs/index.html b/docs/index.html
index 05fda4c..fb72934 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -346,7 +346,7 @@
   .first-run ol { margin: 12px 0 0; padding-left: 20px; color: var(--rust); font-family: var(--serif); font-size: 0.92rem; line-height: 1.6; }
   .first-run li { margin-bottom: 14px; }
   .first-run li:last-child { margin-bottom: 0; }
-  .first-run img { display: block; width: 100%; max-width: 420px; height: auto; border: 1px solid var(--hairline); border-radius: 4px; margin-top: 8px; }
+  .first-run img { display: block; width: auto; max-width: 260px; height: auto; border: 1px solid var(--hairline); border-radius: 4px; margin-top: 8px; }
 
   /* ---- keybinding reference ---- */
   .key-chips { display: flex; flex-wrap: wrap; gap: 6px; margin-bottom: 34px; }