← Commit history
Replace ugly install screenshots with clean tight crops (dropped the blank-page + black-box shots); 2 good shots: the extensions page w/ loaded card, and the picker in the extension folder
4 files changed
+12−25
docs/INSTALL-FLOW.md+11−22@@ -128,31 +128,20 @@ loaded: ### What each step looks like (real screenshots) -**a) After `desktop_navigate`, verify the page ACTUALLY loaded - not just the omnibox.** The posted-Enter-sometimes does not commit: below, the URL bar reads `chrome://extensions` but the page never changed (it-still shows the prior content), so there is no Load unpacked button yet. Screenshot-verify the real-Extensions page rendered (tab title becomes "Extensions"); re-issue `desktop_navigate` if it did not.-(As of AD 1.9.34+, `desktop_navigate` is focus-neutral - it restores your foreground window and returns-an honest `navigated` signal - so this surfaced-the-window failure is fixed; older AD foregrounded.)+**1. The `chrome://extensions` page** - **Developer mode** on (top-right), the **Load unpacked** button,+and (after install) the **Adom** card loaded clean: Enabled, the pinned ID, an active service worker, and+**no red "Errors" button**. The screenshot is the only check that catches a card that loaded *with*+errors, so always read it. (Tip: after `desktop_navigate`, verify the page actually rendered - the tab+title becomes "Extensions" - not just that the omnibox shows the URL.) -+ -**b) Load unpacked opens the native picker in an ARBITRARY last-used directory** (here, Downloads) with-an empty Folder field. Never trust "it remembers the folder" - you must set the path:+**2. The Load-unpacked folder picker, pointed at the `extension/` folder** (`icons`, `src`, Folder =+"extension"). It opens in an arbitrary last-used directory, so the agent **brings it to the front and+types the path** (`bring_to_front` -> `ctrl+l` -> type -> Enter), then **screenshot-verifies the path+before** clicking **Select Folder** - the wrong folder loads a broken/old build silently: ---**c) After the agent fronts the picker and types the path** (`bring_to_front` -> `ctrl+l` -> type -> Enter) the picker is in the-`extension/` folder (`icons`, `src`, Folder = "extension"). **Screenshot-verify this path before** you-click **Select Folder** - selecting the wrong folder loads a broken/old build silently:----**d) After Select Folder, the card loaded clean** - Developer mode on, the Adom card Enabled, the pinned-ID, an active service worker, and **no red "Errors" button** (the only check that catches a card that-loaded *with* errors):--+ Chrome and Edge are independent: load it in whichever the user wants, or both. The host is registered per browser (step 3), so each browser the extension runs in connects its own host.
package.json+1−3@@ -41,9 +41,7 @@ "docs/UNINSTALL-FLOW.md", "screenshots/extensions-adom-card.png", "screenshots/install-folder-picker.png",- "screenshots/uninstall-confirm-bubble.png",- "screenshots/install-navigate-not-committed.png",- "screenshots/install-picker-wrong-dir.png"+ "screenshots/uninstall-confirm-bubble.png" ], "scripts": { "install": "./install.sh",
screenshots/extensions-adom-card.png⋯ 1 unchanged line ⋯
screenshots/install-folder-picker.png⋯ 1 unchanged line ⋯