How to use

Four steps: install → grant your UAT domain → reproduce → download & replay. Chrome 116+ required.

  1. Install from the Chrome Web Store
  2. Add your UAT domain
  3. Hard-reload the UAT tab
  4. Reproduce and download
  5. Open the replay viewer

1 Install from the Chrome Web Store

Open the listing and click Add to Chrome:

Shadow Monitor on Chrome Web Store

Pin the extension from the puzzle-piece menu so the toolbar icon is easy to reach.

2 Add your UAT domain

Click the extension icon → open Settings (gear). Under UAT environments, read the disclosure, check I understand…, then type the hostname only (no https://, no path):

uat.example.com

Include the port when it is not 443, e.g. localhost.tmsystems.ai:3000.

Settings: disclosure checkbox before adding an origin
Acknowledge what will be captured, then add an origin.
Empty UAT environments form
Enter the hostname and click Add origin.
Hostname typed before adding origin
Chrome shows a permission prompt — allow it for that host only.
Origin granted in the list
You should see a pattern like https://your-host/*.

That single grant is enough for most teams. Leave Capture / Downloads / Encryption at their defaults unless you need something special.

3 Hard-reload the UAT tab

Open your UAT site and hard-reload once so capture scripts load from the start of the page:

  • Mac: Cmd+Shift+R
  • Windows / Linux: Ctrl+Shift+R

4 Reproduce and download

  1. Click the Shadow Monitor icon — status should show recording.
  2. Reproduce the bug as usual.
  3. Optionally describe what went wrong in the popup.
  4. Pick an export range (e.g. last 10 min or all) and click Download.

You get a uat-report-*.json.gz file in Downloads (or the folder you chose in Settings). Nothing is uploaded — the file stays on your machine until you share it.

Extension popup while recording with download button
Popup while recording — download the rolling buffer when the bug is reproduced.

5 Open the replay viewer

From the popup, click Open replay viewer, or open viewer/viewer.html from the extension package. Drop the .json.gz file onto the page to replay DOM, network, console, and storage.

Offline viewer with DOM replay and network panel
Local viewer — DOM replay on the left, DevTools-style panels on the right.

Tips

  • Each tab records in parallel. Download from the popup on the tab you care about.
  • Passwords, payment fields, and .uat-mask / data-uat-mask stay masked in DOM replay.
  • Turn off Record input values or Capture cookies in Settings if you need a tighter buffer.
  • Optional encryption (buffer on disk or encrypt-for-sharing) is in Settings — there is no passphrase recovery.

Need help? Contact support · Privacy policy