Skip to content
Back to search

nativetap

MarketplaceWorks with Claude CodeGitHub

Mobile design intelligence for AI coding agents: 461 HIG/Material 3/Flutter/SwiftUI/Compose rules your agent searches before writing any phone screen UI.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/awaisdev5765--nativetap/badge.svg)](/listings/awaisdev5765--nativetap)

HTML

<a href="/listings/awaisdev5765--nativetap"><img src="/api/listings/awaisdev5765--nativetap/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Claude Code / Antigravity / Kiro** (plugin manifest included):

git clone https://github.com/awaisdev5765/nativetap.git ~/.claude/skills/nativetap

Or into a single project:

git clone https://github.com/awaisdev5765/nativetap.git .claude/skills/nativetap

**Cursor / Codex / Windsurf:** copy `SKILL.md` + `data/` + `scripts/` + `references/` into your agent's rules directory — the format is the cross-agent SKILL.md standard. Cursor users: the repo ships a [`.cursorrules`](.cursorrules) too — just clone and open the folder.

**Any MCP client** (Claude Desktop, Claude Code, Cursor, Codex, …):

{
  "mcpServers": {
    "nativetap": {
      "command": "python3",
      "args": ["/absolute/path/to/nativetap/mcp/server.py"]
    }
  }
}

Exposes `search_mobile_rules`, `list_domains`, and `thumb_rules` tools — see [`mcp/README.md`](mcp/README.md). Zero dependencies.

**Verify it works:**

python3 .claude/skills/nativetap/scripts/search.py "touch target" --max-results 1

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 13 lines
  1. {
  2. "name": "nativetap",
  3. "owner": {
  4. "name": "awaisdev5765"
  5. },
  6. "plugins": [
  7. {
  8. "name": "nativetap",
  9. "source": "./",
  10. "description": "Mobile UI/UX design intelligence: HIG, Material 3, Flutter/SwiftUI/Kotlin patterns, gestures, safe areas, dark mode, motion, store assets."
  11. }
  12. ]
  13. }
README.md · README · 240 lines
  1. # 📱 nativetap
  2. **Mobile UI/UX design intelligence for AI coding agents.**
  3. Your AI writes great web UI. On phone screens it guesses — buttons in
  4. thumb-unreachable corners, lists that jank, back gestures that break, dark
  5. mode that fails contrast. nativetap is the fix: **461 curated mobile design
  6. rules your agent searches before writing any UI.**
  7. [![Claude Code](https://img.shields.io/badge/Claude_Code-skill-8b5cf6)](https://claude.com/claude-code)
  8. [![MCP](https://img.shields.io/badge/MCP-server-3b82f6)](mcp/README.md)
  9. [![CI](https://github.com/awaisdev5765/nativetap/actions/workflows/ci.yml/badge.svg)](https://github.com/awaisdev5765/nativetap/actions/workflows/ci.yml)
  10. [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
  11. [![v1.0.0](https://img.shields.io/badge/version-1.0.0-blue)](https://github.com/awaisdev5765/nativetap/releases)
  12. Works with **Claude Code, Cursor, Codex, Windsurf, Antigravity, Kiro, Copilot**
  13. — any agent that reads SKILL.md files, plus any MCP client.
  14. ![nativetap — the mobile design rulebook for AI coding agents](assets/hero.png)
  15. ```bash
  16. # What your agent knows after install:
  17. $ python3 search.py "keyboard covers field"
  18. → the exact fix in Flutter, SwiftUI, AND Android — with typical sizes
  19. ```
  20. ![nativetap search in the terminal](assets/search.png)
  21. ## Why nativetap
  22. Existing design skills are web-first. The biggest one (150k+ ⭐) covers 22
  23. stacks — but mobile is one row in its data, and its flagship content is
  24. Tailwind, React, and landing pages. Meanwhile:
  25. - **2M+ Flutter developers** get shallow coverage
  26. - iOS HIG and Material 3 are *platform contracts*, not style suggestions
  27. - Mobile has hard constraints web doesn't: 44pt touch targets, thumb zones,
  28. safe areas, gesture conflicts, haptics semantics
  29. - Store rejection is a real tax (icon sizes, data-safety forms)
  30. nativetap is **exclusively about what users touch with their thumbs** — and
  31. it's the design stage of a complete shipping pipeline:
  32. ```
  33. nativetap (design) → prism_doctor (code audit) → shipcheck (launch audit)
  34. ```
  35. ## Install
  36. **Claude Code / Antigravity / Kiro** (plugin manifest included):
  37. ```bash
  38. git clone https://github.com/awaisdev5765/nativetap.git ~/.claude/skills/nativetap
  39. ```
  40. Or into a single project:
  41. ```bash
  42. git clone https://github.com/awaisdev5765/nativetap.git .claude/skills/nativetap
  43. ```
  44. **Cursor / Codex / Windsurf:** copy `SKILL.md` + `data/` + `scripts/` +
  45. `references/` into your agent's rules directory — the format is the
  46. cross-agent SKILL.md standard. Cursor users: the repo ships a
  47. [`.cursorrules`](.cursorrules) too — just clone and open the folder.
  48. **Any MCP client** (Claude Desktop, Claude Code, Cursor, Codex, …):
  49. ```json
  50. {
  51. "mcpServers": {
  52. "nativetap": {
  53. "command": "python3",
  54. "args": ["/absolute/path/to/nativetap/mcp/server.py"]
  55. }
  56. }
  57. }
  58. ```
  59. Exposes `search_mobile_rules`, `list_domains`, and `thumb_rules` tools —
  60. see [`mcp/README.md`](mcp/README.md). Zero dependencies.
  61. **Verify it works:**
  62. ```bash
  63. python3 .claude/skills/nativetap/scripts/search.py "touch target" --max-results 1
  64. ```
  65. ## Usage
  66. Once installed, your agent picks it up automatically when you design or
  67. review mobile UI. You can also drive the search directly:
  68. ```bash
  69. # Search everything:
  70. python3 .claude/skills/nativetap/scripts/search.py "touch target"
  71. # Search one domain:
  72. python3 .claude/skills/nativetap/scripts/search.py "list performance" --domain flutter
  73. python3 .claude/skills/nativetap/scripts/search.py "dark mode" --domain color
  74. # Restrict to your stack (routes to the ~26 domains that matter):
  75. python3 .claude/skills/nativetap/scripts/search.py "swipe" --stack flutter
  76. python3 .claude/skills/nativetap/scripts/search.py "tab bar" --stack swiftui
  77. # What data exists / how many rows:
  78. python3 .claude/skills/nativetap/scripts/search.py --list-domains
  79. python3 .claude/skills/nativetap/scripts/search.py --stats
  80. ```
  81. In conversation, just ask your agent:
  82. > "Is this list implementation going to jank?" → searches `flutter` domain
  83. > "What's the iOS convention for destructive swipe actions?" → searches `hig-ios`
  84. > "Make my dark mode correct" → searches `color`, checks the 40 rules P0
  85. ## What's inside
  86. | Data domain | Contents |
  87. |---|---|
  88. | **The 40 Thumb Rules** | Priority P0–P5, each with the exact numbers |
  89. | `flutter` | 16 wrong→right patterns: lists, images, forms, state, navigation |
  90. | `swiftui` | 10 patterns: NavigationStack, ownership, insets, accessibility |
  91. | `kotlin` | 10 patterns: Compose perf, ViewModel, predictive back |
  92. | `hig-ios` | Apple component specs: nav bars, sheets, alerts, swipe actions |
  93. | `material3` | M3 specs: FABs, nav bar, chips, tonal elevation |
  94. | `gestures` | Convention per gesture + haptics pairing + common mistakes |
  95. | `safe-areas` | Notch/Island/home-indicator/keyboard in all 3 frameworks |
  96. | `typography` | Mobile type scale with pt/sp + Flutter tokens |
  97. | `color` | Dark mode rules, dynamic color, contrast, semantic tokens |
  98. | `motion` | Transition specs with exact durations per platform |
  99. | `icons` | Every icon size: iOS/Android/watch/store |
  100. | `styles` | 49 mobile visual styles with when-to-use/avoid |
  101. | `a11y` | Screen reader, focus order, 200% type, color-blind safety |
  102. | `performance` | Cold start, jank, image decode, memory, battery — with numbers |
  103. | `forms` | Keyboard types, autofill, OTP, validation timing |
  104. | `components` | Measurable specs: bar heights, row heights, FAB, sheets |
  105. | `notifications` | Permission timing, channels, deep links, badges |
  106. | `tablet-foldable` | Two-pane 600dp+, hinge, stylus, shortcuts |
  107. | `store` | Screenshot strategy, keywords, feature graphic, A/B tests |
  108. | `navigation` | 10 IA patterns with tradeoffs |
  109. | `offline` | Cache-first UI, retry backoff, optimistic updates |
  110. | `onboarding` | Time-to-value, progressive disclosure, retention hooks |
  111. | `monetization` | Paywall timing, trials, restore, compliant CTAs |
  112. | `widgets-watch` | Home widgets, WidgetKit budgets, watch complications |
  113. | `animations` | Springs, easing, stagger, shared elements |
  114. | `images` | Formats, sizing, blurhash, video, camera |
  115. | `security` | Biometrics, keychain, SSL pinning, FLAG_SECURE |
  116. | `deep-links` | Universal/App Links, deferred links |
  117. | `push` | Token rotation, foreground behavior, throttling |
  118. | `i18n` | RTL, plurals, text expansion, Arabic digits |
  119. | `testing` | Golden tests, a11y audits, device matrix |
  120. | `release` | Staged rollout, crash-free gates, hotfix lanes |
  121. | `camera` | Permissions, warm-up, barcode scanning |
  122. | `maps` | Battery discipline, clustering, camera handoff |
  123. | `audio-haptics` | Haptic vocabulary, silent mode, audio focus |
  124. | `compose3` | Modern Jetpack Compose: typed nav, stable state, previews |
  125. | `visionos` | Spatial UI: gaze+pinch, comfort, ornaments |
  126. | `iap` | StoreKit 2, pending transactions, refunds, restore |
  127. | `errors` | Human error copy, retries, inline form errors |
  128. | `app-clips` | App Clips / Instant Apps patterns |
  129. | `voiceover` | 12 screen-reader recipes |
  130. | `charts` | fl_chart / Swift Charts / Vico, zero-axis rule |
  131. Zero dependencies. Pure CSV + a search script. Works offline.
  132. ## The 40 Thumb Rules (sneak peek)
  133. | Priority | Rule | Numbers |
  134. |---|---|---|
  135. | **P0** | Touch targets | ≥ 44×44pt iOS / 48×48dp Android |
  136. | **P0** | Contrast | ≥ 4.5:1 body — check BOTH light and dark mode |
  137. | **P0** | Dynamic Type | Layout must survive 200% text scale |
  138. | **P1** | Tap feedback | Visible response ≤ 100ms |
  139. | **P1** | Keyboard | Pushes content, never covers the focused field |
  140. | **P1** | Long-press | Reveals, never deletes |
  141. | **P2** | Navigation matches platform | iOS tabs+back-swipe / Android top bar+system back |
  142. | **P2** | Haptics | Mark state changes, never decorate |
  143. | **P3** | Form labels | Above fields, always visible |
  144. | **P5** | Cold start | ≤ 2s to first meaningful paint |
  145. All 40 with rationale in
  146. [`references/thumb-rules.md`](.claude/skills/nativetap/references/thumb-rules.md).
  147. ## Data freshness
  148. Fair question: *do the CSVs go stale when HIG or Material 3 update?*
  149. Every source is fingerprinted and version-stamped:
  150. - [`data/VERSION.json`](.claude/skills/nativetap/data/VERSION.json) — last
  151. reviewed date + which upstream docs each domain was verified against
  152. - A monthly CI workflow re-hashes the Apple HIG and Material 3 pages; when
  153. they change, a review issue opens automatically
  154. - Updates land as auditable diffs — every rule stays traceable to its source
  155. ## FAQ
  156. **Are iOS and Android conventions kept apart, or averaged?**
  157. Kept apart. Every cross-platform domain has per-platform columns (iOS /
  158. Android / Flutter / SwiftUI / Compose), so the agent gets the exact HIG or
  159. Material spec — not a mushy middle. Where platforms genuinely agree, the row
  160. is shared; where they differ (back gesture, nav patterns), each keeps its
  161. own rule.
  162. **Does this replace a designer?**
  163. No — it stops the AI from breaking the platform's hard rules (thumb reach,
  164. contrast, safe areas, gesture conflicts). The taste is still yours.
  165. **Why CSVs and not a bigger format?**
  166. Plain data + a 150-line dependency-free search script = works offline, in
  167. any agent, forever. No SDK, no lock-in, no breakage.
  168. ## The pipeline
  169. nativetap is one third of a full "vibe coder ships a real app" toolkit:
  170. | Stage | Tool | What it checks |
  171. |---|---|---|
  172. | **Design** | **nativetap** (this skill) | HIG/M3 correctness, thumb ergonomics, platform patterns |
  173. | Code | [prism_doctor](https://pub.dev/packages/prism_doctor) | Hardcoded colors, magic numbers, deprecated imports |
  174. | Launch | [shipcheck](https://pub.dev/packages/shipcheck) | Store listings, privacy, screenshots, release notes |
  175. ## A worked example
  176. [`example/checkout_screen/`](example/checkout_screen/) shows a Flutter
  177. checkout screen written **without** nativetap (web instincts: top-right
  178. submit, 32pt targets, fixed heights) and the **same screen with it** — every
  179. fix cited to the exact row that drove it.
  180. ## Contributing
  181. The data files are the product — PRs adding rows to the CSVs (with correct,
  182. verified platform data) are very welcome. Each row is small and sourced, so
  183. a PR per HIG/Material release is cheap and reviewable. Search script is
  184. dependency-free Python 3.
  185. ## License
  186. MIT — see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.