responsively-app README

The project's README from github.com/responsively-org/responsively-app. As one markdown file: README.md.

Responsively Logo

Responsively App GitHub release

A must-have dev tool for web developers for quicker responsive web development. 🚀
Save time by becoming 5x faster!

Twitter contributors Discord XS:Code PRs Welcome Open Collective backers and sponsors

ProductHunt

Download Now (free!): responsively.app


Responsively App

A modified browser built using Electron that helps in responsive web development.

Quick Demo

Features

  1. Mirrored User-interactions across all devices.
  2. Customizable preview layout to suit all your needs.
  3. One handy elements inspector for all devices in preview.
  4. 30+ built-in device profiles with the option to add custom devices.
  5. One-click screenshots on all your devices.
  6. Hot reloading is supported for developers.

Please visit the website to learn more about the application - https://responsively.app

Download

The application is available for Mac, Windows and Linux platforms. Please download it from responsively.app

Alternatively, MacOS users can use brew Homebrew installs

brew install --cask responsively

Also, Windows users can use chocolatey Chocolatey installs

choco install responsively

or winget:

winget install ResponsivelyApp

Linux users using an RPM Package Manager can use rpm

sudo rpm -i https://github.com/responsively-org/responsively-app/releases/download/v[VERSION]/Responsively-App-[VERSION].x86_64.rpm

otherwise, download an AppImage from the releases page

Follow us on Twitter for future updates - Twitter Follow

Browser Extension

Install the handy browser extension to easily send links from your browser to the app and preview instantly.

MCP Server (AI coding agents)

Responsively App ships a built-in Model Context Protocol server, so AI coding agents like Claude Code and Cursor can drive the app while you build — load your dev server, switch device previews, interact with pages, and visually verify responsive layouts with per-device screenshots.

Install the app, launch it once, then connect from Claude Code:

claude mcp add responsively -- npx -y @responsively/mcp

Or add to Cursor's .cursor/mcp.json:

{
  "mcpServers": {
    "responsively": {"command": "npx", "args": ["-y", "@responsively/mcp"]}
  }
}

The app is launched on demand — connecting an agent session doesn't open it; the first tool call starts it automatically (and it stays open afterwards). If it's already running, it's reused.

Available tools:

Tool Description
get_app_state Current URL, page title, layout, zoom and active devices
navigate Load a URL in all device previews (waits for the page to load)
list_devices Full device catalog, including custom devices
set_active_devices Change which devices are previewed, by id or name
screenshot Capture one or all device previews as JPEG images
read_page Read a preview's page text and interactive elements with CSS selectors
click Click an element (trusted mouse event; mirrors across previews)
type_text Type into a form field with real keystrokes, optionally press Enter

Screenshots capture the visible viewport and are downscaled to at most 1000px wide.

Advanced configuration

The app's MCP server listens on http://127.0.0.1:12720/mcp (localhost only) whenever the app is running. If your MCP client can't run npx, connect to it directly — but you'll need to have the app running yourself:

claude mcp add --transport http responsively http://127.0.0.1:12720/mcp

Environment variables understood by @responsively/mcp:

Variable Purpose
RESPONSIVELY_APP_PATH Path to a custom app install (auto-detected otherwise)
RESPONSIVELY_MCP_PORT Port of the app's MCP server (default 12720)
RESPONSIVELY_MCP_BRIDGE Direct path to a bridge cli.js (development override)

Linux note: the app ships as an AppImage, so launch it once before first agent use — that's how the CLI learns where it lives.

Issues

If you face any problems while using the application, please open an issue here - https://github.com/responsively-org/responsively-app/issues

Roadmap

Here is the roadmap of the desktop app - https://github.com/responsively-org/responsively-app/projects/

Gold sponsors 🥇

Fun88 Sponsor to add your company logo here

Become a sponsor and have your company logo here

Contribute

To get started with contributing your awesome ideas to Responsively, follow the comprehensive guide here!

Get in touch

Come say hi to us on Discord! :wave:

Contributors ✨

Thanks go to these wonderful people (emoji key):

Manoj Vivek
Manoj Vivek

💻 ⚠️ 📆
Suresh P
Suresh P

💻 ⚠️ 📆
Sigit Prabowo
Sigit Prabowo

💻
Leon Feng
Leon Feng

📖
Kishore S
Kishore S

💻
José Javier Rodríguez Zas
José Javier Rodríguez Zas

💻 ⚠️
Roman Akash
Roman Akash

💻
Romain Francony
Romain Francony

💻
AARYAN-MAHENDRA
AARYAN-MAHENDRA

💻
Andy
Andy

💻
Ryan Pais
Ryan Pais

💻 ⚠️
Jonathan
Jonathan

💻
Gema Anggada ✌︎
Gema Anggada ✌︎

💻
jonathanurias96
jonathanurias96

💻
Federico Alecci
Federico Alecci

💻
Abduraimov Muminjon
Abduraimov Muminjon

📖
Víctor Lázaro
Víctor Lázaro

💻
Kavita Nambissan
Kavita Nambissan

💻
Prashant Palikhe
Prashant Palikhe

💻
Jaune Sarmiento
Jaune Sarmiento

🖋
Diego Vieira
Diego Vieira

💻
Ajaykumar
Ajaykumar

💻
Kiruba Karan
Kiruba Karan

💻
Sebastián Rodríguez
Sebastián Rodríguez

💻
Karthick Raja
Karthick Raja

💻

responsively-app (responsively-org/responsively-app)

Searching Database…

What is this?A modified web browser built with Electron for responsive web development: you preview your site on many devices at once and interact with all of them in sync. It is pitched as a must-have dev tool for web developers.
How is it different from just resizing a normal browser or using dev tools?It is a standalone desktop app that shows all your devices side by side: scrolling, clicking and typing are mirrored across every device, and a single elements inspector works for all of them. The preview layout is customizable.
Do I need Node or any other tooling installed to use it?No — it is a self-contained desktop application, so installing it is enough. You just open your local dev server URL in it like in a normal browser.
Any platform quirks I should know about?On Linux the app ships as an AppImage, and you should launch it once before using it with an agent — that is how the CLI learns where it lives. The app's MCP server also only listens on localhost.
Can I take screenshots of all devices at once?Yes — one-click screenshots capture every device in the preview simultaneously.
Does it hot reload my code changes?Yes, hot reloading is supported, so your edits show up across all device previews without manual refreshes.
Can I test on devices that are not in the built-in list?You get 30+ built-in device profiles, and there is an option to add custom devices of your own.
Why use this instead of regular dev tools?To save time on responsive work: the README claims you become 5x faster by previewing and interacting with all your devices in one place instead of checking each one separately.
Size
101 MB
Stars
25.3K
Age
7y
Commits · 90 Days