Recommended Free Tools
Increase Percy’s responsive coverage by adding the required pixel widths to snapshot.widths in a version 2 .percy.yml file, then run your test through Percy CLI. For example, this configuration captures 375 px, 768 px and 1280 px viewports:
version: 2
snapshot:
widths: [375, 768, 1280]
min-height: 1024The widths are project choices, not a universal Percy preset. Select values that exercise the breakpoints and layouts your application actually supports, keep them stable between runs, and review the resulting diffs before approving a new baseline.
Configure wider Percy viewports
Percy reads viewport widths from the project-level .percy.yml configuration. The current Percy-hosted guide “Screenshot Testing: Basics For 2026,” published February 23, 2026, demonstrates the version 2 format shown above. The example includes a desktop width of 1280 pixels alongside tablet and mobile widths.
1. Create or locate .percy.yml
Place the file at the configuration level used by your Percy run, normally alongside the project files and the command you execute in CI. If a file already exists, edit it rather than creating a second configuration with competing settings.
The Tool Desk
Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →#1 Best Overall
- 34 inch Curved 1500R UWQHD(3440 x 1440) @ 200Hz Fast VA Ultrawide Gaming Monitor with AI built-in.
- Performance: Up to 200Hz Refresh Rate | OD 1ms Response Time丨 FastVA | AI Blue light reduction | AI Crosshair | AI PQ | Sniper Scope | Support VRR with HDMI2.1
- Ergonomic Stand: Tilt / Kensington Lock: -5°~15°(+/-2°) / Yes丨VESA Compatible (100 x 100mm) | 178° Wide Viewing Angle | PIP/PBP,21:9
- Input &Output: DP 1.4 (Up to 200)|HDMI2.1 X 2 (Up to 200)|Earphone |No speakers
- Warranty: SANSUI 34-inch Curved gaming computer monitor support money-back and free replacement warranty from order date within 30 days and lifetime technical support.
2. Set the configuration version
Use version: 2. The documented width setting belongs under the nested snapshot key:
version: 2
snapshot:
widths: [375, 768, 1280]
min-height: 1024widths is a YAML list of integer pixel values. Add or remove entries to match the responsive states you need to verify. The guide does not establish a maximum width, a maximum number of entries, or Percy’s default widths, so do not treat 1280 as a limit or as a required value.
3. Choose widths from your layout’s breakpoints
Start with widths that represent meaningful design states: a narrow mobile layout, a tablet transition and a wide desktop layout. If your CSS changes at additional breakpoints, include values just below or above those transitions so a visual regression can reveal an unintended rule change. Avoid arbitrary widths that do not correspond to a layout decision; every extra width increases the number of snapshots reviewers must inspect.
| Example width | Typical purpose | What it does not mean |
|---|---|---|
| 375 px | Small mobile state in the documented example | Not a Percy-required mobile default |
| 768 px | Tablet-sized state in the documented example | Not proof of a specific breakpoint in your CSS |
| 1280 px | Wide desktop state in the documented example | Not a documented maximum viewport width |
4. Keep the list stable
Use the same width list for comparable runs. Changing widths at the same time as a UI change makes the review harder because Percy will show both configuration and visual differences. Treat a deliberate width change as a test-coverage change and communicate it with the baseline update.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
Rank #2
- Improved ComfortView Plus: Reduces harmful blue light emissions to ≤35%, for all-day comfort without sacrificing color accuracy.
- Refresh rate: A smooth, tear-free experience with AMD FreeSync Premium (refresh rate up to 120Hz) and an ultra-low 0.03ms response time create a captivating experience for work and play.
- Vivid colors: Enjoy vibrant, true-to-life colors with 99% sRGB and 95% DCI-P3 coverage. The VA panel with 3000:1 contrast ratio and HDR readiness delivers stunning depth, detail and realism.
- Re-engineered sound quality: Enjoy more detailed sound with spacious audio featuring greater output power, deeper frequency response and more decibel range than the previous generation.
- Easy connectivity: Keep your desk organized and clutter-free with a single USB-C cable (up to 65W power delivery).
Run the test through Percy CLI
The configuration is used when the test command is wrapped by Percy CLI. For Cypress, the documented example is:
npx percy exec -- cypress run- Install and authenticate the Percy CLI and the project’s test integration according to your team’s normal setup.
- Confirm that the command is executed from the project context containing the intended
.percy.yml. - Run
npx percy exec -- cypress run(or wrap the equivalent command for your test runner). - Open the resulting Percy build and inspect snapshots at each configured width.
- Approve a new baseline only when every difference is intentional and the wider viewport has not exposed a regression.
Percy CLI wraps the test command so snapshots can be captured and uploaded. The important distinction is that increasing snapshot.widths changes the viewport matrix; it does not require rewriting each test for a separate browser window.
How to decide which widths to add
Map widths to responsive behavior
Inventory the breakpoints in your CSS framework or design system, then select representative widths around each behavior change. For example, if navigation collapses below one breakpoint and a card grid changes at another, choose one width on each side of those transitions. Include the production viewport that has generated past defects, even if it is not a round number.
Cover the widest supported layout
Add the largest viewport your product promises to support. A wider capture can expose fixed-width containers, unexpectedly stretched media, overflow, misplaced sticky elements and desktop-only navigation errors. Do not claim that Percy accepts unlimited width: the cited guide simply does not specify a maximum.
Free tools Windows power users keep installed
One-click scans. No signup required.
Balance coverage and review effort
Each configured value creates another visual state to review. A compact list tied to real breakpoints is usually more useful than a long sequence of nearly identical widths. Expand the list when a defect demonstrates that an existing representative width misses a layout transition.
Rank #3
- 1ms MPRT: Colors fade and illuminate instantly with a 1ms response time, eliminating ghosting and piecing together precise imagery during action-packed scenes and gaming.
- Luminous Backcover Lights: A colorful LED light illuminates the back cover of the monitor, delivering a uniquely modern design.
- WQHD Resolution: At 5 million pixels, Wide Quad HD Resolution (3440 x 1440) display resolution provides you with the next level of refined, and detailed picture over the current 1080P standard.
- 21:9 Ultrawide: See more and do more with an ultrawide monitor. 21:9 provides you with 30% more screen space versus the conventional monitor. With an ultrawide resolution of 3440 x 1440, expand your performance and productivity.
When a new width appears to do nothing
Check the file location
Verify that .percy.yml is in the project context used by the Percy command and that CI has checked it out. A local file in a different directory will not affect a run that starts elsewhere.
Validate YAML structure and indentation
Ensure version is at the top level, snapshot is also top level, and widths is indented beneath snapshot. Use spaces consistently and keep the values as integers:
version: 2
snapshot:
widths:
- 375
- 768
- 1280The inline and multi-line list forms express the same values; the multi-line form can make indentation errors easier to spot.
Confirm Percy CLI is actually wrapping the run
Run the command through Percy CLI rather than invoking the test runner directly. The documented Cypress form is npx percy exec -- cypress run. A direct cypress run does not demonstrate that Percy captured the snapshots.
Rank #4
- DO MORE ON ONE SCREEN: See every detail on the wider display featuring a 21:9 aspect ratio; Ultra WQHD provides the simplest way to maximize screen real estate and experience truly seamless multitasking on just one screen.Brightness (Typical) : 300 cd/㎡. Static Contrast Ratio 3000:1.
- ENJOY A BILLION COLORS W/ INCREDIBLE DEPTH: With HDR10 that displays over 1 billion colors compared to 16.7 million for typical SDR technology, dark colors are darker and the brightest are even brighter; Content is experienced as the creator intended
- CARE FOR YOUR EYES DAY and NIGHT: An ambient light sensor on the monitor detects lighting in your workstation and automatically adjusts brightness; Eye Saver Mode minimizes excessive blue light, and Flicker Free relieves eye strain
- SEE CONTENT SMOOTHER, EVEN GAMING: A faster than average refresh rate updates the image on screen more often every second; 100Hz refresh rate reduces lag and motion blur when playing games, watching videos, or working on design projects
- STAY IN SYNC WITH THE ACTION: AMD Radeon FreeSync keeps the refresh rate of your monitor and graphics card in sync to reduce image tearing for a superfluid entertainment experience; Watch movies and play games without interruptions
Check the uploaded build
Inspect the build’s snapshot list and viewport labels. If the new width is absent, the run may be using a different configuration file or a different branch/job than the one you edited. If it is present but the page looks unchanged, the page may have a fluid layout that legitimately renders similarly at both widths.
Common failure modes and fixes
| Symptom | Likely cause | Action |
|---|---|---|
| Only the old widths appear | Wrong file location, stale checkout or a direct test command | Check the working directory, CI checkout and Percy CLI wrapper. |
| Configuration parsing fails | Invalid YAML or incorrect indentation | Use the version 2 structure and a simple integer list; validate YAML before rerunning. |
| A width is ignored | The value is not under snapshot.widths or is not an integer |
Move it beneath snapshot and remove quotes or non-numeric text. |
| Visual differences multiply unexpectedly | A width was added at the same time as a UI change | Review the new width separately, then approve only intentional differences. |
| The page is blank or incomplete | Application readiness or test-environment issue rather than width syntax | Fix the page-load/test failure first, then rerun the Percy command. |
The cited guide supports the configuration and CLI workflow. It does not state Percy’s default widths, entry limits or plan-specific width restrictions; obtain those details from your current Percy account documentation if they affect your test design.
Reliability and maintenance practices
- Pin the configuration in version control. This keeps local and CI runs aligned and makes viewport changes reviewable.
- Use deterministic test data. A stable width cannot compensate for changing content, animation or timing.
- Keep viewport policy with the design system. Document why each value exists so it is not removed as an apparently redundant number.
- Review baseline changes deliberately. A wider snapshot can reveal a real regression that was invisible at the previous widths.
- Measure review cost. Percy’s guide does not provide a width-based pricing or quota rule, so consult your account terms before adding a very large matrix.
Or skip the browser setup
If your goal is a clean image or PDF of a URL rather than Percy’s test-baseline workflow, ScreenshotNeo provides a single-request capture API and an MCP server for AI agents. It accepts consent banners as a visitor and removes more than 60 known consent platforms, newsletter popups and chat widgets before capture; each cleanup step can be disabled. Bot checks or CAPTCHAs, blank pages, timeouts, failed loads and cache hits are not billed, and the response identifies the result with X-Page-Verdict and X-Billed headers.
Use the complete API reference at https://screenshotneo.com/docs/. Replace the target URL in these runnable examples as needed.
cURL
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpPython
import requests
r = requests.get("https://api.screenshotneo.com/v1/shot", params={"access_key": "YOUR_API_KEY", "url": "https://stripe.com"}, timeout=90)
open("shot.webp", "wb").write(r.content)Node.js
const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://stripe.com' });
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);ScreenshotNeo supports full-page captures with lazy images loaded, CSS-selector element captures, dark mode, 12 device presets plus custom viewports, retina scale, PDF paper and page controls, custom CSS and JavaScript, click-before-capture actions, selector hiding, waits for selectors/delays/network idle, request and resource blocking, custom headers/cookies/user agents/Authorization, timezone and geolocation, transparent backgrounds, resizing, chosen cache TTLs, signed image links, asynchronous jobs with signed webhooks, bulk capture for up to 100 URLs per call, usage and OpenAPI APIs, and compatibility with parameter names used by other screenshot APIs.
Best Value
- Effortless 21:9 Widescreen Workflows - Upgrade your desktop setup with a 34" 21:9 UltraWide Full HD display that lets you see more all at once. Enjoy smooth 100Hz visuals, vibrant HDR color, and a sleek, narrow-bezel design—perfect for multitasking, creativity, and everyday comfort.
- 21:9 Widescreen for Maximum Multitasking Power - The 21:9 UltraWide Full HD (2560 × 1080) IPS display gives you more horizontal space than standard 16:9 monitors, so you can keep multiple windows open on one screen at the same time. A virtually borderless design delivers an uninterrupted view for smoother, more efficient multitasking.
- HDR Brightness and Color that Pops - VESA DisplayHDR 400 enhances brightness, contrast, and detail for more dynamic visuals, while up to sRGB 99% coverage delivers rich, precise color. The IPS panel keeps images sharp and clear from virtually any viewing angle.
- Smooth Connectivity with USB Type-C - Connectivity made easy with USB Type-C, DisplayPort, and HDMI. USB Type-C supports both display output and data transfer, giving you quick, single-cable access to your laptop and reducing desktop clutter.
- Immersive Waves MaxxAudio Sound Built In - Built-in stereo speakers with Waves MaxxAudio deliver rich, immersive sound with crisp highs and deep bass, letting you enjoy games, movies, and music without the need for external speakers.
Plans include 1,000 shots per month free with no card, then Starter at $5 for 3,000, Growth at $15 for 15,000, Pro at $39 for 60,000, Scale at $99 for 250,000 and Business at $249 for 1,000,000. Yearly billing gives two months free, and every feature is available on every plan. The MCP tools are take_screenshot, get_page_info and capture_pdf, so Claude, Cursor and other MCP clients can request captures without custom browser orchestration. Start with 1,000 free screenshots a month and no card.
FAQ
Can I put widths outside snapshot?
The documented version 2 example places them specifically at snapshot.widths. Keep that hierarchy unless current Percy documentation for your integration says otherwise.
Do these 3 things before closing this tab:
1Scan for outdated or missing drivers - takes under a minute2Repair Windows errors before they cause bigger problems3Fix the driver behind crashes, sound loss and screen glitchesDoes adding 1280 px make Percy use a 1280-pixel browser on every test?
It adds 1280 to the configured snapshot viewport set. It does not establish a universal browser, plan or project default.
Where can I find Percy’s maximum width or width-count limit?
Those limits are not stated in the cited guide. Check the current Percy documentation or your account terms before relying on a limit.
Frequently Asked Questions
Should widths remain the same on every branch?
Keep them consistent for comparable visual-regression runs; change them deliberately when you are changing test coverage.
Is min-height required for wider captures?
No. It appears in the guide’s example as an additional snapshot setting, while the width change itself is controlled by snapshot.widths.
Quick wins for a faster PC:
Clear out junk files and repair common Windows errorsFree Scan →Scan for outdated or missing drivers - takes under a minuteDriver Scan →Repair Windows errors before they cause bigger problemsFix Now →Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
