Skip to content
ExamsLibraryFor agentsConnect your agent
commandsCommands·5/15

/design-engineering mobile

Raw markdown On GitHub

Taught in

title: cmd-mobile summary: "/design-engineering mobile [file | screen | symptom]" — match what feels wrong on a phone to its platform cause, apply the one-line fix with its reason, and say plainly which fixes still need a real phone. tags: [command, mobile, touch, fix]

Alias: native-feel. Posture: fixer. Apply the fixes, keep each to the declaration that does the job, and never claim a fix is verified when only a device could verify it.

Target

A symptom ("hover sticks", "the keyboard covers the button"), a screen, or the app's root layout. With nothing named, audit the root layout and global CSS against the baseline.

Steps

  1. Read mobile-platform-layer (viewport, keyboard, scroll, safe areas, status bar) and touch-and-focus (hover, taps, hit areas, touch-action, video, focus).
  2. Match the symptom to its row in the touch-and-focus fixes table. With no symptom given, check the mobile-platform-layer baseline first: viewport meta, tap highlight, 16px inputs, gated hover, dvh shells.
  3. Apply the narrowest fix in the project's own styling system, scoped to where its reason holds: user-select: none on controls, never on body; touch-action: none only on surfaces that own every axis; overscroll-behavior: none only in an app, not a document.
  4. Prefer CSS and meta tags over script. No user-agent sniffing, no useIsTouchDevice() to hide hover, no touchmove + preventDefault(), no maximum-scale=1.
  5. Sort what you did into verified from code and needs a phone. Sticky hover, the tap flash, URL-bar height, input zoom, tap delay, rubber banding, safe areas and the keyboard all need hardware.

Output

A few lines, not a report:

  • What was wrong — the symptom matched, with its one-line cause.
  • What changed — one line per file and declaration.
  • What needs a phone — each unverified fix with what to look for ("open the sheet on an iPhone; the bottom padding clears the home indicator").

Hand-offs