ViewGrid Documentation
ViewGrid is an open-source browser developer extension providing a multi-viewport workspace for responsive web design and testing.
Unlike single-viewport DevTools or cloud-proxy emulators, ViewGrid renders real, live browser frames simultaneously in your browser with synchronized scrolling, clicks, and drag comparison.
Local analysis, when you need it
Version 1.0.4 packages the analysis engine in ViewGrid: no extra installation, API key or external analysis service.
Run a scoped check
Open Analysis, choose a mobile or desktop preview and run the check. One DOM scan collects performance observations, SEO, limited accessibility checks and GEO signals. Each tab shows only its own scope.
Read the evidence
Performance shows browser navigation and First Contentful Paint (FCP) observations when available. These are not Lighthouse scores, CrUX field data or Core Web Vitals ratings. Missing observations are marked as unavailable.
SEO, accessibility and GEO
Review metadata, headings, links and structured-data signals from the current rendered page. Accessibility checks are limited automatic suggestions, not a complete WCAG audit or certification. GEO describes page structure signals; it does not measure or guarantee visibility in AI answers. No site-wide crawl or security scan is performed.
Keep and share reports
Copy or download a Markdown report for the selected tab. Results remain available after closing the dialog during the workspace session; page or viewport changes mark them as stale. Rerun the check to refresh them.
A calmer workspace
Panels and the issues drawer toggle open and closed from the same control. Softer transitions respect reduced motion. Use 21 device profiles and 5 preset sets to inspect phone, tablet, laptop and desktop layouts.
Installation Guide
ViewGrid is officially available on both the Chrome Web Store and Firefox Add-ons (AMO). You can install with one click directly from the stores or load verified release packages manually:
Google Chrome / Brave / Edge / Arc (Manual Sideload)
- Download
viewgrid-1.0.4-chromium.zipfrom GitHub Releases. - Unzip the archive to a local folder on your computer.
- Navigate to
chrome://extensionsin your address bar. - Enable Developer mode in the top-right corner.
- Click Load unpacked and select the unzipped directory.
Mozilla Firefox / Zen Browser (Manual Sideload)
- Download
viewgrid-1.0.4-firefox.zipfrom GitHub Releases. - Navigate to
about:debugging#/runtime/this-firefoxin Firefox. - Click Load Temporary Add-on...
- Select the downloaded zip file (or manifest.json inside).
Quickstart
- Open the workspace: Click the ViewGrid extension icon in your browser toolbar, or press Alt+Shift+V (Cmd+Shift+V on macOS).
- Enter your target URL: Type any local URL (e.g.
http://localhost:5173) or live web address in the top input box and press Enter. - Pick devices or presets: Choose from presets like Standard Responsive or click + Add Device to select individual devices.
- Interact & Sync: Scroll, click buttons, or test forms in any viewport. All active viewports mirror your actions seamlessly.
Viewports & Device Profiles
Each viewport in ViewGrid represents an independent responsive canvas configured with:
- Resolution: Physical pixel width and height.
- Device Pixel Ratio (DPR): High-DPI screen emulation (e.g. 2x, 3x retina scaling).
- Orientation: Instant toggle between portrait and landscape mode.
- Hardware Bezels: Realistic phone and tablet shells (toggleable with F).
- Scale Slider: Zoom in/out without distorting CSS media query breakpoints.
Visual Diff & Compare Modes
Click ⚖ Compare in the workspace toolbar to inspect two viewports simultaneously:
⫴ Dual-Split Slider
Displays both devices side-by-side with an interactive draggable divider handle. Easily test how flexible containers behave.
▥ Overlay Curtain Diff
Overlays Device B directly on top of Device A with a vertical reveal curtain. Spot subtle padding shifts and font size discrepancies immediately.
⫿ Side-by-Side Dual View
Comfortable dual view designed for deep comparative inspection across wide desktop monitors.
Keyboard Shortcuts
Alt + Shift + VOpen ViewGrid workspace from any tab (Cmd+Shift+V on macOS)AOpen Add Device / Preset Picker dialogFToggle device hardware frames (borderless vs bezel mode)Shift + RReload all viewports simultaneouslyEscClose open modals (Compare, Device Picker, Issues Drawer)X-Frame-Options & CSP Handling
Many websites specify security response headers to prevent clickjacking:
X-Frame-Options: DENY Content-Security-Policy: frame-ancestors 'none'When you navigate inside a ViewGrid workspace tab, the extension registers a temporary session rule via DeclarativeNetRequest (Chromium) or webRequest (Firefox) to strip these headers strictly for sub_frame requests originating inside your workspace tab.
Framing exceptions apply within workspace tabs. Chromium removes XFO and CSP response headers for subframes; Firefox removes XFO and the frame-ancestors directive for direct previews. Normal tabs retain their framing headers. Preparing a preview can remove the selected site’s service-worker registrations, including those used by normal tabs; a later visit can register them again.