Local-first responsive testing and visual regression for developers.
MadScope renders any URL in real Chromium across multiple viewport sizes, captures screenshots, flags potential responsive issues, scores the page, and catches visual regressions — all locally, with no account and no telemetry.
It was built to replace the manual routine of resizing the browser and eyeballing layouts: enter a URL (including localhost while you develop), pick viewports, and get real renders, screenshots, findings and a deterministic health score in seconds.
The same core engine powers three surfaces: a desktop UI, a command-line interface for terminals and CI, and a local render server. Baselines saved today can be re-tested tomorrow — or on every pull request — with pixel-level diffs and a pass/fail exit code.
Current build: v1.1.1-preview.1
Preview build — testing
Current build: v1.1.1-preview.1 — the downloads above serve it. The antivirus report concerned the older v1.1.0 Windows installer: it was triggered by Kaspersky’s behavioral heuristics — not a malware signature — and we believe it is a false positive. The issue ended with the update: v1.1.1 is installed and tested on our Windows 11 PC with Kaspersky active, with no detections, warnings or alerts, and the installers scan clean with Kaspersky (0 detections across 807 objects). For extra assurance, compare each file’s SHA-256 against SHA256SUMS.txt on the release page. macOS builds are unsigned: on first launch, right-click → Open. Previous release: v1.1.0 →
x64 · Preview build v1.1.1-preview.1 — testing
x64 · Preview build v1.1.1-preview.1 — testing
x64 · Preview build v1.1.1-preview.1 — testing; portable: chmod +x, then run.
x64 · Preview build v1.1.1-preview.1 — testing; Debian / Ubuntu.
Run MadScope automatically in your CI pipeline to catch responsive and visual regressions before they reach production.
Playwright + Chromium with a dedicated browser context per viewport (device scale, isMobile, touch)
Mobile Small 320×568 up to Large Desktop 1920×1080, plus any custom width/height
Test http://localhost and 127.0.0.1 dev servers directly
Horizontal overflow, element overflow, text clipping, image overflow, small touch targets, overlaps, off-screen elements — all reported as potential issues
Transparent 0–100 formula documented in the repo — same page, same score
PNG/JPEG, viewport or full-page, stored locally with metadata and history
Side-by-side, overlay with opacity, before/after slider, deterministic diff image
Save baselines, re-test later or in CI with changed-pixel percentage and exit codes
madscope screenshot / baseline / test / config — same engine as the desktop app
Docker action with screenshot/baseline/test modes and JSON outputs; self-tested in CI, Marketplace listing pending
v1.1.0: Windows MSI/EXE, macOS ARM64 + Intel DMG, Linux AppImage/DEB built on CI
Default (the original design — its label was renamed from “Existing”, internal id and saved preferences unchanged), Terminal and Light — instant switching, persisted across restarts, all colors driven by CSS custom properties
App version, MIT license, Madwolf Studios website, GitHub repository and acknowledgments — verified in all three themes
Selectable, copyable findings with copy-all/copy-selected, plus a structured plain-text inspection report for handing to an AI coding agent
madscope.config.ts with validation and human-readable errors
Common breakpoints shown under every scan
Storage state / cookies with secret redaction
Type any URL — production or localhost — select presets or add a custom size, and MadScope renders each viewport in real Chromium with screenshots, timings and per-viewport results. The breakpoint ruler underneath shows where layout behavior is expected to change.
Every render is analyzed for horizontal overflow, element overflow, clipped text, oversized images, small touch targets, overlaps and off-screen elements. Findings are honestly labeled as potential issues, and the deterministic 0–100 health score makes regressions obvious at a glance.
Compare renders side-by-side, as an overlay, or with a before/after slider. Save a baseline, change the site, and run the visual test: MadScope reports the changed-pixel percentage per viewport and fails the run — with a CI-friendly exit code — when the threshold is exceeded.
A theme selector with exactly three choices: Default (the original dark design — its visible label was renamed from “Existing” in the post-v1.1.0 polish, while the internal id and saved preferences stay untouched), Terminal (near-black green-tinted charcoal, terminal-green accents, monospaced technical elements) and Light (bright surfaces, dark readable text, subtle borders). Switching is instant and the choice persists across restarts.
Every finding in the results is plain, selectable text with copy controls — copy one, tick checkboxes to copy selected, or copy all. The Copy AI report button produces a structured plain-text inspection report with only fields the engine really knows: URL, viewport, device profile, timestamp, health score and per-finding severity, selector and evidence. Paste it straight into a coding agent and it has everything needed to fix the issues.
A small About panel sits above the footer with everything a user needs to trust and find the project: a short description, the Madwolf Studios name linked to the official website, the source on GitHub, the actual app version, the MIT license linked to its text, and acknowledgments for the tools it is built on. Every value comes from the repository itself and is guarded by unit tests, and the panel renders correctly in all three themes.
Screenshots from the real running application, grouped by build. Every image carries the exact version it represents — browse with Previous/Next, arrow keys or swipe, and click any screenshot to enlarge it.
Captured 2026-10-11 from the real application running at this commit — unreleased preview, not a published release. The matching installers were built in GitHub Actions run 38136476510.
URL bar, viewport presets, responsive health score and three live Chromium renders — mobile, tablet and desktop.
Per-viewport potential issues with concrete element details, copy buttons and the health score breakdown.
Findings for the Mobile 390×844 viewport — overflow, touch-target and clipping checks on a real page.
Copy all errors puts every finding on the clipboard as plain text, with inline status feedback.
One click copies the structured, selectable inspection report for handing findings to a coding agent.
When a page cannot load, MadScope reports the exact browser error and concrete next steps.
The original MadScope design — now labelled Default (same theme, same saved preferences).
Near-black green-tinted surfaces, terminal-green accents, monospaced technical elements.
Bright white surfaces with dark readable text — for daylight work.
Version, MIT license, Madwolf Studios and GitHub links, acknowledgments and keyboard shortcuts.
Scroll, swipe or use ← → keys · click any screenshot to enlarge
The published v1.1.0 release build. The theme shown as “Existing” in these images is the released name — it is labelled Default in the preview build above.
URL bar, viewport picker, responsive health score and three live viewport renders.
The original dark design, the default theme of the v1.1.0 release.
Near-black green-tinted surfaces, terminal-green accents and monospaced technical elements.
Bright white surfaces with dark readable text and subtle borders.
Health score with overflow, clipping and touch-target findings per viewport.
Real diagnostics listed per viewport with copy controls and an AI-ready report button.
Status feedback after copying the structured AI-ready inspection report.
Side-by-side, overlay opacity and before/after slider between viewport renders.
Scroll, swipe or use ← → keys · click any screenshot to enlarge
MadScope v1.1.0 is released as free open-source software (MIT) at github.com/MadalinWolf/MadScope, with installers for Windows, macOS (ARM64 + Intel) and Linux. New in this release: three selectable themes (Default, Terminal, Light) with persistence, and diagnostics you can select and copy — including an AI-ready inspection report for handing findings to a coding agent. Next up: parallel viewport rendering, Firefox/WebKit engines and notarized macOS builds. The website’s downloads serve the build v1.1.1-preview.1 for Windows, macOS and Linux (theme renamed Existing → Default, new About panel). About the antivirus report: it concerned the older v1.1.0 Windows installer and was triggered by Kaspersky’s behavioral heuristics — not a malware signature — and we believe it is a false positive; the issue ended with the update. v1.1.1 is installed and tested on the maintainer’s Windows 11 PC with Kaspersky active with no alerts, and the installers scan clean (0 detections across 807 objects). The previous v1.1.0 release remains available on its release page. See SECURITY_AUDIT.md in the repository for verified facts and next steps.
MadScope is actively developed at Madwolf Studios. Development progress is documented through the Dev Log — new features, improvements, technical decisions and lessons learned.