Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mobile-hig-audit

AI skill for auditing mobile apps against Apple Human Interface Guidelines and Android Material Design 3, with a focus on minimizing App Store and Google Play rejection risk.

Updated for 2026 — iOS 26 SDK requirement, Android API 35 mandate, Apple's new age rating system (4+/9+/13+/16+/18+), and Google Play CSAE policy.


What it does

  • Audits UI, code, navigation flows, and interaction patterns against platform guidelines
  • Flags policy violations that cause store rejection
  • Scans codebases statically for common compliance issues
  • Generates structured audit reports with severity ratings and action plans
  • Covers iOS (Apple HIG), Android (Material Design 3), and cross-platform consistency

File structure

mobile-hig-audit/
├── SKILL.md                      # Main skill — audit workflow and scoring
├── README.md                     # This file
├── references/
│   ├── ios-hig.md                # Apple HIG: navigation, touch targets, typography,
│   │                             #   components, Dark Mode, accessibility, IAP, privacy
│   ├── android-guidelines.md     # Material Design 3: back gesture, edge-to-edge,
│   │                             #   type scale, components, window size classes, billing
│   └── store-policies.md         # App Store + Google Play submission checklists,
│                                 #   prohibited content, UGC, monetization, sensitive categories
├── scripts/
│   └── scan.py                   # Static code scanner (Python, no dependencies)
└── templates/
    └── audit-report.md           # Audit report template with severity levels and scoring

Static scanner

Scans a project directory and reports compliance issues without running the app.

Requirements: Python 3.10+, no external dependencies.

# Scan both platforms (default)
python scripts/scan.py --path ./my-app

# Scan iOS only
python scripts/scan.py --path ./my-app --platform ios

# Scan Android only
python scripts/scan.py --path ./my-app --platform android

# Save findings as JSON
python scripts/scan.py --path ./my-app --platform both --output findings.json

Supported project types: React Native, Swift/SwiftUI, Kotlin/Jetpack Compose, generic JS/TS.

Checks (16 total)

Check Platform Severity
Hardcoded color values (should be semantic tokens) Both 🟡 Important
Interactive elements missing accessibility labels Both 🟡 Important
Font sizes in dp/px instead of sp Android 🟡 Important
Touch targets below 44pt (iOS) / 48dp (Android) Both 🟡 Important
PrivacyInfo.xcprivacy (Privacy Manifest) missing iOS 🔴 Critical
NSUsageDescription strings empty or too vague iOS 🔴 Critical
Deprecated onBackPressed() usage Android 🔴 Critical
Edge-to-edge not implemented in Activity Android 🟡 Important
Hardcoded strings in Android XML layouts Android 🟢 Improvement
ImageView/ImageButton missing contentDescription Android 🟡 Important
targetSdkVersion below 35 (Android 15) Android 🔴 Critical
Deprecated NavigationView (should be NavigationStack) iOS 🟡 Important
.ignoresSafeArea() on interactive content iOS 🟡 Important
IAP code present but no Restore Purchases call iOS 🔴 Critical
No privacy policy reference in codebase Both 🟡 Important
Authentication flow but no account deletion iOS 🔴 Critical

Audit report

Copy templates/audit-report.md and fill it in during or after the audit. It includes:

  • Per-category score (0–10, target 10/10)
  • Findings table by severity (🔴 Critical / 🟡 Important / 🟢 Improvement)
  • Pre-submission checklists for App Store and Google Play
  • Cross-platform comparison table
  • Sensitive category notes (children, health, finance, AI generative)
  • Action plan with priority and effort columns

Coverage

iOS (Apple HIG)

Navigation patterns · Safe areas & layout regions · Touch targets (44pt) · SF Pro + Dynamic Type · SF Symbols · Dark Mode (semantic colors) · VoiceOver + Assistive Access · Permissions + Privacy Manifest · StoreKit IAP · iOS 26 SDK requirement · App icon variants (iOS 18+)

Android (Material Design 3)

Bottom Navigation · Predictive Back gesture (Android 15) · Edge-to-edge layout · Material Type Scale · M3 components · Window Size Classes (tablets/foldables) · Dynamic Color · TalkBack · Data Safety Form · Google Play Billing 7.0+ · API level 35 requirement

Store Policies

App Store + Google Play submission checklists · Prohibited content · UGC requirements (CSAE policy Jan 2026) · Monetization rules · Metadata requirements · Sensitive categories: children, health, finance, GovTech, AI generative


Sources

About

AI skill for auditing mobile apps against Apple Human Interface Guidelines and Android Material Design 3, with a focus on minimizing App Store and Google Play rejection risk.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages