Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Testowanie

verify-responsive

/verify-responsive

Sprawdza responsywny interfejs, renderując prawdziwą stronę w zadanych szerokościach i asercjami z nadrzędnego okna.

Repozytorium
greybeard ↗
Licencja
MIT
Ostatnia zmiana repozytorium
25.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 25.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Sprawdza responsywny interfejs, renderując prawdziwą stronę w zadanych szerokościach i asercjami z nadrzędnego okna.

Oryginalny opis (EN)

The default way to check a responsive UI — render the real page at real viewport widths in fixed-width iframes, then drive and assert it from the parent. Use whenever you need to see or verify a layout at a given width: a mobile or tablet breakpoint, or small-screen-only behavior. Reach for it first, ahead of resizing a window.

Jak działa

  1. Why not just resize the window
  2. Inputs
  3. Procedure
  4. What this does not give you
  5. Related
Sekcje z nagłówków SKILL.md, w oryginale · 71 linii, 678 słów
Podgląd SKILL.md
---
name: verify-responsive
description: The default way to check a responsive UI — render the real page at real viewport widths in fixed-width iframes, then drive and assert it from the parent. Use whenever you need to see or verify a layout at a given width: a mobile or tablet breakpoint, or small-screen-only behavior. Reach for it first, ahead of resizing a window.
---

# Verify Responsive

"The CSS looks right" is not "it renders right at 390px." A media query only proves itself when something evaluates it at that width. This is §4 applied to UI — *define success criteria, loop until verified* — where the criterion is a rendered page at a real width, not a stylesheet that reads correctly.

The tool is one throwaway HTML file: fixed-width `<iframe>`s pointed at your running app. An iframe is a nested browsing context, so **its viewport is the iframe box** — width and height media queries, container queries, and `vw`/`vh` all resolve to the size you set. Two frames side by side puts both breakpoints in a single screenshot.

## Why not just resize the window

Don't — go straight to the harness. Resizing buys exactly one thing, a narrower viewport, which is the same thing the iframe gives you. The iframe then gives you three more:

- **Both breakpoints in one screenshot**, side by side, rather than one width at a time.
- **A frame you can script.** The parent clicks into it, reads state back, and asserts `innerWidth` and `matchMedia(...)` *from inside* the frame. A resized window can only be photographed.
- **No dependency on the resize having worked.** Browser-automation resize calls can quietly fail to change the layout viewport the page actually sees: the screenshot comes back at the old width, the desktop branch renders, and you sign off on a mobile layout you never rendered.

The tool that genuinely beats this harness is **device emulation**, not window resizing — see [what this does not give you](#what-this-does-not-give-you).

## Inputs

- `url` — the running page to check (e.g. `http://localhost:3000/pricing`)
- `widths` — viewports to render; default `390×844` (phone) and `1280×800` (desktop)
- `static-dir` — the directory the dev server serves **at the same origin** (`public/`, `static/`, `www/`)

## Procedure

1. **Start the app** and note its origin.

2. **Put the harness in the app's own `static-dir`** — not on a second server. Same-origin is the entire point: it is what makes step 4 possible. A harness on another port is cross-origin, `iframe.contentDocument` comes back `null`, and you are reduced to screenshots.

3. **Write `_viewports.html`** into that directory:

   ```html
   <!doctype html><meta charset="utf-8"><title>viewports</title>
   <style>
     body { margin:0; display:flex; gap:16px; background:#111; font:12px system-ui }
     figure { margin:0 } figcaption { color:#888; padding:4px }
     iframe { border:0; background:#fff }
   </style>
   <figure><figcaption>390 × 844</figcaption>
     <iframe id="m" src="/YOUR/PATH" width="390" height="844"></iframe></figure>
   <figure><figcaption>1280 × 800</figcaption>
     <iframe id="d" src="/YOUR/PATH" width="1280" height="800"></iframe></figure>
   ```

   Open `/_viewports.html` and screenshot it.

4. **Drive it and assert from the parent.** Same-origin, so the frame is fully scriptable — you can reach past what a screenshot shows:

   ```js
   const w = m.contentWindow, doc = m.contentDocument;
   w.innerWidth;                                 // 390
   w.matchMedia('(max-width: 640px)').matches;   // true → the mobile arm really is live
   doc.querySelector('[data-testid="menu"]').click();
   doc.querySelector('.drawer').className;       // read the result back
   w.localStorage.getItem('seen');               // and any state it wrote
   ```

   Assert the width from *inside* the frame before trusting a screenshot. "Looks narrow to me" is how you verify nothing.

5. **Delete the harness before committing.** Anything in the static dir ships. `rm _viewports.html`, then confirm with `git status` — don't leave it for review to catch.

## What this does not give you

The iframe narrows the **viewport**. It does not emulate a device. Measured inside a 390px frame on a laptop: `pointer: fine` and `hover: hover` are both still true, `navigator.maxTouchPoints` is `0`, and `devicePixelRatio` is the host's.

So a layout that branches on width is covered honestly. One that branches on `@media (hover: hover)`, sniffs the user agent, or swaps assets on DPR will render its **desktop** arm at 390px and mislead you with a screenshot that looks right. There is also no browser chrome, so `100dvh`-vs-`100vh` differences never show up. When the behavior under test depends on any of those, use real device emulation or a real device — this harness will lie to you.

## Related

- [`/visualize`](../visualize/SKILL.md) draws the *structure* of the code. This renders the *running UI*. Use this one when the question is "what does it actually look like at this width."

Wersje

W bazie nie ma innych skilli o nazwie verify-responsive.

Migawka bazy z 13.11.2026 · wersja paczki 968abfd23706 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90responsive-ui-review
    Przegląda interfejs strony lub aplikacji przy różnych szerokościach ekranu i sposobach wprowadzania danych, gdy układ się rozjeżdża.
  • 100responsive-paradigms
    Wyjaśnia, że telefon, tablet i desktop wymagają odrębnych paradygmatów projektowych, i pomaga zdecydować, co pokazuje każdy breakpoint.
  • 90responsive-breakpoints
    Edytuje breakpointy w narzędziu Design w stylu Framera: jedno drzewo DOM na ekran i nadpisania zależne od szerokości.
  • 100audit-responsive
    Audytuje i poprawia układy na każdym breakpointcie, aby wersja desktopowa nie wyglądała jak rozciągnięty telefon: max-width, szerokość 1440 i siatka.
  • 100web-qc
    Sprawdza stronę na żywo w trzech szerokościach ekranu: przyciski, ceny i formularze oraz szuka elementów ucinanych na telefonie.
  • 100test-responsive-design
    Sprawdza responsywność interfejsu w Playwright: testy pasków przewijania, punktów przełamania i układu, aby interfejs działał na różnych urządzeniach.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.