Pageres is a screenshot capture tool that programmatically renders websites at multiple resolutions to verify responsive design.
The tool solves the problem of manually testing website appearance across different screen sizes by automating bulk screenshot generation. It uses Puppeteer to render pages in a headless browser, capturing the visual output at specified viewport dimensions. The approach is fast enough to generate many screenshots in parallel, making it practical for testing suites that need to verify layouts across numerous resolution combinations.
Pageres is best suited for developers building responsive websites who want to automate visual regression testing or documentation. It works as a Node.js library that you integrate into scripts or build pipelines, rather than as a standalone command-line tool. The tool supports fine-grained control over what gets captured: you can target specific DOM elements with CSS selectors, hide elements, inject custom CSS or JavaScript, set cookies for authenticated pages, and apply transformations like cropping and scaling. It handles both PNG and JPEG output formats and can emulate dark mode preferences. For developers who prefer a command-line interface, a separate CLI package is available.
The project maintains a steady stream of updates addressing edge cases and adding refinements to screenshot capture behavior. Issues receive responses that engage with reported problems and explore potential solutions. Pull requests are reviewed and merged regularly, indicating active maintenance of the codebase. The project has accumulated substantial community usage and feedback over time, which shapes ongoing development priorities.
