Skip to content

Layout breaks on mobile: header text overlaps and panels overflow at 375px #5

Closed

Description

@GeoBradDev

Severity: High

The app is not usable on phones. No CSS media queries exist anywhere in src/index.css, and every panel uses fixed widths and absolute positions sized for desktop.

Evidence

Measured in Chromium with a 375x812 mobile viewport (DPR 2, touch) against the production build:

  • Header: all three sections overlap. The title spans x=31 to 344 px. Over it sit the badge (18 to 113), the coordinates (56 to 185), and the UTC clock (215 to 357). None of the text is readable. See .app-header / .app-title (https://github.com/GeoBradDev/WebGPU-Example/blob/1f58d46/src/index.css#L74-L128), where the title is 17px with 0.35em letter-spacing and nowrap.
  • GPU info panel: spans x=-305 to 365, so most of it is off screen to the left (https://github.com/GeoBradDev/WebGPU-Example/blob/1f58d46/src/index.css#L495-L509).
  • Layer panel: a fixed 196px wide (#L218-L227), covering more than half the map width. The stress count label is clipped ("0 P"). That also happens at 1440px wide.
  • Feature popup: a fixed 288px wide, anchored bottom-left. At 500px wide it covers the GPU panel and the attribution.
  • html, body { overflow: hidden } means clipped content cannot be scrolled into view.

Steps to reproduce

  1. Open the app in Chrome DevTools device mode at 375x812.
  2. Look at the header, the bottom GPU panel, and the layer panel.

Recommended fix

  • Add responsive breakpoints, for example at 640px and 1024px.
  • Header: hide or stack the coordinates and clock, and shrink the title's letter-spacing and font size.
  • Make the layer panel a collapsible drawer or bottom sheet on small screens.
  • Let the GPU panel wrap or collapse to key stats, and constrain it with max-width: calc(100vw - 32px).
  • Make the popup full-width (bottom sheet) on narrow screens, and do not let it overlap other panels.
  • Give .stress-count enough width for "5.0M PTS".

Acceptance criteria

  • At 375px, 768px, and 1440px wide, no text overlaps and no panel extends past the viewport.
  • The map stays at least 60% visible at 375px with panels collapsed.
  • Every control can be reached by touch at 375px.

Effort: M

Activity

  1. GeoBradDev commented on Nov 7, 2026

    @GeoBradDev
    OwnerAuthor

    Additional evidence from the #4 work (PR #16): the stress count readout ("0 PTS") is clipped at the panel's right edge at every viewport width, not just on mobile. Cause: .stress-slider keeps Chrome's default width of about 129px, so 129 + 8px gap + the 56px min-width of .stress-count is more than the roughly 172px of usable width inside the 196px panel (src/index.css, .stress-row / .stress-count). Fix in this issue: give the slider flex: 1; min-width: 0 (or an explicit width) so the readout fits "5.0M PTS". This is covered by the existing acceptance criterion that no text overflows at 375, 768, and 1440px.

  2. added a commit that references this issue on Nov 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    severity:highHigh severity findinguxUser experience

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions