buildanything 1.8.0 → 2.1.1

package/skills/ios/hig-technologies/SKILL.md

@@ -0,0 +1,107 @@
+---
+name: hig-technologies
+version: 1.0.0
+description: >-
+  Apple HIG guidance for Apple technology integrations: Siri, Apple Pay, HealthKit,
+  HomeKit, ARKit, machine learning, generative AI, iCloud, Sign in with Apple,
+  SharePlay, CarPlay, Game Center, in-app purchase, NFC, Wallet, VoiceOver, Maps,
+  Mac Catalyst, and more. Use when asked about: "Siri integration", "Apple Pay",
+  "HealthKit", "HomeKit", "ARKit", "augmented reality", "machine learning",
+  "generative AI", "iCloud sync", "Sign in with Apple", "SharePlay", "CarPlay",
+  "in-app purchase", "NFC", "VoiceOver", "Maps", "Mac Catalyst". Also use when
+  the user says "how do I integrate Siri," "what are the Apple Pay guidelines,"
+  "how should my AR experience work," "how do I use Sign in with Apple," or asks
+  about any Apple framework or service integration.
+  Cross-references: hig-inputs for input methods, hig-components-system for widgets.
+---
+
+# Apple HIG: Technologies
+
+Check for `.claude/apple-design-context.md` before asking questions. Use existing context and only ask for information not already covered.
+
+## Key Principles
+
+1. **Apple technologies extend app capabilities through system integration.** Each technology has established user-facing patterns; deviating creates confusion and erodes trust.
+
+2. **Privacy and user control are paramount.** Especially for health, payment, and identity technologies. Request only needed data, explain why, respect choices.
+
+3. **Siri: natural, predictable, recoverable.** Clear conversational intent phrases that complete quickly and confirm results. Support App Shortcuts for proactive suggestions. Handle errors with clear fallbacks.
+
+4. **Payments: transparent and frictionless.** Standard Apple Pay button styles. Never ask for card details when Apple Pay is available. Clearly describe what the user is buying, the price, and whether it's one-time or subscription.
+
+5. **Health data is deeply personal.** Explain the health benefit before requesting access. CareKit tasks should be encouraging. ResearchKit consent flows must be thorough, readable, and respect autonomy.
+
+6. **HomeKit: simple and reliable.** Immediate response when controlling devices. Clear device state. Graceful handling of connectivity issues.
+
+7. **AR: genuine value, not gimmicks.** Use AR when spatial context improves understanding. Guide setup (surface, lighting, space). Provide clear exit back to standard interaction.
+
+8. **ML and generative AI: enhance without surprising.** Smart suggestions, image recognition, text prediction. Clearly attribute AI-generated content. Controls to edit, regenerate, or dismiss. Let users correct mistakes.
+
+9. **Sign in with Apple as top option.** Standard button styles. Respect email hiding preference. ID Verifier: guided flows, don't store sensitive data beyond what verification requires.
+
+10. **iCloud: invisible and reliable sync.** Data appears on all devices without manual intervention. Handle conflicts gracefully. Never lose data.
+
+11. **SharePlay: real-time participation.** Support multiple participants, show presence, handle latency. AirPlay: appropriate Now Playing metadata.
+
+12. **CarPlay: driver safety first.** Minimize interaction complexity, large touch targets, no distracting content. Only permitted app types: audio, messaging, EV charging, navigation, parking, quick food ordering.
+
+13. **Accessibility is a baseline requirement.** Every element has a meaningful VoiceOver label, trait, and action. Support Dynamic Type, Switch Control, and other assistive technologies. Test entirely with VoiceOver enabled.
+
+## Reference Index
+
+| Reference | Topic | Key content |
+|---|---|---|
+| [siri.md](references/siri.md) | Siri | Intents, shortcuts, voice interaction, App Shortcuts |
+| [apple-pay.md](references/apple-pay.md) | Apple Pay | Payment buttons, checkout flow, security |
+| [tap-to-pay-on-iphone.md](references/tap-to-pay-on-iphone.md) | Tap to Pay | Merchant flows, contactless payment |
+| [in-app-purchase.md](references/in-app-purchase.md) | In-app purchase | Subscriptions, one-time purchases, transparency |
+| [healthkit.md](references/healthkit.md) | HealthKit | Health data access, privacy, permissions |
+| [carekit.md](references/carekit.md) | CareKit | Care plans, tasks, health management |
+| [researchkit.md](references/researchkit.md) | ResearchKit | Studies, informed consent, data collection |
+| [homekit.md](references/homekit.md) | HomeKit | Smart home control, device state, scenes |
+| [augmented-reality.md](references/augmented-reality.md) | ARKit | Spatial context, surface detection, setup |
+| [machine-learning.md](references/machine-learning.md) | Core ML | Predictions, smart features, confidence handling |
+| [generative-ai.md](references/generative-ai.md) | Generative AI | Attribution, editing, responsible AI, uncertainty |
+| [icloud.md](references/icloud.md) | iCloud | CloudKit, cross-device sync, conflict resolution |
+| [sign-in-with-apple.md](references/sign-in-with-apple.md) | Sign in with Apple | Authentication, privacy, button styles |
+| [id-verifier.md](references/id-verifier.md) | ID Verifier | Identity verification, document scanning |
+| [shareplay.md](references/shareplay.md) | SharePlay | Shared experiences, participant presence |
+| [airplay.md](references/airplay.md) | AirPlay | Media streaming, Now Playing, wireless display |
+| [carplay.md](references/carplay.md) | CarPlay | Driver safety, permitted app types, large targets |
+| [game-center.md](references/game-center.md) | Game Center | Achievements, leaderboards, multiplayer |
+| [voiceover.md](references/voiceover.md) | VoiceOver | Screen reader, labels, traits, accessibility |
+| [wallet.md](references/wallet.md) | Wallet | Passes, tickets, loyalty cards |
+| [nfc.md](references/nfc.md) | NFC | Tag reading, quick interactions, App Clips |
+| [maps.md](references/maps.md) | Maps | Location display, annotations, directions |
+| [mac-catalyst.md](references/mac-catalyst.md) | Mac Catalyst | iPad to Mac, menu bar, keyboard, pointer |
+| [live-photos.md](references/live-photos.md) | Live Photos | Motion capture, playback, editing |
+| [imessage-apps-and-stickers.md](references/imessage-apps-and-stickers.md) | iMessage apps | Messages extension, stickers, compact UI |
+| [shazamkit.md](references/shazamkit.md) | ShazamKit | Audio recognition, music identification |
+| [always-on.md](references/always-on.md) | Always-on display | Dimmed state, power efficiency, reduced updates |
+| [photo-editing.md](references/photo-editing.md) | Photo editing | System photo editor, filters, adjustments |
+
+## Output Format
+
+1. **Implementation checklist** -- step-by-step requirements per Apple's guidelines.
+2. **Required vs optional features** for approval.
+3. **Privacy and permission requirements** -- data access, usage descriptions.
+4. **User-facing flow** from permission prompt through task completion.
+5. **Testing guidance** -- key scenarios including edge cases.
+
+## Questions to Ask
+
+1. Which Apple technology?
+2. Core use case?
+3. Which platforms?
+4. API requirements and entitlements reviewed?
+5. What data or permissions needed?
+
+## Related Skills
+
+- **hig-inputs** -- Input methods interacting with technologies (voice for Siri, Pencil for AR, gestures for Maps)
+- **hig-components-system** -- Widgets, complications, Live Activities surfacing technology data
+- **hig-components-status** -- Progress indicators for technology operations (sync, payment, AR loading)
+
+---
+
+*Built by [Raintree Technology](https://raintree.technology) · [More developer tools](https://raintree.technology)*

package/skills/ios/hig-technologies/references/airplay.md

@@ -0,0 +1,125 @@
+---
+title: "AirPlay | Apple Developer Documentation"
+source: https://developer.apple.com/design/human-interface-guidelines/airplay
+
+# AirPlay
+
+AirPlay lets people stream media content wirelessly from iOS, iPadOS, macOS, and tvOS devices to Apple TV, HomePod, and TVs and speakers that support AirPlay.
+
+![A sketch of the AirPlay icon. The image is overlaid with rectangular and circular grid lines and is tinted blue to subtly reflect the blue in the original six-color Apple logo.](https://docs-assets.developer.apple.com/published/593648369fde5b646fed363f6b420ccd/technologies-AirPlay-intro%402x.png)
+
+## [Best practices](https://developer.apple.com/design/human-interface-guidelines/airplay#Best-practices)
+
+**Prefer the system-provided media player.** The built-in media player offers a standard set of controls and supports features like chapter navigation, subtitles, closed captioning, and AirPlay streaming. It’s also easy to implement, provides a consistent and familiar playback experience across the system, and accommodates the needs of most media apps. Consider designing a custom video player only if the system-provided player doesn’t meet your app’s needs. For developer guidance, see [`AVPlayerViewController`](https://developer.apple.com/documentation/AVKit/AVPlayerViewController).
+
+![A screenshot of the system-provided media player paused while playing a video.](https://docs-assets.developer.apple.com/published/f6ea036a0e6db3780504adc3c8afece4/airplay-video-screen%402x.png)
+
+**Provide content in the highest possible resolution.** Your [HTTP Live Streaming](https://developer.apple.com/documentation/http-live-streaming) (HLS) playlist needs to include the full range of available resolutions so that people can experience your content in the resolution that’s appropriate for the device they’re using (AVFoundation automatically selects the resolution based on the device). If you don’t include a range of resolutions, your content looks low quality when people stream it to a device that can play at higher resolutions. For example, content that looks great on iPhone at 720p will look low quality when people use AirPlay to stream it to a 4K TV.
+
+**Stream only the content people expect.** Avoid streaming content like background loops and short video experiences that make sense only within the context of the app itself. For developer guidance, see [`usesExternalPlaybackWhileExternalScreenIsActive`](https://developer.apple.com/documentation/AVFoundation/AVPlayer/usesExternalPlaybackWhileExternalScreenIsActive).
+
+**Support both AirPlay streaming and mirroring.** Supporting both features gives people the most flexibility.
+
+**Support remote control events.** When you do, people can choose actions like play, pause, and fast forward on the lock screen, and through interaction with Siri or HomePod. For developer guidance, see [Remote command center events](https://developer.apple.com/documentation/MediaPlayer/remote-command-center-events).
+
+**Don’t stop playback when your app enters the background or when the device locks.** For example, people expect the TV show they started streaming from your app to continue while they check their mail or put their device to sleep. In this type of scenario, it’s also crucial to avoid automatic mirroring because people don’t want to stream other content on their device without explicitly choosing to do so.
+
+**Don’t interrupt another app’s playback unless your app is starting to play immersive content.** For example, if your app plays a video when it launches or auto-plays inline videos, play this content on only the local device, while allowing current playback to continue. For developer guidance, see [`ambient`](https://developer.apple.com/documentation/AVFAudio/AVAudioSession/Category-swift.struct/ambient).
+
+**Let people use other parts of your app during playback.** When AirPlay is active, your app needs to remain functional. If people navigate away from the playback screen, make sure other in-app videos don’t begin playing and interrupt the streaming content.
+
+**If necessary, provide a custom interface for controlling media playback.** If you can’t use the system-provided media player, you can create a custom media player that gives people an intuitive way to enter AirPlay. If you need to do this, be sure to provide custom buttons that match the appearance and behavior of the system-provided ones, including distinct visual states that indicate when playback starts, is occurring, or is unavailable. Use only Apple-provided symbols in custom controls that initiate AirPlay, and position the AirPlay icon correctly in your custom player — that is, in the lower-right corner (in iOS 16 and iPadOS 16 and later).
+
+## [Using AirPlay icons](https://developer.apple.com/design/human-interface-guidelines/airplay#Using-AirPlay-icons)
+
+You can download AirPlay icons in [Resources](https://developer.apple.com/design/resources/). You have the following options for displaying the AirPlay icon in your app.
+
+### [Black AirPlay icon](https://developer.apple.com/design/human-interface-guidelines/airplay#Black-AirPlay-icon)
+
+Use the black AirPlay icon on white or light backgrounds when other technology icons also appear in black.
+
+![Two black AirPlay icons. The left one is the audio AirPlay icon, represented by a triangle below three concentric lines. The right one is the video AirPlay icon, represented by a triangle below a rounded rectangle.](https://docs-assets.developer.apple.com/published/86e9b97be338e8f54764489242441e37/airplay-black-icon-set%402x.png)
+
+### [White AirPlay icon](https://developer.apple.com/design/human-interface-guidelines/airplay#White-AirPlay-icon)
+
+Use the white AirPlay icon on black or dark backgrounds when other technology icons also appear in white.
+
+![Two white AirPlay icons. The left one is the audio AirPlay icon, represented by a triangle below three concentric lines. The right one is the video AirPlay icon, represented by a triangle below a rounded rectangle.](https://docs-assets.developer.apple.com/published/62baec25a6d8215e9f28971b08bf18b3/airplay-white-icon-set%402x.png)
+
+### [Custom color AirPlay icon](https://developer.apple.com/design/human-interface-guidelines/airplay#Custom-color-AirPlay-icon)
+
+Use a custom color when other technology icons also appear in the same color.
+
+![Two blue AirPlay icons. The left one is the audio AirPlay icon, represented by a triangle below three concentric lines. The right one is the video AirPlay icon, represented by a triangle below a rounded rectangle.](https://docs-assets.developer.apple.com/published/91abb9f30406a70ef7f08541fd4e191b/airplay-custom-color-icon-set%402x.png)
+
+**Position the AirPlay icon consistently with other technology icons.** If you display other technology icons within shapes, you can display the AirPlay icon in the same manner.
+
+**Don’t use the AirPlay icon or name in custom buttons or interactive elements.** Use the icon and the name _AirPlay_ only in noninteractive ways.
+
+**Pair the icon with the name _AirPlay_ correctly.** You can show the name below or beside the icon if you also reference other technologies in this way. Use the same font you use in the rest of your layout. Avoid using the AirPlay icon within text or as a replacement for the name _AirPlay_.
+
+**Emphasize your app over AirPlay.** Make references to AirPlay less prominent than your app name or main identity.
+
+## [Referring to AirPlay](https://developer.apple.com/design/human-interface-guidelines/airplay#Referring-to-AirPlay)
+
+**Use correct capitalization when using the term _AirPlay_.** _AirPlay_ is one word, with an uppercase _A_ and uppercase _P_ , each followed by lowercase letters. If your layout displays only all-uppercase designations, you can typeset _AirPlay_ in all uppercase to match the style of the rest of the layout.
+
+**Always use _AirPlay_ as a noun.**
+
+| Example text  
+---|---  
+![A checkmark in a circle to indicate correct usage.](https://docs-assets.developer.apple.com/published/88662da92338267bb64cd2275c84e484/checkmark%402x.png)| Use AirPlay to listen on your speaker  
+![An X in a circle to indicate incorrect usage.](https://docs-assets.developer.apple.com/published/209f6f0fc8ad99d9bf59e12d82d06584/crossout%402x.png)| AirPlay to your speaker  
+![An X in a circle to indicate incorrect usage.](https://docs-assets.developer.apple.com/published/209f6f0fc8ad99d9bf59e12d82d06584/crossout%402x.png)| You can AirPlay with [App Name]  
+  
+**Use terms like _works with_ , _use_ , _supports_ , and _compatible_.**
+
+| Example text  
+---|---  
+![A checkmark in a circle to indicate correct usage.](https://docs-assets.developer.apple.com/published/88662da92338267bb64cd2275c84e484/checkmark%402x.png)| [App Name] is compatible with AirPlay  
+![A checkmark in a circle to indicate correct usage.](https://docs-assets.developer.apple.com/published/88662da92338267bb64cd2275c84e484/checkmark%402x.png)| AirPlay-enabled speaker  
+![A checkmark in a circle to indicate correct usage.](https://docs-assets.developer.apple.com/published/88662da92338267bb64cd2275c84e484/checkmark%402x.png)| You can use AirPlay with [App Name]  
+![An X in a circle to indicate incorrect usage.](https://docs-assets.developer.apple.com/published/209f6f0fc8ad99d9bf59e12d82d06584/crossout%402x.png)| [App Name] has AirPlay  
+  
+**Use the name _Apple_ with the name _AirPlay_ if desired.**
+
+| Example text  
+---|---  
+![A checkmark in a circle to indicate correct usage.](https://docs-assets.developer.apple.com/published/88662da92338267bb64cd2275c84e484/checkmark%402x.png)| Compatible with Apple AirPlay  
+  
+**Refer to AirPlay if appropriate and to add clarity.** If your content is specific to AirPlay, you can use Airplay to make that clear. You can also refer to AirPlay in technical specifications.
+
+| Example text  
+---|---  
+![A checkmark in a circle to indicate correct usage.](https://docs-assets.developer.apple.com/published/88662da92338267bb64cd2275c84e484/checkmark%402x.png)| [App Name] now supports AirPlay  
+  
+## [Platform considerations](https://developer.apple.com/design/human-interface-guidelines/airplay#Platform-considerations)
+
+ _No additional considerations for iOS, iPadOS, macOS, tvOS, or visionOS. Not supported in watchOS._
+
+## [Resources](https://developer.apple.com/design/human-interface-guidelines/airplay#Resources)
+
+#### [Related](https://developer.apple.com/design/human-interface-guidelines/airplay#Related)
+
+[Apple Design Resources](https://developer.apple.com/design/resources/)
+
+[Apple Trademark List](https://www.apple.com/legal/intellectual-property/trademark/appletmlist.html)
+
+[Guidelines for Using Apple Trademarks and Copyrights](https://www.apple.com/legal/intellectual-property/guidelinesfor3rdparties.html)
+
+#### [Developer documentation](https://developer.apple.com/design/human-interface-guidelines/airplay#Developer-documentation)
+
+[AVFoundation](https://developer.apple.com/documentation/AVFoundation)
+
+[AVKit](https://developer.apple.com/documentation/AVKit)
+
+#### [Videos](https://developer.apple.com/design/human-interface-guidelines/airplay#Videos)
+
+[![](https://devimages-cdn.apple.com/wwdc-services/images/48/8FCAD355-E1A3-4407-9261-95A3D6026DE8/2661_wide_250x141_1x.jpg) Reaching the Big Screen with AirPlay 2 ](https://developer.apple.com/videos/play/wwdc2019/501)
+
+## [Change log](https://developer.apple.com/design/human-interface-guidelines/airplay#Change-log)
+
+Date| Changes  
+---|---  
+May 2, 2023| Consolidated guidance into one page.  
+  

package/skills/ios/hig-technologies/references/always-on.md

@@ -0,0 +1,62 @@
+---
+title: "Always On | Apple Developer Documentation"
+source: https://developer.apple.com/design/human-interface-guidelines/always-on
+
+# Always On
+
+On devices that include the Always On display, the system can continue to display an app’s interface when people suspend their interactions with the device.
+
+![A sketch of an Apple Watch containing a person running, suggesting an Always On display. The image is overlaid with rectangular and circular grid lines and is tinted blue to subtly reflect the blue in the original six-color Apple logo.](https://docs-assets.developer.apple.com/published/b4927d8e754728228fdf9997f28acc35/technologies-always-on-intro%402x.png)
+
+In the Always On state, a device can continue to give people useful, glanceable information in a low-power, privacy-preserving way by dimming the display and minimizing onscreen motion. The system can display different items depending on the device.
+
+  * On iPhone 14 Pro and iPhone 14 Pro Max, the system displays Lock Screen items like [Widgets](https://developer.apple.com/design/human-interface-guidelines/widgets) and [Live Activities](https://developer.apple.com/design/human-interface-guidelines/live-activities) when people set aside their device face up and stop interacting with it.
+
+  * When people drop their wrist while wearing Apple Watch, the system dims the watch face, continuing to display the interface of the app as long as it’s either frontmost or running a background session.
+
+
+
+
+On both devices, the system displays notifications while in Always On, and people can tap the display to exit Always On and resume interactions.
+
+## [Best practices](https://developer.apple.com/design/human-interface-guidelines/always-on#Best-practices)
+
+**Hide sensitive information.** It’s crucial to redact personal information that people wouldn’t want casual observers to view, like bank balances or health data. You also need to hide personal information that might be visible in a notification; for guidance, see [Notifications](https://developer.apple.com/design/human-interface-guidelines/notifications).
+
+**Keep other types of personal information glanceable when it makes sense.** On Apple Watch, for example, people typically appreciate getting pace and heart rate updates while they’re working out; on iPhone, people appreciate getting a glanceable update on a flight arrival or a notification when a ride-sharing service arrives. If people don’t want any information to be visible, they can turn off Always On.
+
+**Keep important content legible and dim nonessential content.** You can increase dimming on secondary text, images, and color fills to give more prominence to the information that’s important to people. For example, a to-do list app might remove row backgrounds and dim each item’s additional details to highlight its title. Also, if you display rich images or large areas of color, consider removing the images and using dimmed colors.
+
+**Maintain a consistent layout.** Avoid making distracting interface changes when Always On begins or ends and throughout the Always On experience. For example, when Always On begins, prefer transitioning an interactive component to an unavailable appearance — don’t just remove it. Within the Always On context, aim to make infrequent, subtle updates to the interface. For example, a sports app might pause granular play-by-play updates while in Always On, only updating the score when it changes. Note that unnecessary changes during Always On can be especially distracting on iPhone, because people often put their device face up on a surface, making motion on the screen visible even when they’re not looking directly at it.
+
+**Gracefully transition motion to a resting state; don’t stop it instantly.** Smoothly finishing the current motion helps communicate the transition and avoids making people think that something went wrong.
+
+## [Platform considerations](https://developer.apple.com/design/human-interface-guidelines/always-on#Platform-considerations)
+
+ _No additional considerations for iOS or watchOS. Not supported in iPadOS, macOS, tvOS, or visionOS._
+
+## [Resources](https://developer.apple.com/design/human-interface-guidelines/always-on#Resources)
+
+#### [Related](https://developer.apple.com/design/human-interface-guidelines/always-on#Related)
+
+[Designing for watchOS](https://developer.apple.com/design/human-interface-guidelines/designing-for-watchos)
+
+#### [Developer documentation](https://developer.apple.com/design/human-interface-guidelines/always-on#Developer-documentation)
+
+[Designing your app for the Always On state](https://developer.apple.com/documentation/watchOS-Apps/designing-your-app-for-the-always-on-state) — watchOS apps
+
+#### [Videos](https://developer.apple.com/design/human-interface-guidelines/always-on#Videos)
+
+[![](https://devimages-cdn.apple.com/wwdc-services/images/119/8D3FA0CE-F9A3-4CD8-82D2-375A2BA54AF1/4843_wide_250x141_1x.jpg) What's new in watchOS 8 ](https://developer.apple.com/videos/play/wwdc2021/10002)
+
+[![](https://devimages-cdn.apple.com/wwdc-services/images/119/30D3C2CB-B24D-467A-9B20-A369641E966F/4850_wide_250x141_1x.jpg) Build a workout app for Apple Watch ](https://developer.apple.com/videos/play/wwdc2021/10009)
+
+[![](https://devimages-cdn.apple.com/wwdc-services/images/119/934A2652-91C0-41AD-A35E-BC4E2ABC6F71/4884_wide_250x141_1x.jpg) What's new in SwiftUI ](https://developer.apple.com/videos/play/wwdc2021/10018)
+
+## [Change log](https://developer.apple.com/design/human-interface-guidelines/always-on#Change-log)
+
+Date| Changes  
+---|---  
+September 12, 2023| Updated intro image artwork.  
+September 23, 2022| Expanded guidance to cover the Always On display on iPhone 14 Pro and iPhone 14 Pro Max.  
+