mobile-best-practices

Audit mobile apps against iOS Safari and Android Chrome best practices.

Updated Apr 1, 2026
One-click install
npx skills add https://github.com/thingperson/pileofshame --skill mobile-best-practices
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mobile-best-practices
Source: https://github.com/thingperson/pileofshame/tree/main/.claude/skills/mobile-best-practices
Command: npx skills add https://github.com/thingperson/pileofshame --skill mobile-best-practices

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit the app against mobile best practices for iOS Safari and Android Chrome, reducing UX friction and ensuring consistent behavior across devices.

Core Features & Use Cases

  • Viewport and safe-area verification, 100dvh adoption, and proper safe-area insets handling.
  • Touch-target sizing, accessible interactions, and gesture guidance to improve tappability.
  • PWA readiness checks, offline considerations, and responsive performance improvements.

Quick Start

Run a full mobile best-practices audit on the current app and report viewport, touch-target, PWA, and performance issues.

Frequently Asked Questions about mobile-best-practices

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit my web app for mobile UX best practices?

To audit mobile UX, run a full review covering viewport configuration, touch target sizing, PWA readiness, and performance. This identifies friction points across iOS Safari and Android Chrome, providing clear remediation guidance for issues like 100dvh usage and accessible tap targets.

Why does my layout break on iOS Safari and Android Chrome?

Layout breaks on iOS Safari and Android Chrome often stem from improper viewport meta tags, missing safe-area insets, or incorrect viewport height units. An audit checks 100dvh adoption and safe-area handling to ensure consistent rendering across mobile browsers.

What is the best way to check PWA readiness and offline resiliency?

The best way to check PWA readiness is auditing offline considerations and service worker behavior. This validates offline resiliency, theme-color consistency, and responsive performance to guarantee the app functions reliably without a network connection.

How do I fix touch targets that are too small for mobile accessibility?

Fix small touch targets by auditing accessible interactions and applying tappability guidance. The audit enforces proper sizing for tap targets, ensuring they meet mobile accessibility standards and reducing user frustration with missed taps.

Can I validate a specific mobile-affecting code change without auditing the whole app?

Yes, you can validate specific mobile-affecting changes during polish sprints. The audit targets individual modifications to verify they maintain viewport compliance, text legibility, and form UX standards without requiring a full application review.

Does my web app need proper meta viewport and theme-color tags for mobile?

Yes, proper meta viewport and theme-color tags are required for mobile consistency. The audit enforces meta viewport correctness and theme-color consistency to prevent rendering issues and ensure the UI matches the system environment.