[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M757STJN18SAQPSM47PHTZBK":3,"skill-same:01M757STJN18SAQPSM47PHTZBK":55},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":31,"commitSha":32,"skillDirectory":33,"forksCount":34,"repositoryHtmlUrl":35,"repositoryHomepageUrl":36,"ownerHtmlUrl":37,"ownerBlogUrl":38,"ownerDescription":39,"updatedAt":40,"install":41,"resources":54},"01M757STJN18SAQPSM47PHTZBK","platform-conventions",null,"Reference guide to native UI conventions across iOS (Apple HIG), Android (Material 3), macOS, Windows 11 Fluent, and web — with concrete numbers, comparison tables, and when to adapt vs. when to ship a custom cross-platform brand system.","jpoindexter\u002FVanta","jpoindexter","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F2729617?v=4","01M72VRRYY1CP7RPF3B7GHH0CR","01M757GWDBT6RD147ZZ79N4MEX",4,"MIT","https:\u002F\u002Fgithub.com\u002Fjpoindexter\u002FVanta\u002Fblob\u002Fmain\u002Fdesign-system-skills\u002Fplatform-conventions\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: platform-conventions\ndescription: Reference guide to native UI conventions across iOS (Apple HIG), Android (Material 3), macOS, Windows 11 Fluent, and web — with concrete numbers, comparison tables, and when to adapt vs. when to ship a custom cross-platform brand system.\ntags: [design-systems, platforms, ios, android, desktop, hig, material]\n---\n# Platform Conventions — iOS, Android, macOS, Windows, Web\n\nA platform convention is a contract the OS already taught the user. SF Symbols, the back-swipe, the FAB, the menu bar — these are muscle memory, not decoration. When you honor them your app feels native and invisible; when you fight them you spend the user's attention re-teaching things they already know. This skill is the cross-platform bible: what each platform expects, the exact numbers, and the trade-off of when to break with convention on purpose.\n\nThe recurring decision in every section below is the same: **inherit the platform's pattern (cheaper, familiar, accessible-by-default) or impose your own (coherent, branded, but you pay to re-teach and re-implement).** Read each platform's section as the catalog of what you get for free if you conform, so you know exactly what you're spending when you don't.\n\n## Why respect conventions — and when not to\n\n**Respect them when:** the value is in the content\u002Ftask, not the chrome (productivity, utility, system-adjacent apps); you want App Store \u002F Play Store reviewer goodwill; your users span ability levels (native controls inherit accessibility for free); you're a small team that can't afford to re-solve solved problems.\n\n**Use a custom cross-platform brand system when:** the brand *is* the product (games, creative tools, immersive media, strongly-branded consumer apps like Spotify\u002FNotion\u002FLinear); a consistent identity across platforms outweighs per-platform familiarity; you control onboarding enough to teach novel patterns. Spotify, Discord, and Figma deliberately look identical everywhere — that consistency is the point.\n\n**The trade-off, stated plainly:** Native = lower learning cost, free accessibility, store goodwill, but per-platform engineering and a fragmented brand. Custom = one design language and brand coherence, but you re-implement accessibility, you fight platform reflexes (back gesture, share sheet), and stores scrutinize you harder. The mature answer is almost always *hybrid*: a shared brand token layer (color, type scale, spacing, motion personality) with **platform-native navigation, controls, and gestures**. Never ship an iOS app that looks Android, or vice versa — that's the one thing users universally read as \"cheap port.\"\n\n**Store reality:** Apple's App Store Review Guidelines reject apps that feel like a \"repackaged website\" or ignore platform paradigms (§4.0 Design); Apple expects you to use system controls, the native share sheet, and standard navigation. Google Play is more permissive on UI but still rejects on broken back behavior, deceptive patterns, and accessibility failures. Conforming isn't only good UX — it materially lowers rejection risk and speeds review.\n\n---\n\n## iOS — Apple Human Interface Guidelines (iOS 17 \u002F 18)\n\n**Type:** SF Pro (SF Pro Text \u003C 20pt, SF Pro Display ≥ 20pt; New York is the serif). **Dynamic Type is mandatory** — use the 11 text styles (LargeTitle 34, Title1 28, Title2 22, Title3 20, Headline 17 semibold, Body 17, Callout 16, Subhead 15, Footnote 13, Caption1 12, Caption2 11). Never hardcode point sizes for body content; users set their own scale (xSmall→AX5), and respecting it is an accessibility requirement, not an option.\n\n**Touch & grid:** Minimum tap target **44×44 pt** (HIG hard floor). Layout on an **8 pt grid** (4 pt for fine tuning). Standard screen margin 16–20 pt. Points are density-independent; the system rasterizes @1x\u002F@2x\u002F@3x.\n\n**Navigation:**\n- **Navigation bar** (top): back chevron + title, large titles collapse to inline on scroll. Back is always **top-left** + an **edge-swipe-from-left** gesture — never remove either.\n- **Tab bar** (bottom): 2–5 destinations, flat top-level sections, persistent. iOS 18 adds a floating\u002Fmorphing tab bar and (iPad) a tab bar that converts to a sidebar.\n- **Sheets \u002F modals:** prefer **sheets** (slide up, support detents — `.medium`\u002F`.large`, drag-to-dismiss grabber) over full-screen modals. Use full-screen cover only for self-contained tasks. Action sheets for destructive choices anchored to context.\n\n**System feel:**\n- **Safe areas** (notch \u002F Dynamic Island \u002F home indicator): pin to `safeAreaInsets`, never the raw screen rect.\n- **Haptics** via `UIFeedbackGenerator` (selection \u002F impact \u002F notification): expected on toggles, pickers, and success\u002Ferror moments.\n- **Materials & blur:** `.ultraThinMaterial`→`.thickMaterial` vibrancy for bars, popovers, sidebars — don't fake translucency with a flat alpha fill.\n- **Light\u002Fdark:** semantic colors (`.label`, `.systemBackground`, `.separator`), never hardcoded hex.\n- **Accessibility:** respect Reduce Motion and Increase Contrast; ship VoiceOver labels.\n\n**Standard components — reach for these first:** `UIDatePicker` (wheel\u002Fcompact\u002Finline), segmented control, stepper, switch (green capsule), context menus (long-press), swipe actions on rows, and the **system share sheet** (`UIActivityViewController`) — never roll your own share UI.\n\n**iPadOS** is its own interaction model, not a big iPhone:\n- **Three-column split view** (`UISplitViewController`: sidebar \u002F supplementary \u002F secondary) collapses to a stack on iPhone-width.\n- **Popovers anchored to their source** for transient content — not full-height sheets.\n- **Pointer \u002F trackpad** support: the cursor morphs into controls, hover effects, and precise hit-testing — design hover states.\n- **Hardware keyboard:** key-command HUD on ⌘-hold; support standard shortcuts.\n- **Multitasking:** Split View, Slide Over, Stage Manager — your layout must survive arbitrary window sizes via regular\u002Fcompact **size classes**.\n- First-class **drag-and-drop** between apps.\n\n**visionOS basics:** content lives on glass material in 3D space; default window 1280×720 pt at 1m; targets ≥60 pt for eye+pinch; hover highlight is system-driven; put tab bars\u002Ftoolbars in **ornaments** rather than screen-edge chrome.\n\n**iOS do \u002F don't:**\n- **Do** put the most important destination switching in a bottom tab bar; keep it 2–5 items, persistent, flat.\n- **Do** use large titles that collapse on scroll for top-level screens; inline titles for pushed detail screens.\n- **Do** preserve the left-edge back-swipe — if you build a custom transition, keep the interactive pop gesture alive.\n- **Don't** add a hamburger drawer, a FAB, or a bottom snackbar — those are Android signatures and read as foreign.\n- **Don't** put primary actions at the bottom-center as a floating circle; put them top-right in the nav bar or in a toolbar.\n- **Don't** hardcode `17pt`; use the Body text style so Dynamic Type and accessibility sizes flow through.\n\n---\n\n## Android — Material Design 3 (Material You)\n\n**Type:** Roboto (or Roboto Flex) is the default; brand fonts allowed. Type scale tokens: Display L\u002FM\u002FS, Headline L\u002FM\u002FS, Title L\u002FM\u002FS, Body L\u002FM\u002FS (Body Large 16sp), Label L\u002FM\u002FS. **Units are `sp` for text** (scales with user font setting) and **`dp` for everything else.** Using `dp` for text is a bug — it ignores accessibility font scaling.\n\n**Dynamic color (Material You):** M3's signature — the system extracts a tonal palette from the user's **wallpaper** and exposes it via color-role tokens (`primary`, `onPrimary`, `primaryContainer`, `surface`, `surfaceContainerHighest`, `outline`…). Design against **roles**, not raw hex, so your app re-themes itself per device. Provide a static brand fallback for when dynamic color is off.\n\n**Touch & grid:** Minimum target **48×48 dp** (8 dp larger than iOS). **8 dp grid**, **4 dp** for fine spacing\u002Ficon padding. Default screen margins 16 dp.\n\n**Navigation:**\n- **Top app bar** (small \u002F center-aligned \u002F medium \u002F large) — title + nav icon (hamburger or up-arrow) + actions, scrolls with `surfaceContainer` color shift.\n- **Navigation bar** (bottom): 3–5 destinations, pill-shaped active indicator behind the icon.\n- **Navigation rail** (≥600 dp width) and **navigation drawer** (modal or standard) for larger screens \u002F many destinations. The hamburger drawer is *acceptable* on Android in a way it is not on iOS.\n- **FAB:** the single most-important screen action, bottom-right; sizes small\u002Fstandard(56 dp)\u002Flarge\u002Fextended. Distinctly Android — there is no FAB on iOS.\n\n**Surfaces & state:**\n- **Tonal elevation:** M3 expresses height primarily as a lighter, primary-tinted surface color (`surfaceContainerLow`→`surfaceContainerHighest`) rather than only a shadow.\n- **State layers:** hover\u002Ffocus\u002Fpressed\u002Fdragged add a translucent `onSurface` overlay (8% \u002F 10% \u002F 10% \u002F 16%).\n- **Ripple** radiates from the touch point on every pressable — its absence makes the UI feel dead.\n- **Bottom sheets** (modal\u002Fstandard) and **snackbars** (transient, bottom, one optional action — *not* a dialog) are the Android counterparts to iOS sheets\u002Falerts.\n- **Adaptive layouts** by window size class (Compact \u003C600 \u002F Medium 600–840 \u002F Expanded ≥840 dp) drive list ↔ list-detail panes.\n\n**Motion durations (M3 tokens):** short 50–200 ms (state changes, small components) · medium 250–400 ms (most container transitions) · long 450–600 ms (large\u002Ffull-screen) · extra-long 700–1000 ms (hero moments). Easing is **emphasized** (`emphasizedDecelerate`\u002F`emphasizedAccelerate`, ~`cubic-bezier(0.05,0.7,0.1,1)`) with container-transform and shared-axis transitions. For contrast: iOS motion is **spring-based** (no fixed duration ramp, ~0.3–0.5 s defaults, mass\u002Fstiffness\u002Fdamping); Fluent sits ~150–300 ms.\n\n**Android do \u002F don't:**\n- **Do** rely on the **system back** (gesture or button) — you rarely need a per-screen back affordance; up-arrow only for hierarchical \"up,\" which is not the same as back.\n- **Do** design against **color roles** and ship a dynamic-color theme + a static brand fallback.\n- **Do** use a FAB for the one defining action, a snackbar for transient feedback, and a bottom sheet for contextual options.\n- **Do** add ripple + state layers to every pressable; their absence makes the app feel dead\u002Fun-Android.\n- **Don't** copy iOS's green capsule switch, wheel date picker, or top-left chevron back — use Material's switch, calendar\u002Fdial pickers, and system back.\n- **Don't** size text in `dp` — it silently ignores the user's font-scale setting.\n\n---\n\n## iOS vs. Android — the head-to-head\n\n| Dimension | iOS (HIG) | Android (Material 3) |\n|---|---|---|\n| Primary navigation | **Tab bar** (bottom, 2–5) | **Navigation bar** (bottom, 3–5) \u002F rail \u002F drawer |\n| \"Back\" | Top-left chevron **+ edge-swipe** | System back (gesture \u002F button); no per-screen back needed |\n| Hamburger menu | Avoid — un-iOS | Acceptable (navigation drawer) |\n| Primary screen action | Top-right bar button | **FAB** (bottom-right) |\n| Modal pattern | **Sheet** with detents, drag-to-dismiss | **Bottom sheet** \u002F full-screen dialog |\n| Alert \u002F transient msg | Alert + **action sheet** | **Dialog** + **snackbar** |\n| Type unit | **pt** (Dynamic Type styles) | **sp** (text) \u002F **dp** (layout) |\n| Min touch target | **44 pt** | **48 dp** |\n| Grid | 8 pt (4 fine) | 8 dp (4 fine) |\n| Icon style | **SF Symbols** — thin, rounded, optically sized | **Material Symbols** — geometric, fill\u002Fweight\u002Fgrade axes |\n| Switch | Green capsule, no label inside | Track + thumb with checkmark, role-colored |\n| Date picker | Wheel \u002F compact \u002F inline calendar | Calendar dialog \u002F docked \u002F dial time picker |\n| Share | **System share sheet** (`UIActivityViewController`) | **Android Sharesheet** (`ACTION_SEND`) |\n| Settings | Inside the app (Settings.app for system perms) | In-app + system Settings deep links |\n| Color theming | Semantic system colors, vibrancy | **Dynamic color** from wallpaper (tonal roles) |\n| Elevation | Materials \u002F blur layering | **Tonal** elevation + shadow + state layers |\n\n**Cardinal sins:** an iOS-looking app on Android (and vice versa) reads as a low-effort port. The most damaging are: a top-left back button on Android (use system back), a FAB on iOS, a hamburger drawer on iOS, hardcoded font sizes that ignore Dynamic Type \u002F `sp`, custom non-native date pickers, and a bespoke share screen instead of the OS share sheet.\n\n---\n\n## macOS (Sonoma \u002F Sequoia)\n\n**Density is the headline difference from iOS** — pointer precision means smaller, denser controls (min ~28 pt clickable, not 44), tighter rows, more affordances visible at once. **Don't ship an iPad app stretched to a window.**\n\n- **Menu bar** (global, top of screen): the canonical home for *every* command — App \u002F File \u002F Edit \u002F View \u002F Window \u002F Help plus app menus. If a command isn't in a menu, it's not discoverable and not keyboard-reachable. Mirror toolbar actions here.\n- **Toolbar:** customizable, lives in the window title bar (unified in modern macOS); icon + optional label buttons for frequent actions.\n- **Sidebar:** primary navigation (source list) with translucency\u002F**vibrancy**; collapsible; sections + disclosure groups.\n- **Window chrome:** traffic-light controls top-left, resizable, full-screen and Stage Manager aware. Support **multiple windows** and tabs; state restoration on relaunch.\n- **Pointer affordances:** **hover** states, **right-click \u002F Control-click context menus** everywhere, cursor changes (resize, text I-beam, link pointer). These don't exist on touch — design them in, not as an afterthought.\n- **Keyboard:** full shortcut coverage with standard bindings (⌘C\u002FV\u002FZ, ⌘W close, ⌘, Preferences, ⌘N new). Tab moves focus; everything operable without a mouse.\n\n**macOS do \u002F don't:**\n- **Do** put every command in the menu bar (even ones also in a toolbar) so it's keyboard-reachable and discoverable.\n- **Do** support multiple resizable windows + tabs and restore window state on relaunch.\n- **Do** design hover, right-click, and cursor-change states — pointer affordances are first-class here.\n- **Don't** ship a touch-density iPad layout with 44 pt targets stretched across a window.\n- **Don't** hide commands only behind toolbar icons or omit standard ⌘-shortcuts; Mac users navigate by keyboard and menu.\n\n---\n\n## Windows 11 — Fluent Design (WinUI 3 \u002F WinAppSDK)\n\n- **Type:** **Segoe UI Variable** (Display\u002FText\u002FSmall optical sizes); type ramp Caption 12 → Body 14 → Subtitle 20 → Title 28 → Display 68.\n- **Materials:** **Mica** (opaque, wallpaper-tinted, for the base window background) and **Acrylic** (translucent, blurred, for transient\u002Flayered surfaces — flyouts, command bars). Mica is the modern default for app backgrounds.\n- **Shape:** rounded corners — **8 px** on windows\u002Fcards\u002Fflyouts, **4 px** on small controls. A flat square-cornered window reads as legacy Win32.\n- **Navigation:** **NavigationView** — left pane that auto-adapts (expanded ↔ compact rail ↔ overflow) by width; **breadcrumb bar** for hierarchy; **TabView** for documents.\n- **Commands:** **CommandBar** (primary actions + overflow `…`), context menus, and the right-click menu.\n- **Theme:** full light\u002Fdark + the system-wide **accent color** the user picks — tint with it.\n- **Density:** a Compact spacing variant exists for data-dense apps.\n- **Input:** must work for **mouse, touch, pen, and gamepad** — ~40×40 px touch targets, hover\u002Ffocus visuals for mouse and pen.\n\n**Windows do \u002F don't:** **Do** use Mica for the window base, Acrylic for flyouts\u002Fmenus, rounded corners, and the system accent color. **Don't** ship flat square-cornered surfaces with hard shadows (reads as legacy Win32), and don't assume mouse-only — Surface devices are touch + pen.\n\n---\n\n## Web — borrow patterns, respect the wrapper\n\nThe web has **no single OS convention** — so you inherit the *browser's* contract (back\u002Fforward, the URL, Ctrl\u002F⌘+F, zoom, reader mode, text selection) and the **WCAG** baseline, then layer your own design language. Don't break browser back, don't hijack scroll, keep links as links.\n\n**The wrapper rule:** the moment your web UI is packaged, the host platform's conventions reassert themselves:\n- **Electron \u002F Tauri (desktop):** honor the menu bar (macOS global menu vs. Windows in-window menu), native window controls, OS keyboard shortcuts, light\u002Fdark, and platform-correct titlebar. A web app in a window that ignores ⌘-shortcuts feels broken.\n- **PWA \u002F mobile web:** respect safe-area insets (`env(safe-area-inset-*)`), `theme-color`, the install\u002Fstandalone display mode, and touch target sizes (≥44 px). On iOS Safari, account for the dynamic toolbar (`100dvh` not `100vh`).\n- **Responsive:** users expect fluid reflow across breakpoints (mobile \u002F tablet \u002F desktop), no horizontal scroll, and touch-friendly hit areas on small screens. This is itself a convention — violate it and the site feels broken.\n\n---\n\n## Cross-platform strategy\n\n**Keep consistent (the brand layer):** design tokens (color roles, type scale ratios, spacing scale, radius, motion personality), content\u002Fvoice, information architecture, iconography family, illustration. These travel.\n\n**Adapt per platform (the experience layer):** navigation structure (tab bar vs. nav bar vs. menu bar), control appearance (switches, pickers, buttons), gestures (back-swipe, long-press vs. right-click), typography *units* (pt\u002Fsp\u002Fdp\u002Fpx) and the system font, share\u002Fprint\u002Fsettings hooks, density, and the elevation\u002Fmaterial model. These must be native.\n\n**Worked example — one \"compose new message\" feature, five platforms.** Same brand color, type ramp, and copy throughout; the *behavior* is native each time:\n- **iOS:** a top-right \"compose\" bar button (or a prominent toolbar button) opens a **sheet** with detents; recipients use the native contact picker; send confirmation is a subtle haptic.\n- **Android:** a **FAB** (bottom-right) opens a full-screen compose; a **snackbar** confirms \"Message sent\" with an Undo; back is the system gesture.\n- **macOS:** **⌘N** and a `File ▸ New Message` menu item open a **new window**; the toolbar holds Send; right-click a recipient for actions.\n- **Windows:** a **CommandBar** \"New\" button opens a compose pane in an Acrylic flyout; Send is a primary command; Ctrl+N works too.\n- **Web:** a button opens a modal\u002Froute; the browser back button closes it; ⌘\u002FCtrl+Enter sends.\nOne feature, one brand — five correct platform expressions. That is the whole strategy in miniature.\n\n**Framework caveats:**\n- **React Native \u002F Flutter:** ship one codebase but you must still branch behavior — RN's `Platform.select`, Flutter's Cupertino vs. Material widget sets. \"Write once, run anywhere\" with one UI = uncanny on at least one platform. Budget for platform-specific navigation and controls.\n- **Compose Multiplatform:** Material-first; you own re-creating an iOS look if you want native feel there — it won't be automatic.\n- **Catalyst \u002F SwiftUI multiplatform:** closer to free adaptation, but density and pointer affordances on Mac still need explicit attention.\n- **Ionic \u002F Capacitor (web in a native shell):** you get one web UI everywhere — acceptable for content\u002Futility apps, but you must still respect safe areas, hardware back on Android, and the system share sheet, or it feels like a website in a frame.\n\n---\n\n## Accessibility per platform\n\nNative controls inherit most of this for free — another reason to conform. If you build custom, you re-implement all of it.\n\n| Platform | Screen reader | Text scaling | Other expected |\n|---|---|---|---|\n| iOS \u002F iPadOS | **VoiceOver** | **Dynamic Type** (text styles) | Reduce Motion, Increase Contrast, Bold Text, Switch Control, Voice Control; min contrast WCAG AA |\n| Android | **TalkBack** | system **font scale** (use `sp`) | Switch Access, color-inversion, large-touch, content descriptions on every control |\n| macOS | **VoiceOver** | system text size, hover text | **Full Keyboard Access**, Increase Contrast, Reduce Motion, focus rings |\n| Windows 11 | **Narrator** | system text scaling | High Contrast themes, keyboard nav, focus visuals, UI Automation patterns |\n| Web | platform SR (VoiceOver \u002F NVDA \u002F Narrator) | browser zoom + rem\u002F`em` | **WCAG 2.2 AA**, semantic HTML, ARIA only when HTML can't, visible focus, reduced-motion query |\n\n**The throughline:** every platform exposes a user-chosen text scale and a screen reader. Hardcoded sizes and unlabeled custom controls break both — the single most common accessibility regression across all five.\n\n## Icons & assets per platform\n\n| Platform | App icon | In-UI icons | Notes |\n|---|---|---|---|\n| iOS \u002F iPadOS | **1024×1024** single master (Xcode generates the rest); rounded-rect mask applied by OS — supply a **square**, no pre-rounded corners | **SF Symbols** (vector, weight + scale matched to text) | Don't bake the corner radius; provide light\u002Fdark\u002Ftinted variants (iOS 18) |\n| Android | **Adaptive icon**: 108×108 dp = 72 dp safe zone, separate **foreground + background** layers (system masks to circle\u002Fsquircle\u002Fetc.); Play Store **512×512** | **Material Symbols** (fill\u002Fweight\u002Fgrade\u002Foptical-size axes) | Never a single flat PNG — adaptive layers or it clips wrong |\n| macOS | **1024×1024**, rounded-square with subtle depth (squircle), supply full `.icns` set | SF Symbols + custom template images | More skeuomorphic depth than iOS flat |\n| Windows 11 | App icon at multiple sizes (16→256 px) + tile\u002FStore assets; rounded modern style | **Fluent \u002F Segoe Fluent Icons** | Provide unplated + plated variants |\n| Web \u002F PWA | `favicon` set + **512×512** + **maskable** icon (safe zone for masking) + apple-touch-icon 180×180 | SVG sprite or icon font | Maskable icon prevents Android cropping |\n\n---\n\n## Common mistakes (quick scan)\n\n- iOS-style UI on Android or Android-style on iOS — instant \"cheap port.\"\n- Custom navigation that breaks the **system back** (Android) or **edge-swipe back** (iOS).\n- Ignoring **safe areas** \u002F notch \u002F home indicator \u002F dynamic toolbar.\n- Hardcoded font sizes that ignore **Dynamic Type (iOS)** or **`sp` (Android)**.\n- A **hamburger menu on iOS**, or a **FAB on iOS** — both are Android idioms.\n- Rolling your own **share sheet, date picker, or alert** instead of the system component.\n- Hardcoded colors instead of **semantic \u002F role tokens** → broken dark mode and no dynamic color.\n- macOS app that's just a stretched iPad layout — no menu bar, no right-click, no density.\n- Square-cornered, shadow-only, non-Mica Windows app that looks like Win32.\n- Touch targets under 44 pt \u002F 48 dp; no hover\u002Ffocus states on pointer platforms.\n- Faking blur with flat alpha instead of real **materials\u002Fvibrancy\u002FAcrylic**.\n- Breaking browser **back\u002Fforward**, scroll, or text selection on the web.\n\n**The one rule:** ship the brand once, ship the *behavior* native. Tokens are shared; navigation, controls, and gestures belong to the platform.\n","# Platform Conventions — iOS, Android, macOS, Windows, Web\n\nA platform convention is a contract the OS already taught the user. SF Symbols, the back-swipe, the FAB, the menu bar — these are muscle memory, not decoration. When you honor them your app feels native and invisible; when you fight them you spend the user's attention re-teaching things they already know. This skill is the cross-platform bible: what each platform expects, the exact numbers, and the trade-off of when to break with convention on purpose.\n\nThe recurring decision in every section below is the same: **inherit the platform's pattern (cheaper, familiar, accessible-by-default) or impose your own (coherent, branded, but you pay to re-teach and re-implement).** Read each platform's section as the catalog of what you get for free if you conform, so you know exactly what you're spending when you don't.\n\n## Why respect conventions — and when not to\n\n**Respect them when:** the value is in the content\u002Ftask, not the chrome (productivity, utility, system-adjacent apps); you want App Store \u002F Play Store reviewer goodwill; your users span ability levels (native controls inherit accessibility for free); you're a small team that can't afford to re-solve solved problems.\n\n**Use a custom cross-platform brand system when:** the brand *is* the product (games, creative tools, immersive media, strongly-branded consumer apps like Spotify\u002FNotion\u002FLinear); a consistent identity across platforms outweighs per-platform familiarity; you control onboarding enough to teach novel patterns. Spotify, Discord, and Figma deliberately look identical everywhere — that consistency is the point.\n\n**The trade-off, stated plainly:** Native = lower learning cost, free accessibility, store goodwill, but per-platform engineering and a fragmented brand. Custom = one design language and brand coherence, but you re-implement accessibility, you fight platform reflexes (back gesture, share sheet), and stores scrutinize you harder. The mature answer is almost always *hybrid*: a shared brand token layer (color, type scale, spacing, motion personality) with **platform-native navigation, controls, and gestures**. Never ship an iOS app that looks Android, or vice versa — that's the one thing users universally read as \"cheap port.\"\n\n**Store reality:** Apple's App Store Review Guidelines reject apps that feel like a \"repackaged website\" or ignore platform paradigms (§4.0 Design); Apple expects you to use system controls, the native share sheet, and standard navigation. Google Play is more permissive on UI but still rejects on broken back behavior, deceptive patterns, and accessibility failures. Conforming isn't only good UX — it materially lowers rejection risk and speeds review.\n\n---\n\n## iOS — Apple Human Interface Guidelines (iOS 17 \u002F 18)\n\n**Type:** SF Pro (SF Pro Text \u003C 20pt, SF Pro Display ≥ 20pt; New York is the serif). **Dynamic Type is mandatory** — use the 11 text styles (LargeTitle 34, Title1 28, Title2 22, Title3 20, Headline 17 semibold, Body 17, Callout 16, Subhead 15, Footnote 13, Caption1 12, Caption2 11). Never hardcode point sizes for body content; users set their own scale (xSmall→AX5), and respecting it is an accessibility requirement, not an option.\n\n**Touch & grid:** Minimum tap target **44×44 pt** (HIG hard floor). Layout on an **8 pt grid** (4 pt for fine tuning). Standard screen margin 16–20 pt. Points are density-independent; the system rasterizes @1x\u002F@2x\u002F@3x.\n\n**Navigation:**\n- **Navigation bar** (top): back chevron + title, large titles collapse to inline on scroll. Back is always **top-left** + an **edge-swipe-from-left** gesture — never remove either.\n- **Tab bar** (bottom): 2–5 destinations, flat top-level sections, persistent. iOS 18 adds a floating\u002Fmorphing tab bar and (iPad) a tab bar that converts to a sidebar.\n- **Sheets \u002F modals:** prefer **sheets** (slide up, support detents — `.medium`\u002F`.large`, drag-to-dismiss grabber) over full-screen modals. Use full-screen cover only for self-contained tasks. Action sheets for destructive choices anchored to context.\n\n**System feel:**\n- **Safe areas** (notch \u002F Dynamic Island \u002F home indicator): pin to `safeAreaInsets`, never the raw screen rect.\n- **Haptics** via `UIFeedbackGenerator` (selection \u002F impact \u002F notification): expected on toggles, pickers, and success\u002Ferror moments.\n- **Materials & blur:** `.ultraThinMaterial`→`.thickMaterial` vibrancy for bars, popovers, sidebars — don't fake translucency with a flat alpha fill.\n- **Light\u002Fdark:** semantic colors (`.label`, `.systemBackground`, `.separator`), never hardcoded hex.\n- **Accessibility:** respect Reduce Motion and Increase Contrast; ship VoiceOver labels.\n\n**Standard components — reach for these first:** `UIDatePicker` (wheel\u002Fcompact\u002Finline), segmented control, stepper, switch (green capsule), context menus (long-press), swipe actions on rows, and the **system share sheet** (`UIActivityViewController`) — never roll your own share UI.\n\n**iPadOS** is its own interaction model, not a big iPhone:\n- **Three-column split view** (`UISplitViewController`: sidebar \u002F supplementary \u002F secondary) collapses to a stack on iPhone-width.\n- **Popovers anchored to their source** for transient content — not full-height sheets.\n- **Pointer \u002F trackpad** support: the cursor morphs into controls, hover effects, and precise hit-testing — design hover states.\n- **Hardware keyboard:** key-command HUD on ⌘-hold; support standard shortcuts.\n- **Multitasking:** Split View, Slide Over, Stage Manager — your layout must survive arbitrary window sizes via regular\u002Fcompact **size classes**.\n- First-class **drag-and-drop** between apps.\n\n**visionOS basics:** content lives on glass material in 3D space; default window 1280×720 pt at 1m; targets ≥60 pt for eye+pinch; hover highlight is system-driven; put tab bars\u002Ftoolbars in **ornaments** rather than screen-edge chrome.\n\n**iOS do \u002F don't:**\n- **Do** put the most important destination switching in a bottom tab bar; keep it 2–5 items, persistent, flat.\n- **Do** use large titles that collapse on scroll for top-level screens; inline titles for pushed detail screens.\n- **Do** preserve the left-edge back-swipe — if you build a custom transition, keep the interactive pop gesture alive.\n- **Don't** add a hamburger drawer, a FAB, or a bottom snackbar — those are Android signatures and read as foreign.\n- **Don't** put primary actions at the bottom-center as a floating circle; put them top-right in the nav bar or in a toolbar.\n- **Don't** hardcode `17pt`; use the Body text style so Dynamic Type and accessibility sizes flow through.\n\n---\n\n## Android — Material Design 3 (Material You)\n\n**Type:** Roboto (or Roboto Flex) is the default; brand fonts allowed. Type scale tokens: Display L\u002FM\u002FS, Headline L\u002FM\u002FS, Title L\u002FM\u002FS, Body L\u002FM\u002FS (Body Large 16sp), Label L\u002FM\u002FS. **Units are `sp` for text** (scales with user font setting) and **`dp` for everything else.** Using `dp` for text is a bug — it ignores accessibility font scaling.\n\n**Dynamic color (Material You):** M3's signature — the system extracts a tonal palette from the user's **wallpaper** and exposes it via color-role tokens (`primary`, `onPrimary`, `primaryContainer`, `surface`, `surfaceContainerHighest`, `outline`…). Design against **roles**, not raw hex, so your app re-themes itself per device. Provide a static brand fallback for when dynamic color is off.\n\n**Touch & grid:** Minimum target **48×48 dp** (8 dp larger than iOS). **8 dp grid**, **4 dp** for fine spacing\u002Ficon padding. Default screen margins 16 dp.\n\n**Navigation:**\n- **Top app bar** (small \u002F center-aligned \u002F medium \u002F large) — title + nav icon (hamburger or up-arrow) + actions, scrolls with `surfaceContainer` color shift.\n- **Navigation bar** (bottom): 3–5 destinations, pill-shaped active indicator behind the icon.\n- **Navigation rail** (≥600 dp width) and **navigation drawer** (modal or standard) for larger screens \u002F many destinations. The hamburger drawer is *acceptable* on Android in a way it is not on iOS.\n- **FAB:** the single most-important screen action, bottom-right; sizes small\u002Fstandard(56 dp)\u002Flarge\u002Fextended. Distinctly Android — there is no FAB on iOS.\n\n**Surfaces & state:**\n- **Tonal elevation:** M3 expresses height primarily as a lighter, primary-tinted surface color (`surfaceContainerLow`→`surfaceContainerHighest`) rather than only a shadow.\n- **State layers:** hover\u002Ffocus\u002Fpressed\u002Fdragged add a translucent `onSurface` overlay (8% \u002F 10% \u002F 10% \u002F 16%).\n- **Ripple** radiates from the touch point on every pressable — its absence makes the UI feel dead.\n- **Bottom sheets** (modal\u002Fstandard) and **snackbars** (transient, bottom, one optional action — *not* a dialog) are the Android counterparts to iOS sheets\u002Falerts.\n- **Adaptive layouts** by window size class (Compact \u003C600 \u002F Medium 600–840 \u002F Expanded ≥840 dp) drive list ↔ list-detail panes.\n\n**Motion durations (M3 tokens):** short 50–200 ms (state changes, small components) · medium 250–400 ms (most container transitions) · long 450–600 ms (large\u002Ffull-screen) · extra-long 700–1000 ms (hero moments). Easing is **emphasized** (`emphasizedDecelerate`\u002F`emphasizedAccelerate`, ~`cubic-bezier(0.05,0.7,0.1,1)`) with container-transform and shared-axis transitions. For contrast: iOS motion is **spring-based** (no fixed duration ramp, ~0.3–0.5 s defaults, mass\u002Fstiffness\u002Fdamping); Fluent sits ~150–300 ms.\n\n**Android do \u002F don't:**\n- **Do** rely on the **system back** (gesture or button) — you rarely need a per-screen back affordance; up-arrow only for hierarchical \"up,\" which is not the same as back.\n- **Do** design against **color roles** and ship a dynamic-color theme + a static brand fallback.\n- **Do** use a FAB for the one defining action, a snackbar for transient feedback, and a bottom sheet for contextual options.\n- **Do** add ripple + state layers to every pressable; their absence makes the app feel dead\u002Fun-Android.\n- **Don't** copy iOS's green capsule switch, wheel date picker, or top-left chevron back — use Material's switch, calendar\u002Fdial pickers, and system back.\n- **Don't** size text in `dp` — it silently ignores the user's font-scale setting.\n\n---\n\n## iOS vs. Android — the head-to-head\n\n| Dimension | iOS (HIG) | Android (Material 3) |\n|---|---|---|\n| Primary navigation | **Tab bar** (bottom, 2–5) | **Navigation bar** (bottom, 3–5) \u002F rail \u002F drawer |\n| \"Back\" | Top-left chevron **+ edge-swipe** | System back (gesture \u002F button); no per-screen back needed |\n| Hamburger menu | Avoid — un-iOS | Acceptable (navigation drawer) |\n| Primary screen action | Top-right bar button | **FAB** (bottom-right) |\n| Modal pattern | **Sheet** with detents, drag-to-dismiss | **Bottom sheet** \u002F full-screen dialog |\n| Alert \u002F transient msg | Alert + **action sheet** | **Dialog** + **snackbar** |\n| Type unit | **pt** (Dynamic Type styles) | **sp** (text) \u002F **dp** (layout) |\n| Min touch target | **44 pt** | **48 dp** |\n| Grid | 8 pt (4 fine) | 8 dp (4 fine) |\n| Icon style | **SF Symbols** — thin, rounded, optically sized | **Material Symbols** — geometric, fill\u002Fweight\u002Fgrade axes |\n| Switch | Green capsule, no label inside | Track + thumb with checkmark, role-colored |\n| Date picker | Wheel \u002F compact \u002F inline calendar | Calendar dialog \u002F docked \u002F dial time picker |\n| Share | **System share sheet** (`UIActivityViewController`) | **Android Sharesheet** (`ACTION_SEND`) |\n| Settings | Inside the app (Settings.app for system perms) | In-app + system Settings deep links |\n| Color theming | Semantic system colors, vibrancy | **Dynamic color** from wallpaper (tonal roles) |\n| Elevation | Materials \u002F blur layering | **Tonal** elevation + shadow + state layers |\n\n**Cardinal sins:** an iOS-looking app on Android (and vice versa) reads as a low-effort port. The most damaging are: a top-left back button on Android (use system back), a FAB on iOS, a hamburger drawer on iOS, hardcoded font sizes that ignore Dynamic Type \u002F `sp`, custom non-native date pickers, and a bespoke share screen instead of the OS share sheet.\n\n---\n\n## macOS (Sonoma \u002F Sequoia)\n\n**Density is the headline difference from iOS** — pointer precision means smaller, denser controls (min ~28 pt clickable, not 44), tighter rows, more affordances visible at once. **Don't ship an iPad app stretched to a window.**\n\n- **Menu bar** (global, top of screen): the canonical home for *every* command — App \u002F File \u002F Edit \u002F View \u002F Window \u002F Help plus app menus. If a command isn't in a menu, it's not discoverable and not keyboard-reachable. Mirror toolbar actions here.\n- **Toolbar:** customizable, lives in the window title bar (unified in modern macOS); icon + optional label buttons for frequent actions.\n- **Sidebar:** primary navigation (source list) with translucency\u002F**vibrancy**; collapsible; sections + disclosure groups.\n- **Window chrome:** traffic-light controls top-left, resizable, full-screen and Stage Manager aware. Support **multiple windows** and tabs; state restoration on relaunch.\n- **Pointer affordances:** **hover** states, **right-click \u002F Control-click context menus** everywhere, cursor changes (resize, text I-beam, link pointer). These don't exist on touch — design them in, not as an afterthought.\n- **Keyboard:** full shortcut coverage with standard bindings (⌘C\u002FV\u002FZ, ⌘W close, ⌘, Preferences, ⌘N new). Tab moves focus; everything operable without a mouse.\n\n**macOS do \u002F don't:**\n- **Do** put every command in the menu bar (even ones also in a toolbar) so it's keyboard-reachable and discoverable.\n- **Do** support multiple resizable windows + tabs and restore window state on relaunch.\n- **Do** design hover, right-click, and cursor-change states — pointer affordances are first-class here.\n- **Don't** ship a touch-density iPad layout with 44 pt targets stretched across a window.\n- **Don't** hide commands only behind toolbar icons or omit standard ⌘-shortcuts; Mac users navigate by keyboard and menu.\n\n---\n\n## Windows 11 — Fluent Design (WinUI 3 \u002F WinAppSDK)\n\n- **Type:** **Segoe UI Variable** (Display\u002FText\u002FSmall optical sizes); type ramp Caption 12 → Body 14 → Subtitle 20 → Title 28 → Display 68.\n- **Materials:** **Mica** (opaque, wallpaper-tinted, for the base window background) and **Acrylic** (translucent, blurred, for transient\u002Flayered surfaces — flyouts, command bars). Mica is the modern default for app backgrounds.\n- **Shape:** rounded corners — **8 px** on windows\u002Fcards\u002Fflyouts, **4 px** on small controls. A flat square-cornered window reads as legacy Win32.\n- **Navigation:** **NavigationView** — left pane that auto-adapts (expanded ↔ compact rail ↔ overflow) by width; **breadcrumb bar** for hierarchy; **TabView** for documents.\n- **Commands:** **CommandBar** (primary actions + overflow `…`), context menus, and the right-click menu.\n- **Theme:** full light\u002Fdark + the system-wide **accent color** the user picks — tint with it.\n- **Density:** a Compact spacing variant exists for data-dense apps.\n- **Input:** must work for **mouse, touch, pen, and gamepad** — ~40×40 px touch targets, hover\u002Ffocus visuals for mouse and pen.\n\n**Windows do \u002F don't:** **Do** use Mica for the window base, Acrylic for flyouts\u002Fmenus, rounded corners, and the system accent color. **Don't** ship flat square-cornered surfaces with hard shadows (reads as legacy Win32), and don't assume mouse-only — Surface devices are touch + pen.\n\n---\n\n## Web — borrow patterns, respect the wrapper\n\nThe web has **no single OS convention** — so you inherit the *browser's* contract (back\u002Fforward, the URL, Ctrl\u002F⌘+F, zoom, reader mode, text selection) and the **WCAG** baseline, then layer your own design language. Don't break browser back, don't hijack scroll, keep links as links.\n\n**The wrapper rule:** the moment your web UI is packaged, the host platform's conventions reassert themselves:\n- **Electron \u002F Tauri (desktop):** honor the menu bar (macOS global menu vs. Windows in-window menu), native window controls, OS keyboard shortcuts, light\u002Fdark, and platform-correct titlebar. A web app in a window that ignores ⌘-shortcuts feels broken.\n- **PWA \u002F mobile web:** respect safe-area insets (`env(safe-area-inset-*)`), `theme-color`, the install\u002Fstandalone display mode, and touch target sizes (≥44 px). On iOS Safari, account for the dynamic toolbar (`100dvh` not `100vh`).\n- **Responsive:** users expect fluid reflow across breakpoints (mobile \u002F tablet \u002F desktop), no horizontal scroll, and touch-friendly hit areas on small screens. This is itself a convention — violate it and the site feels broken.\n\n---\n\n## Cross-platform strategy\n\n**Keep consistent (the brand layer):** design tokens (color roles, type scale ratios, spacing scale, radius, motion personality), content\u002Fvoice, information architecture, iconography family, illustration. These travel.\n\n**Adapt per platform (the experience layer):** navigation structure (tab bar vs. nav bar vs. menu bar), control appearance (switches, pickers, buttons), gestures (back-swipe, long-press vs. right-click), typography *units* (pt\u002Fsp\u002Fdp\u002Fpx) and the system font, share\u002Fprint\u002Fsettings hooks, density, and the elevation\u002Fmaterial model. These must be native.\n\n**Worked example — one \"compose new message\" feature, five platforms.** Same brand color, type ramp, and copy throughout; the *behavior* is native each time:\n- **iOS:** a top-right \"compose\" bar button (or a prominent toolbar button) opens a **sheet** with detents; recipients use the native contact picker; send confirmation is a subtle haptic.\n- **Android:** a **FAB** (bottom-right) opens a full-screen compose; a **snackbar** confirms \"Message sent\" with an Undo; back is the system gesture.\n- **macOS:** **⌘N** and a `File ▸ New Message` menu item open a **new window**; the toolbar holds Send; right-click a recipient for actions.\n- **Windows:** a **CommandBar** \"New\" button opens a compose pane in an Acrylic flyout; Send is a primary command; Ctrl+N works too.\n- **Web:** a button opens a modal\u002Froute; the browser back button closes it; ⌘\u002FCtrl+Enter sends.\nOne feature, one brand — five correct platform expressions. That is the whole strategy in miniature.\n\n**Framework caveats:**\n- **React Native \u002F Flutter:** ship one codebase but you must still branch behavior — RN's `Platform.select`, Flutter's Cupertino vs. Material widget sets. \"Write once, run anywhere\" with one UI = uncanny on at least one platform. Budget for platform-specific navigation and controls.\n- **Compose Multiplatform:** Material-first; you own re-creating an iOS look if you want native feel there — it won't be automatic.\n- **Catalyst \u002F SwiftUI multiplatform:** closer to free adaptation, but density and pointer affordances on Mac still need explicit attention.\n- **Ionic \u002F Capacitor (web in a native shell):** you get one web UI everywhere — acceptable for content\u002Futility apps, but you must still respect safe areas, hardware back on Android, and the system share sheet, or it feels like a website in a frame.\n\n---\n\n## Accessibility per platform\n\nNative controls inherit most of this for free — another reason to conform. If you build custom, you re-implement all of it.\n\n| Platform | Screen reader | Text scaling | Other expected |\n|---|---|---|---|\n| iOS \u002F iPadOS | **VoiceOver** | **Dynamic Type** (text styles) | Reduce Motion, Increase Contrast, Bold Text, Switch Control, Voice Control; min contrast WCAG AA |\n| Android | **TalkBack** | system **font scale** (use `sp`) | Switch Access, color-inversion, large-touch, content descriptions on every control |\n| macOS | **VoiceOver** | system text size, hover text | **Full Keyboard Access**, Increase Contrast, Reduce Motion, focus rings |\n| Windows 11 | **Narrator** | system text scaling | High Contrast themes, keyboard nav, focus visuals, UI Automation patterns |\n| Web | platform SR (VoiceOver \u002F NVDA \u002F Narrator) | browser zoom + rem\u002F`em` | **WCAG 2.2 AA**, semantic HTML, ARIA only when HTML can't, visible focus, reduced-motion query |\n\n**The throughline:** every platform exposes a user-chosen text scale and a screen reader. Hardcoded sizes and unlabeled custom controls break both — the single most common accessibility regression across all five.\n\n## Icons & assets per platform\n\n| Platform | App icon | In-UI icons | Notes |\n|---|---|---|---|\n| iOS \u002F iPadOS | **1024×1024** single master (Xcode generates the rest); rounded-rect mask applied by OS — supply a **square**, no pre-rounded corners | **SF Symbols** (vector, weight + scale matched to text) | Don't bake the corner radius; provide light\u002Fdark\u002Ftinted variants (iOS 18) |\n| Android | **Adaptive icon**: 108×108 dp = 72 dp safe zone, separate **foreground + background** layers (system masks to circle\u002Fsquircle\u002Fetc.); Play Store **512×512** | **Material Symbols** (fill\u002Fweight\u002Fgrade\u002Foptical-size axes) | Never a single flat PNG — adaptive layers or it clips wrong |\n| macOS | **1024×1024**, rounded-square with subtle depth (squircle), supply full `.icns` set | SF Symbols + custom template images | More skeuomorphic depth than iOS flat |\n| Windows 11 | App icon at multiple sizes (16→256 px) + tile\u002FStore assets; rounded modern style | **Fluent \u002F Segoe Fluent Icons** | Provide unplated + plated variants |\n| Web \u002F PWA | `favicon` set + **512×512** + **maskable** icon (safe zone for masking) + apple-touch-icon 180×180 | SVG sprite or icon font | Maskable icon prevents Android cropping |\n\n---\n\n## Common mistakes (quick scan)\n\n- iOS-style UI on Android or Android-style on iOS — instant \"cheap port.\"\n- Custom navigation that breaks the **system back** (Android) or **edge-swipe back** (iOS).\n- Ignoring **safe areas** \u002F notch \u002F home indicator \u002F dynamic toolbar.\n- Hardcoded font sizes that ignore **Dynamic Type (iOS)** or **`sp` (Android)**.\n- A **hamburger menu on iOS**, or a **FAB on iOS** — both are Android idioms.\n- Rolling your own **share sheet, date picker, or alert** instead of the system component.\n- Hardcoded colors instead of **semantic \u002F role tokens** → broken dark mode and no dynamic color.\n- macOS app that's just a stretched iPad layout — no menu bar, no right-click, no density.\n- Square-cornered, shadow-only, non-Mica Windows app that looks like Win32.\n- Touch targets under 44 pt \u002F 48 dp; no hover\u002Ffocus states on pointer platforms.\n- Faking blur with flat alpha instead of real **materials\u002Fvibrancy\u002FAcrylic**.\n- Breaking browser **back\u002Fforward**, scroll, or text selection on the web.\n\n**The one rule:** ship the brand once, ship the *behavior* native. Tokens are shared; navigation, controls, and gestures belong to the platform.\n",{"name":5,"tags":23,"description":7},[24,25,26,27,28,29,30],"design-systems","platforms","ios","android","desktop","hig","material","main","4911ae44bbb35beef4511ba298475ba5a82b7e1c","design-system-skills\u002Fplatform-conventions",0,"https:\u002F\u002Fgithub.com\u002Fjpoindexter\u002FVanta","https:\u002F\u002Fdocs.vanta.theft.studio","https:\u002F\u002Fgithub.com\u002Fjpoindexter","jason.theft.studio","Just some guy trying to build stuff","2026-11-12 17:11:35",{"source":8,"skillName":5,"commands":42,"prompt":52,"zipAvailable":53},[43,46,49],{"tool":44,"command":45},"npx","npx skills add jpoindexter\u002FVanta --skill platform-conventions",{"tool":47,"command":48},"bunx","bunx skills add jpoindexter\u002FVanta --skill platform-conventions",{"tool":50,"command":51},"pnpm","pnpm dlx skills add jpoindexter\u002FVanta --skill platform-conventions","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjpoindexter\u002FVanta\u002Fblob\u002Fmain\u002Fdesign-system-skills\u002Fplatform-conventions\u002FSKILL.md",true,[],[56,63,70,77,84,90],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":18},"01M7582PEM7XM8B98VFRDV0C0J","write-changelog","Turn a range of commits into a user-facing changelog","https:\u002F\u002Fgithub.com\u002Fjpoindexter\u002FVanta\u002Fblob\u002Fmain\u002Fvanta-ts\u002Fsrc\u002Fmigrate\u002F__fixtures__\u002Fopenclaw\u002Fskills\u002Fwrite-changelog\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":18},"01M7582KTQJMP5Y7GS83MS1C7Z","debug-flaky-test","Reproduce and isolate a flaky test before fixing it","https:\u002F\u002Fgithub.com\u002Fjpoindexter\u002FVanta\u002Fblob\u002Fmain\u002Fvanta-ts\u002Fsrc\u002Fmigrate\u002F__fixtures__\u002Fopenclaw\u002Fskills\u002Fdebug-flaky-test\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":18},"01M7582HG7XFM4Z5NGG1YFECT8","triage-incident","First 10 minutes of an incident — stabilize, then diagnose","https:\u002F\u002Fgithub.com\u002Fjpoindexter\u002FVanta\u002Fblob\u002Fmain\u002Fvanta-ts\u002Fsrc\u002Fmigrate\u002F__fixtures__\u002Fhermes\u002Fskills\u002Ftriage-incident\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":18},"01M7582DQABK7A96XHMB770KQZ","writing-plans","Write implementation plans: bite-sized tasks, paths, code.","https:\u002F\u002Fgithub.com\u002Fjpoindexter\u002FVanta\u002Fblob\u002Fmain\u002Fvanta-ts\u002Fskills-library\u002Fwriting-plans\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":18},"01M7582BBK8H0HGSXKK08FCXJ1","vanta-port-adapter","https:\u002F\u002Fgithub.com\u002Fjpoindexter\u002FVanta\u002Fblob\u002Fmain\u002Fvanta-ts\u002Fskills-library\u002Fvanta-port-adapter\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":18},"01M75828P8PX5XSBMJ2BVVDA9Y","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002Fjpoindexter\u002FVanta\u002Fblob\u002Fmain\u002Fvanta-ts\u002Fskills-library\u002Ftest-driven-development\u002FSKILL.md",[],[]]