---
name: viewports
description: Renders a page at every width, each breakpoint edge, a short landscape phone, 400% zoom, 200% text and spaced, longer, shorter, unbroken or mirrored text, then reports what overflows, clips or hides.
title: viewports
canonical_url: https://skilld.dev/gh/raphaelsalaja/skills/viewports
last_updated: 2026-11-22T01:08:19.000Z
---

> Index of every page on this site: [llms.txt](https://skilld.dev/llms.txt)

> **Skill from skilld.dev.** Follow the user's requested action.
> If the user asked to fork this Skill, follow the fork workflow below. Do not execute the Skill instructions while copying it.
> Otherwise, follow the instructions below for this session. You do not need to install anything.
>
> Supporting files, fetch one when the Skill refers to it: [agents/openai.yaml](https://skilld.dev/api/skills-raw/raphaelsalaja/skills/viewports/agents/openai.yaml), [overflow.js](https://skilld.dev/api/skills-raw/raphaelsalaja/skills/viewports/overflow.js), [stretch.js](https://skilld.dev/api/skills-raw/raphaelsalaja/skills/viewports/stretch.js).
>
> If the user asked to install this Skill, run `npx skilld install raphaelsalaja/skills/viewports`. Install writes the Skill files into the project, so every session loads them.
>
> ## Fork workflow
>
> A fork creates an editable local Skill with its original author and licence. The request authorizes copying and local installation.
> 1. Check `./skills/viewports`, the project lockfile, and selected Agent targets together. If the local directory or installed Skill exists, stop. Never overwrite an existing directory or Agent target.
> 2. Read [source metadata](https://skilld.dev/api/v1/skills/raphaelsalaja/skills/viewports) once. Use sourceUrl, sourceCommit, skillPath, sourceGone, and license. If the source is gone or its path is missing, stop. If license is null, read licence files at the source commit.
> 3. Fetch only the source commit into a temporary Git repository. Do not clone full history. Derive repository_url from sourceUrl, including repository renames. If sourceCommit is absent, resolve the sourceUrl ref once. Set source_commit to that actual commit. Run these commands in one shell call:
>
> ```sh
> git init --quiet "$temporary_dir"
> git -C "$temporary_dir" fetch --quiet --depth=1 "$repository_url" "$source_commit"
> git -C "$temporary_dir" checkout --quiet --detach FETCH_HEAD
> ```
>
> Read applicable licence declarations and notices at that commit. If copying is not permitted, report the restriction and stop.
> 4. Inspect source entries together, then copy the directory containing skillPath into `./skills/viewports`. Use the user's path if selected. Keep the original SKILL.md, relative links, scripts, binary assets, and executable modes. Exclude .git metadata. Reject symlinks and paths outside the Skill directory. After checking entries, use cp -a where available. A regular source directory needs no custom copy script. Do not save this page wrapper as SKILL.md.
> Preserve author credit, notices, and applicable licence files from repository or parent directories. Add PROVENANCE.md with the Skill page, source URL, actual commit, original path, and licence. Retain any existing PROVENANCE.md and record new provenance separately. Batch source inspection, copying, and provenance work where practical.
> 5. In the project root, run `skilld install ./skills/viewports --mode copy --plain`. If skilld is unavailable, use `npx skilld install ./skills/viewports --mode copy --plain`. This known command needs no help lookup. Install does not support --json. Use detected Agent targets, or add --agent for the targets the user selected. Install the local path, never the upstream selector. If installation fails, preserve the local copy and report the exact failure.
> 6. Confirm the local lockfile source and installed Agent copies once. Report the local path, actual commit, and Agent targets. After edits, reinstall the same local path. Upstream updates must not replace it. Do not publish or push unless the user asks.

# Viewports

This skill renders one page at a fixed set of widths and heights. It measures each render for sideways scroll, clipped text, small targets and controls that only hover reveals.

## Every width rendered, none inferred

The widths are exact: 320, 375, 768, 1024, 1440 and 2560, plus each project breakpoint and the width 1px below it. The short sizes are exact too: 812×375 for a phone held sideways and 320×256 for 400% zoom. A width reasoned from the media queries is a finding. Run it after any layout change and whenever the user names a phone or a width.

Opening the result belongs to `verify`. Alignment inside one render belongs to `alignment`. Safe areas, hit areas and dynamic viewport units belong to `defaults`, and a failure there cites its id.

## 1. Read the breakpoints

Read the breakpoints from the CSS, the Tailwind config or the tokens. Add each one and the width 1px below it to the fixed widths. A sweep that skips the edges of a breakpoint is `viewports-cross-each-breakpoint`.

Run [overflow.js](https://skilld.dev/api/skills-raw/raphaelsalaja/skills/viewports/overflow.js) once through the browser's evaluate call. Its `breakpoints` field reads every width query in the loaded stylesheets. It lists `widths`, the `edges` to render and the `gaps`. Queries set only from JavaScript, such as `matchMedia`, never show there.

Each entry in `gaps` is a `max-width` up to 1px below another query's `min-width`. A `max-width: 767px` beside a `min-width: 768px` leaves 767.5px matching neither, and browser zoom or fractional display scaling lands there. That gap is `viewports-no-breakpoint-gap`. Write the pair in range syntax, `(width < 768px)` and `(width >= 768px)`.

## 2. Render each width

Set the viewport through device emulation at each width. Use 320×568, 375×812, 768×1024, 1024×768, 1440×900 and 2560×1440. Breakpoint edges render 800px tall. Emulate touch at every width under 1024. Take a full-page screenshot of each. A layout judged from the code is `viewports-render-every-width`.

At 375×812, set the safe-area insets through `Emulation.setSafeAreaInsetsOverride` to 59px top and 34px bottom. At 812×375 they are 59px left and right and 21px bottom. Clear them with empty insets before the other widths. A bar or button drawn under an inset cites `defaults-safe-areas`.

At 2560 the content sits centred in its column or uses the width on purpose. A 1200px column pinned left with 1360px of blank space beside it is `viewports-widest-width`.

A component that ships inside a narrower container also renders at that container's width. Render it inside its real parent, or set its wrapper to that width. A list checked at 1440 that ships in a 280px sidebar is `viewports-container-width`.

## 3. Measure each render

Run [overflow.js](https://skilld.dev/api/skills-raw/raphaelsalaja/skills/viewports/overflow.js) through the browser's evaluate call at each width. Treat each result as a candidate until a crop of that width shows it.

The page never scrolls sideways, though a box may scroll inside itself. A 40px sideways scroll at 320 is `viewports-no-sideways-scroll`.

At 1440, set `window.__viewportsOptions = { scrollbar: true }` and run the script again. It draws the classic 15px scrollbar that macOS and touch emulation hide, and its `scrollbar` field reads 15 when that took effect. Delete `window.__viewportsOptions` afterwards, or every later run draws it too. A `width: 100vw` band 15px wider than the page is `viewports-classic-scrollbar`. Search the CSS for `100vw` and use `width: 100%`. A centred column that jumps 15px between a short page and a long one cites `defaults-scrollbar-gutter`.

Text is never cut by its box without an ellipsis or a clamp. A button label cut in half at 375 is `viewports-no-clipped-text`. A target under 24px cites `defaults-hit-area`.

## 4. Tap at touch widths

Tap through the page with touch emulated. Row actions, copy buttons and menus that appear on hover need another way to appear. A delete button that shows only on row hover is `viewports-no-hover-only-controls`.

## 5. Shorten the height

Render 812×375, a phone held sideways. The page works in both orientations and never asks to be turned. A "Rotate your device" overlay at 812×375 is `viewports-both-orientations`.

Open each dialog, sheet and menu at that size. Content scrolls inside the overlay and its actions stay reachable. A dialog whose `Save` sits below the screen with no scroll is `viewports-short-heights`.

Search the CSS for `100vh` and `h-screen`. A match on an app shell or a full-height panel cites `defaults-dynamic-viewport`.

## 6. Zoom to 400%

Render 320×256 at a device scale factor of 4, which is a 1280×1024 window zoomed to 400%. Run [overflow.js](https://skilld.dev/api/skills-raw/raphaelsalaja/skills/viewports/overflow.js) again. Text reflows with no sideways scroll.

Under 480px of height, fixed and sticky bars together cover at most a quarter of the screen, 64px at 256. Bars that need more stop sticking there. A 56px sticky header above a 56px fixed tab bar, covering 112px of 256, is `viewports-unstick-when-short`.

## 7. Double the text

At 1024 wide, set the root font size to 200% and render again. Text wraps and its boxes grow, with nothing overlapping. Labels overlapping their icons at 200% is `viewports-text-zoom`. A root font size in `px` that stops the text growing cites `defaults-rem-sizes`.

## 8. Widen the spacing

At 375 and 1024, run [stretch.js](https://skilld.dev/api/skills-raw/raphaelsalaja/skills/viewports/stretch.js) through the browser's evaluate call, then call `window.__stretch.run("spacing")`. Line height becomes 1.5 times the font size and paragraph spacing 2 times. Letter spacing becomes 0.12em and word spacing 0.16em. Nothing clips or overlaps. A tag with `height: 32px` cutting its label is `viewports-text-spacing`.

## 9. Lengthen and shorten the text

At 375 and 1440, run [stretch.js](https://skilld.dev/api/skills-raw/raphaelsalaja/skills/viewports/stretch.js). It doubles labels under 11 characters and lengthens longer text by 40–60%, as translation does. Labels wrap or truncate with a way back. A tab label pushing its neighbour off the bar is `viewports-longer-text`.

Then call `window.__stretch.run("unbreakable")` for values with no spaces. It puts in `bartholomew.fitzgerald@northwind-industries-holdings.example.com`, `IMG_20250914_183022_HDR_portrait_edited_edited.HEIC`, `Benachrichtigungseinstellungen`, a UUID and a long URL with a query string. Each wraps with `overflow-wrap: anywhere` or truncates in the middle. An email running out of its card is `viewports-unbreakable-text`.

Then call `window.__stretch.run("short")` for the shortest values: `J`, `Jo` and `a@b.test`. A layout built for long values still looks complete. A name link only as wide as `J`, or a card that looks broken around `Jo`, is `viewports-shorter-text`.

## 10. Change the script and the direction

At 375 and 1440, call `window.__stretch.run("scripts")`. It puts in Vietnamese `Đặng Thị Ngọc Hân`, Thai `สมศักดิ์ ใจดี` and Arabic `نور الهدى عبد الرحمن`. Marks above and below the letters show whole. A tight `line-height` with `overflow: hidden` cutting the marks off `Đặng` is `viewports-tall-scripts`.

When the project ships a right-to-left locale, set `dir="rtl"` on the root and render both widths again. The layout mirrors. Padding stuck on one side because of `margin-left` is `viewports-mirror-rtl`.

In the mirrored render, icons that point a direction flip: arrows, chevrons, back, forward, send and undo. Clocks, checkmarks, the search magnifier and media play controls stay as drawn. A back chevron still pointing left under `dir="rtl"` is `viewports-flip-directional-icons`. Fix it with `:dir(rtl) .icon-directional { transform: scaleX(-1) }` or the mirrored glyph.

Text the user wrote takes `dir="auto"`, so `نور الهدى عبد الرحمن` inside a left-to-right page keeps its punctuation and icons on the right. In a right-to-left interface, a paragraph of three or more lines aligns to its own language, and digits never reverse. A name whose full stop jumps to its wrong end is `viewports-dir-auto`.

## 11. Report by width

Return one screenshot per width with the overlay numbers, then the findings in the same order. A finding with no width named is `viewports-name-the-width`.

## The pair

Every check is a pair. The broken line sits beside the line that replaces it.

| Rule | Broken | Replacement |
| --- | --- | --- |
| `viewports-cross-each-breakpoint` | Checked at 375 and 1440 only | Also at 767 and 768, 1023 and 1024 |
| `viewports-no-breakpoint-gap` | `max-width: 767px` beside `min-width: 768px`, nothing matching at 767.5px | `(width < 768px)` beside `(width >= 768px)` |
| `viewports-render-every-width` | "The grid collapses at `md`, so mobile is fine" | Screenshots at 320, 375 and 768 |
| `viewports-widest-width` | A 1200px column pinned left at 2560 | `margin-inline: auto` on the column |
| `viewports-container-width` | A list checked at 1440 that ships in a 280px sidebar | The list rendered inside a 280px wrapper |
| `viewports-no-sideways-scroll` | A `width: 400px` card at 320 | `max-width: 100%` on the card |
| `viewports-classic-scrollbar` | `width: 100vw` on a band, 15px wider than the page beside a classic scrollbar | `width: 100%` on the band |
| `viewports-no-clipped-text` | `overflow: hidden` cutting a label at 375 | The label wraps, or truncates with a way back |
| `viewports-no-hover-only-controls` | Row actions behind `:hover` alone | Shown at all times under `(hover: none)` |
| `viewports-both-orientations` | A "Rotate your device" overlay at 812×375 | The layout reflowing to 812×375 |
| `viewports-short-heights` | A dialog's `Save` below a 375px screen | `max-height: 100dvh` with the body scrolling |
| `viewports-unstick-when-short` | A sticky header and a fixed tab bar covering 112px of a 256px screen | `@media (min-height: 480px) { .header { position: sticky } }`, the bars static below it |
| `viewports-text-zoom` | `height: 32px` on a button that clips at 200% | `min-height: 2rem` with padding |
| `viewports-text-spacing` | `height: 32px` on a tag that clips at wider spacing | `min-height: 32px` with `padding-block: 4px` |
| `viewports-longer-text` | `width: 96px` on a tab whose label doubles | `min-width: 96px` with the label free to grow |
| `viewports-unbreakable-text` | An email running out of its card | `overflow-wrap: anywhere` on the email |
| `viewports-shorter-text` | A name link only as wide as `J` | `min-width: 24px` on the link |
| `viewports-tall-scripts` | `line-height: 1` with `overflow: hidden` cutting the marks off `Đặng` | `line-height: 1.5` on the line |
| `viewports-mirror-rtl` | `margin-left: 12px` on a row's icon | `margin-inline-start: 12px` |
| `viewports-flip-directional-icons` | A back chevron pointing left under `dir="rtl"`, or a clock flipped with it | `:dir(rtl) .icon-directional { transform: scaleX(-1) }` on arrows and chevrons only |
| `viewports-dir-auto` | `<span>{name}</span>` holding `نور الهدى عبد الرحمن` | `<span dir="auto">{name}</span>` |
| `viewports-name-the-width` | "The header overlaps" | "At 768, the header overlaps the search field" |

## Reporting

**Severity.** `HIGH` is sideways page scroll, including the scroll a classic scrollbar exposes. It is also a control that hover alone reveals on touch, an action unreachable at a short height or a page locked to one orientation. `MEDIUM` is clipped text, overlap at 200% text or a break at a breakpoint edge. It is also a layout judged from the code or a sweep that skips a breakpoint edge. It is also a width no query matches, or bars that cover more than a quarter of a short screen. It is also a layout that breaks under longer text or fails to mirror. It is also a directional icon pointing the wrong way once mirrored, or a non-directional one flipped. It is also text cut by wider spacing, a value with no spaces escaping its box, marks cut off a tall script or user text in the wrong direction. It is also a component never rendered at its container width or content stranded at 2560. `LOW` is a finding that does not name its width, or a layout that looks broken with the shortest values.

**Format.** One finding per root cause, naming the width:

```
1. file:line - [rule-id] at 375, what is wrong (measured values)
```

Cite the script's element when the source line is not found. Then a `Rule | Count | Severity` summary. `Block` when any `HIGH` remains, `Approve` otherwise. Mark any width you could not render as `Not verified`.
