@ngxtm/devkit 3.14.0 → 3.16.0

package/skills/hig-platforms/references/designing-for-ios.md

@@ -0,0 +1,66 @@
+---
+title: "Designing for iOS | Apple Developer Documentation"
+source: https://developer.apple.com/design/human-interface-guidelines/designing-for-ios
+
+# Designing for iOS
+
+People depend on their iPhone to help them stay connected, play games, view media, accomplish tasks, and track personal data in any location and while on the go.
+
+![A stylized representation of an iPhone frame shown on top of a grid. The image is overlaid with rectangular and circular grid lines and is tinted green to subtly reflect the green in the original six-color Apple logo.](https://docs-assets.developer.apple.com/published/fcb6f603e6672e3443637efe652e5bdb/platforms-iOS-intro%402x.png)
+
+As you begin designing your app or game for iOS, start by understanding the following fundamental device characteristics and patterns that distinguish the iOS experience. Using these characteristics and patterns to inform your design decisions can help you provide an app or game that iPhone users appreciate.
+
+**Display.** iPhone has a medium-size, high-resolution display.
+
+**Ergonomics.** People generally hold their iPhone in one or both hands as they interact with it, switching between landscape and portrait orientations as needed. While people are interacting with the device, their viewing distance tends to be no more than a foot or two.
+
+**Inputs.** Multi-Touch [gestures](https://developer.apple.com/design/human-interface-guidelines/gestures), [virtual keyboards](https://developer.apple.com/design/human-interface-guidelines/virtual-keyboards), and [voice](https://developer.apple.com/design/human-interface-guidelines/siri) control let people perform actions and accomplish meaningful tasks while they’re on the go. In addition, people often want apps to use their [personal data](https://developer.apple.com/design/human-interface-guidelines/privacy) and input from the device’s [gyroscope and accelerometer](https://developer.apple.com/design/human-interface-guidelines/gyro-and-accelerometer), and they may also want to participate in [spatial interactions](https://developer.apple.com/design/human-interface-guidelines/spatial-interactions).
+
+**App interactions.** Sometimes, people spend just a minute or two checking on event or social media updates, tracking data, or sending messages. At other times, people can spend an hour or more browsing the web, playing games, or enjoying media. People typically have multiple apps open at the same time, and they appreciate switching frequently among them.
+
+**System features.** iOS provides several features that help people interact with the system and their apps in familiar, consistent ways.
+
+  * [Widgets](https://developer.apple.com/design/human-interface-guidelines/widgets)
+
+  * [Home Screen quick actions](https://developer.apple.com/design/human-interface-guidelines/home-screen-quick-actions)
+
+  * [Spotlight](https://developer.apple.com/design/human-interface-guidelines/searching)
+
+  * [Shortcuts](https://developer.apple.com/design/human-interface-guidelines/siri#Shortcuts-and-suggestions)
+
+  * [Activity views](https://developer.apple.com/design/human-interface-guidelines/activity-views)
+
+
+
+
+## [Best practices](https://developer.apple.com/design/human-interface-guidelines/designing-for-ios#Best-practices)
+
+Great iPhone experiences integrate the platform and device capabilities that people value most. To help your design feel at home in iOS, prioritize the following ways to incorporate these features and capabilities.
+
+  * Help people concentrate on primary tasks and content by limiting the number of onscreen controls while making secondary details and actions discoverable with minimal interaction.
+
+  * Adapt seamlessly to appearance changes — like device orientation, Dark Mode, and Dynamic Type — letting people choose the configurations that work best for them.
+
+  * Support interactions that accommodate the way people usually hold their device. For example, it tends to be easier and more comfortable for people to reach a control when it’s located in the middle or bottom area of the display, so it’s especially important let people swipe to navigate back or initiate actions in a list row.
+
+  * With people’s permission, integrate information available through platform capabilities in ways that enhance the experience without asking people to enter data. For example, you might accept payments, provide security through biometric authentication, or offer features that use the device’s location.
+
+
+
+
+## [Resources](https://developer.apple.com/design/human-interface-guidelines/designing-for-ios#Resources)
+
+#### [Related](https://developer.apple.com/design/human-interface-guidelines/designing-for-ios#Related)
+
+[Apple Design Resources](https://developer.apple.com/design/resources/#ios-apps)
+
+#### [Developer documentation](https://developer.apple.com/design/human-interface-guidelines/designing-for-ios#Developer-documentation)
+
+[iOS Pathway](https://developer.apple.com/ios/get-started/)
+
+#### [Videos](https://developer.apple.com/design/human-interface-guidelines/designing-for-ios#Videos)
+
+[![](https://devimages-cdn.apple.com/wwdc-services/images/3055294D-836B-4513-B7B0-0BC5666246B0/5CD0E251-424E-490F-89CF-1E64848209A6/9910_wide_250x141_1x.jpg) Meet Liquid Glass ](https://developer.apple.com/videos/play/wwdc2025/219)
+
+[![](https://devimages-cdn.apple.com/wwdc-services/images/3055294D-836B-4513-B7B0-0BC5666246B0/1AAA030E-2ECA-47D8-AE09-6D7B72A840F6/10044_wide_250x141_1x.jpg) Get to know the new design system ](https://developer.apple.com/videos/play/wwdc2025/356)
+

package/skills/hig-platforms/references/designing-for-ipados.md

@@ -0,0 +1,64 @@
+---
+title: "Designing for iPadOS | Apple Developer Documentation"
+source: https://developer.apple.com/design/human-interface-guidelines/designing-for-ipados
+
+# Designing for iPadOS
+
+People value the power, mobility, and flexibility of iPad as they enjoy media, play games, perform detailed productivity tasks, and bring their creations to life.
+
+![A stylized representation of an iPad frame shown on top of a grid. The image is overlaid with rectangular and circular grid lines and is tinted green to subtly reflect the green in the original six-color Apple logo.](https://docs-assets.developer.apple.com/published/9601c88115bc94c01906416dbb3b8be8/platforms-iPadOS-intro%402x.png)
+
+As you begin designing your app or game for iPad, start by understanding the following fundamental device characteristics and patterns that distinguish the iPadOS experience. Using these characteristics and patterns to inform your design decisions can help you provide an app or game that iPad users appreciate.
+
+**Display.** iPad has a large, high-resolution display.
+
+**Ergonomics.** People often hold their iPad while using it, but they might also set it on a surface or place it on a stand. Positioning the device in different ways can change the viewing distance, although people are typically within about 3 feet of the device as they interact with it.
+
+**Inputs.** People can interact with iPad using Multi-Touch [gestures](https://developer.apple.com/design/human-interface-guidelines/gestures) and [virtual keyboards](https://developer.apple.com/design/human-interface-guidelines/virtual-keyboards), an attached [keyboard](https://developer.apple.com/design/human-interface-guidelines/keyboards) or [pointing device](https://developer.apple.com/design/human-interface-guidelines/pointing-devices), [Apple Pencil](https://developer.apple.com/design/human-interface-guidelines/apple-pencil-and-scribble), or [voice](https://developer.apple.com/design/human-interface-guidelines/siri), and they often combine multiple input modes.
+
+**App interactions.** Sometimes, people perform a few quick actions on their iPad. At other times, they spend hours immersed in games, media, content creation, or productivity tasks. People frequently have multiple apps open at the same time, and they appreciate viewing more than one app onscreen at once and taking advantage of inter-app capabilities like drag and drop.
+
+**System features.** iPadOS provides several features that help people interact with the system and their apps in familiar, consistent ways.
+
+  * [Multitasking](https://developer.apple.com/design/human-interface-guidelines/multitasking)
+
+  * [Widgets](https://developer.apple.com/design/human-interface-guidelines/widgets)
+
+  * [Drag and drop](https://developer.apple.com/design/human-interface-guidelines/drag-and-drop)
+
+
+
+
+## [Best practices](https://developer.apple.com/design/human-interface-guidelines/designing-for-ipados#Best-practices)
+
+Great iPad experiences integrate the platform and device capabilities that people value most. To help your experience feel at home in iPadOS, prioritize the following ways to incorporate these features and capabilities.
+
+  * Take advantage of the large display to elevate the content people care about, minimizing modal interfaces and full-screen transitions, and positioning onscreen controls where they’re easy to reach, but not in the way.
+
+  * Use viewing distance and input mode to help you determine the size and density of the onscreen content you display.
+
+  * Let people use Multi-Touch gestures, a physical keyboard or trackpad, or Apple Pencil, and consider supporting unique interactions that combine multiple input modes.
+
+  * Adapt seamlessly to appearance changes — like device orientation, multitasking modes, Dark Mode, and Dynamic Type — and transition effortlessly to running in macOS, letting people choose the configurations that work best for them.
+
+
+
+
+## [Resources](https://developer.apple.com/design/human-interface-guidelines/designing-for-ipados#Resources)
+
+#### [Related](https://developer.apple.com/design/human-interface-guidelines/designing-for-ipados#Related)
+
+[Apple Design Resources](https://developer.apple.com/design/resources/#ios-apps)
+
+#### [Developer documentation](https://developer.apple.com/design/human-interface-guidelines/designing-for-ipados#Developer-documentation)
+
+[iPadOS Pathway](https://developer.apple.com/ipados/get-started/)
+
+#### [Videos](https://developer.apple.com/design/human-interface-guidelines/designing-for-ipados#Videos)
+
+[![](https://devimages-cdn.apple.com/wwdc-services/images/3055294D-836B-4513-B7B0-0BC5666246B0/873F40BE-101A-4C0D-99F0-F5C7CE7B47A3/10046_wide_250x141_1x.jpg) Elevate the design of your iPad app ](https://developer.apple.com/videos/play/wwdc2025/208)
+
+[![](https://devimages-cdn.apple.com/wwdc-services/images/3055294D-836B-4513-B7B0-0BC5666246B0/5CD0E251-424E-490F-89CF-1E64848209A6/9910_wide_250x141_1x.jpg) Meet Liquid Glass ](https://developer.apple.com/videos/play/wwdc2025/219)
+
+[![](https://devimages-cdn.apple.com/wwdc-services/images/3055294D-836B-4513-B7B0-0BC5666246B0/1AAA030E-2ECA-47D8-AE09-6D7B72A840F6/10044_wide_250x141_1x.jpg) Get to know the new design system ](https://developer.apple.com/videos/play/wwdc2025/356)
+

package/skills/hig-platforms/references/designing-for-macos.md

@@ -0,0 +1,70 @@
+---
+title: "Designing for macOS | Apple Developer Documentation"
+source: https://developer.apple.com/design/human-interface-guidelines/designing-for-macos
+
+# Designing for macOS
+
+People rely on the power, spaciousness, and flexibility of a Mac as they perform in-depth productivity tasks, view media or content, and play games, often using several apps at once.
+
+![A stylized representation of a Mac shown on top of a grid. The image is overlaid with rectangular and circular grid lines and is tinted green to subtly reflect the green in the original six-color Apple logo.](https://docs-assets.developer.apple.com/published/c553fef2b37b038dea23f7ef210433b9/platforms-macOS-intro%402x.png)
+
+As you begin designing your app or game for macOS, start by understanding the fundamental device characteristics and patterns that distinguish the macOS experience. Using these characteristics and patterns to inform your design decisions can help you provide an app or game that Mac users appreciate.
+
+**Display.** A Mac typically has a large, high-resolution display, and people can extend their workspace by connecting additional displays, including their iPad.
+
+**Ergonomics.** People generally use a Mac while they’re stationary, often placing the device on a desk or table. In the typical use case, the viewing distance can range from about 1 to 3 feet.
+
+**Inputs.** People expect to enter data and control the interface using any combination of input modes, such as physical [Keyboards](https://developer.apple.com/design/human-interface-guidelines/keyboards), [Pointing devices](https://developer.apple.com/design/human-interface-guidelines/pointing-devices), [Game controls](https://developer.apple.com/design/human-interface-guidelines/game-controls), and [Siri](https://developer.apple.com/design/human-interface-guidelines/siri).
+
+**App interactions.** Interactions can last anywhere from a few minutes of performing some quick tasks to several hours of deep concentration. People frequently have multiple apps open at the same time, and they expect smooth transitions between active and inactive states as they switch from one app to another.
+
+**System features.** macOS provides several features that help people interact with the system and their apps in familiar, consistent ways.
+
+  * [The menu bar](https://developer.apple.com/design/human-interface-guidelines/the-menu-bar)
+
+  * [File management](https://developer.apple.com/design/human-interface-guidelines/file-management)
+
+  * [Going full screen](https://developer.apple.com/design/human-interface-guidelines/going-full-screen)
+
+  * [Dock menus](https://developer.apple.com/design/human-interface-guidelines/dock-menus)
+
+
+
+
+## [Best practices](https://developer.apple.com/design/human-interface-guidelines/designing-for-macos#Best-practices)
+
+Great Mac experiences integrate the platform and device capabilities that people value most. To help your design feel at home in macOS, prioritize the following ways to incorporate these features and capabilities.
+
+  * Leverage large displays to present more content in fewer nested levels and with less need for modality, while maintaining a comfortable information density that doesn’t make people strain to view the content they want.
+
+  * Let people resize, hide, show, and move your windows to fit their work style and device configuration, and support full-screen mode to offer a distraction-free context.
+
+  * Use the menu bar to give people easy access to all the commands they need to do things in your app.
+
+  * Help people take advantage of high-precision input modes to perform pixel-perfect selections and edits.
+
+  * Handle keyboard shortcuts to help people accelerate actions and use keyboard-only work styles.
+
+  * Support personalization, letting people customize toolbars, configure windows to display the views they use most, and choose the colors and fonts they want to see in the interface.
+
+
+
+
+## [Resources](https://developer.apple.com/design/human-interface-guidelines/designing-for-macos#Resources)
+
+#### [Related](https://developer.apple.com/design/human-interface-guidelines/designing-for-macos#Related)
+
+[Apple Design Resources](https://developer.apple.com/design/resources/#macos-apps)
+
+#### [Developer documentation](https://developer.apple.com/design/human-interface-guidelines/designing-for-macos#Developer-documentation)
+
+[macOS Pathway](https://developer.apple.com/macos/get-started/)
+
+#### [Videos](https://developer.apple.com/design/human-interface-guidelines/designing-for-macos#Videos)
+
+[![](https://devimages-cdn.apple.com/wwdc-services/images/3055294D-836B-4513-B7B0-0BC5666246B0/5CD0E251-424E-490F-89CF-1E64848209A6/9910_wide_250x141_1x.jpg) Meet Liquid Glass ](https://developer.apple.com/videos/play/wwdc2025/219)
+
+[![](https://devimages-cdn.apple.com/wwdc-services/images/3055294D-836B-4513-B7B0-0BC5666246B0/1AAA030E-2ECA-47D8-AE09-6D7B72A840F6/10044_wide_250x141_1x.jpg) Get to know the new design system ](https://developer.apple.com/videos/play/wwdc2025/356)
+
+[![](https://devimages-cdn.apple.com/wwdc-services/images/3055294D-836B-4513-B7B0-0BC5666246B0/754D8BF7-206F-4342-8705-7B836D449D9C/10015_wide_250x141_1x.jpg) Build an AppKit app with the new design ](https://developer.apple.com/videos/play/wwdc2025/310)
+

package/skills/hig-platforms/references/designing-for-tvos.md

@@ -0,0 +1,68 @@
+---
+title: "Designing for tvOS | Apple Developer Documentation"
+source: https://developer.apple.com/design/human-interface-guidelines/designing-for-tvos
+
+# Designing for tvOS
+
+People enjoy the vibrant content, immersive experiences, and streamlined interactions that tvOS delivers in media and games, as well as in fitness, education, and home utility apps.
+
+![A stylized representation of a TV screen shown on top of a grid. The image is overlaid with rectangular and circular grid lines and is tinted green to subtly reflect the green in the original six-color Apple logo.](https://docs-assets.developer.apple.com/published/cd98e6ef7baa3ddd91de67f43a979c8e/platforms-tvOS-intro%402x.png)
+
+As you begin designing your app or game for tvOS, start by understanding the following fundamental device characteristics and patterns that distinguish the tvOS experience. Using these characteristics and patterns to inform your design decisions can help you provide an app or game that tvOS users appreciate.
+
+**Display.** A TV typically has a very large, high-resolution display.
+
+**Ergonomics.** Although people generally remain many feet away from their stationary TV — often 8 feet or more — they sometimes continue to interact with content as they move around the room.
+
+**Inputs.** People can use a [remote](https://developer.apple.com/design/human-interface-guidelines/remotes), a [game controller](https://developer.apple.com/design/human-interface-guidelines/game-controls), their [voice](https://developer.apple.com/design/human-interface-guidelines/siri), and apps running on their other devices to interact with Apple TV.
+
+**App interactions.** People can get deeply immersed in a single experience — often lasting hours — but they also appreciate using a picture-in-picture view to simultaneously follow an alternative app or video.
+
+**System features.** Apple TV users expect their apps and games to integrate well with the following system experiences.
+
+  * [Integrating with the TV app](https://developer.apple.com/design/human-interface-guidelines/playing-video#Integrating-with-the-TV-app)
+
+  * [SharePlay](https://developer.apple.com/design/human-interface-guidelines/shareplay)
+
+  * [Top Shelf](https://developer.apple.com/design/human-interface-guidelines/top-shelf)
+
+  * [TV provider accounts](https://developer.apple.com/design/human-interface-guidelines/managing-accounts#TV-provider-accounts)
+
+
+
+
+## [Best practices](https://developer.apple.com/design/human-interface-guidelines/designing-for-tvos#Best-practices)
+
+Great tvOS experiences integrate the platform and device capabilities that people value most. To help your experience feel at home in tvOS, prioritize the following ways to incorporate these features and capabilities.
+
+  * Support powerful, delightful interactions through the fluid, familiar gestures people make with the Siri Remote.
+
+  * Embrace the tvOS focus system, letting it gently highlight and expand onscreen items as people move among them, helping them know what to do and where they are at all times.
+
+  * Deliver beautiful, edge-to-edge artwork, subtle and fluid animations, and engaging audio, wrapping people in a rich, cinematic experience that’s clear, legible, and captivating from across the room.
+
+  * Enhance multiuser support by making sign-in easy and infrequent, handling shared sign-in, and automatically switching profiles when people change the current viewer.
+
+
+
+
+## [Resources](https://developer.apple.com/design/human-interface-guidelines/designing-for-tvos#Resources)
+
+#### [Related](https://developer.apple.com/design/human-interface-guidelines/designing-for-tvos#Related)
+
+[Apple Design Resources](https://developer.apple.com/design/resources/#tvos-apps)
+
+#### [Developer documentation](https://developer.apple.com/design/human-interface-guidelines/designing-for-tvos#Developer-documentation)
+
+[tvOS Pathway](https://developer.apple.com/tvos/get-started/)
+
+#### [Videos](https://developer.apple.com/design/human-interface-guidelines/designing-for-tvos#Videos)
+
+[![](https://devimages-cdn.apple.com/wwdc-services/images/49/B17CF999-313D-4C0D-A791-D2A5DD5F9242/3789_wide_250x141_1x.jpg) Build SwiftUI apps for tvOS ](https://developer.apple.com/videos/play/wwdc2020/10042)
+
+## [Change log](https://developer.apple.com/design/human-interface-guidelines/designing-for-tvos#Change-log)
+
+Date| Changes  
+---|---  
+September 14, 2022| Refined best practices for multiuser support.  
+  

package/skills/hig-platforms/references/designing-for-visionos.md

@@ -0,0 +1,85 @@
+---
+title: "Designing for visionOS | Apple Developer Documentation"
+source: https://developer.apple.com/design/human-interface-guidelines/designing-for-visionos
+
+# Designing for visionOS
+
+When people wear Apple Vision Pro, they enter an infinite 3D space where they can engage with your app or game while staying connected to their surroundings.
+
+![A stylized representation of Apple Vision Pro shown on top of a grid. The image is overlaid with rectangular and circular grid lines and is tinted green to subtly reflect the green in the original six-color Apple logo.](https://docs-assets.developer.apple.com/published/9d51f701c7321cced431aac9d5212b9e/platforms-visionOS-intro%402x.png)
+
+As you begin designing your app or game for visionOS, start by understanding the fundamental device characteristics and patterns that distinguish the platform. Use these characteristics and patterns to inform your design decisions and help you create immersive and engaging experiences.
+
+**Space.** Apple Vision Pro offers a limitless canvas where people can view virtual content like [windows](https://developer.apple.com/design/human-interface-guidelines/windows), [volumes](https://developer.apple.com/design/human-interface-guidelines/windows#visionOS-volumes), and 3D objects, and choose to enter deeply immersive experiences that can transport them to different places.
+
+**Immersion.** In a visionOS app, people can fluidly transition between different levels of [immersion](https://developer.apple.com/design/human-interface-guidelines/immersive-experiences). By default, an app launches in the _Shared Space_ where multiple apps can run side-by-side and people can open, close, and relocate windows. People can also choose to transition an app to a _Full Space_ , where it’s the only app running. While in a Full Space app, people can view 3D content blended with their surroundings, open a portal to view another place, or enter a different world.
+
+**Passthrough.** [Passthrough](https://developer.apple.com/design/human-interface-guidelines/immersive-experiences#Immersion-and-passthrough) provides live video from the device’s external cameras, and helps people interact with virtual content while also seeing their actual surroundings. When people want to see more or less of their surroundings, they use the [Digital Crown](https://developer.apple.com/design/human-interface-guidelines/digital-crown) to control the amount of passthrough.
+
+**Spatial Audio.** Apple Vision Pro combines acoustic and visual-sensing technologies to model the sonic characteristics of a person’s surroundings, automatically making audio sound natural in their space. When an app receives a person’s permission to access information about their surroundings, it can fine-tune [Spatial Audio](https://developer.apple.com/design/human-interface-guidelines/playing-audio#visionOS) to bring custom experiences to life.
+
+**Eyes and hands.** In general, people perform most actions by using their [eyes](https://developer.apple.com/design/human-interface-guidelines/eyes) to look at a virtual object and making an _indirect_ [gesture](https://developer.apple.com/design/human-interface-guidelines/gestures#visionOS), like a tap, to activate it. People can also interact with a virtual object by using a _direct_ gesture, like touching it with a finger.
+
+**Ergonomics.** While wearing Apple Vision Pro, people rely entirely on the device’s cameras for everything they see, both real and virtual, so maintaining visual comfort is paramount. The system helps maintain comfort by automatically placing content so it’s relative to the wearer’s head, regardless of the person’s height or whether they’re sitting, standing, or lying down. Because visionOS brings content to people — instead of making people move to reach the content — people can remain at rest while engaging with apps and games.
+
+**Accessibility.** Apple Vision Pro supports [accessibility](https://developer.apple.com/design/human-interface-guidelines/accessibility) technologies like VoiceOver, Switch Control, Dwell Control, Guided Access, Head Pointer, and many more, so people can use the interactions that work for them. In visionOS, as in all platforms, system-provided UI components build in accessibility support by default, while system frameworks give you ways to enhance the accessibility of your app or game.
+
+Important
+
+When building your app for Apple Vision Pro, be sure to consider the unique characteristics of the device and its spatial computing environment, and pay special attention to your user’s safety; for more details about these characteristics, see [Apple Vision Pro User Guide](https://support.apple.com/guide/apple-vision-pro). For example, Apple Vision Pro should not be used while operating a vehicle or heavy machinery. The device is also not designed to be used while moving around unsafe environments such as near balconies, streets, stairs, or other potential hazards. Note that Apple Vision Pro is designed to be fit and used only by individuals 13 years of age or older.
+
+## [Best practices](https://developer.apple.com/design/human-interface-guidelines/designing-for-visionos#Best-practices)
+
+Great visionOS apps and games are approachable and familiar, while offering extraordinary experiences that can surround people with beautiful content, expanded capabilities, and captivating adventures.
+
+**Embrace the unique features of Apple  Vision Pro.** Take advantage of space, Spatial Audio, and immersion to bring life to your experiences, while integrating passthrough and spatial input from eyes and hands in ways that feel at home on the device.
+
+**Consider different types of immersion as you design ways to present your app’s most distinctive moments.** You can present experiences in a windowed, UI-centric context, a fully immersive context, or something in between. For each key moment in your app, find the minimum level of immersion that suits it best — don’t assume that every moment needs to be fully immersive.
+
+**Use windows for contained, UI-centric experiences.** To help people perform standard tasks, prefer standard [windows](https://developer.apple.com/design/human-interface-guidelines/windows#visionOS) that appear as planes in space and contain familiar controls. In visionOS, people can relocate windows anywhere they want, and the system’s [dynamic scaling](https://developer.apple.com/design/human-interface-guidelines/spatial-layout#Scale) helps keep window content legible whether it’s near or far.
+
+**Prioritize comfort.** To help people stay comfortable and physically relaxed as they interact with your app or game, keep the following fundamentals in mind.
+
+  * Display content within a person’s [field of view](https://developer.apple.com/design/human-interface-guidelines/spatial-layout#Field-of-view), positioning it relative to their head. Avoid placing content in places where people have to turn their head or change their position to interact with it.
+
+  * Avoid displaying [motion](https://developer.apple.com/design/human-interface-guidelines/motion#visionOS) that’s overwhelming, jarring, too fast, or missing a stationary frame of reference.
+
+  * Support [indirect gestures](https://developer.apple.com/design/human-interface-guidelines/gestures#visionOS) that let people interact with apps while their hands rest in their lap or at their sides.
+
+  * If you support direct gestures, make sure the interactive content isn’t too far away and that people don’t need to interact with it for extended periods.
+
+  * Avoid encouraging people to move too much while they’re in a fully [immersive experience](https://developer.apple.com/design/human-interface-guidelines/immersive-experiences).
+
+
+
+
+**Help people share activities with others.** When you use [SharePlay](https://developer.apple.com/design/human-interface-guidelines/shareplay#visionOS) to support shared activities, people can view the _spatial Personas_ of other participants, making it feel like everyone is together in the same space.
+
+## [Resources](https://developer.apple.com/design/human-interface-guidelines/designing-for-visionos#Resources)
+
+#### [Related](https://developer.apple.com/design/human-interface-guidelines/designing-for-visionos#Related)
+
+[Apple Design Resources](https://developer.apple.com/design/resources/#visionos-apps)
+
+#### [Developer documentation](https://developer.apple.com/design/human-interface-guidelines/designing-for-visionos#Developer-documentation)
+
+[visionOS Pathway](https://developer.apple.com/visionos/get-started/)
+
+[Creating your first visionOS app](https://developer.apple.com/documentation/visionOS/creating-your-first-visionos-app)
+
+#### [Videos](https://developer.apple.com/design/human-interface-guidelines/designing-for-visionos#Videos)
+
+[![](https://devimages-cdn.apple.com/wwdc-services/images/C03E6E6D-A32A-41D0-9E50-C3C6059820AA/B2E0763D-C5D2-4191-AC0B-F99D56BE781F/9208_wide_250x141_1x.jpg) Design interactive experiences for visionOS ](https://developer.apple.com/videos/play/wwdc2024/10096)
+
+[![](https://devimages-cdn.apple.com/wwdc-services/images/C03E6E6D-A32A-41D0-9E50-C3C6059820AA/A207EE2A-D9E6-4FAB-A557-ABEAA68840AB/9197_wide_250x141_1x.jpg) Design great visionOS apps ](https://developer.apple.com/videos/play/wwdc2024/10086)
+
+[![](https://devimages-cdn.apple.com/wwdc-services/images/D35E0E85-CCB6-41A1-B227-7995ECD83ED5/15489B11-8744-483D-AD38-EF78D8962FF4/8126_wide_250x141_1x.jpg) Principles of spatial design ](https://developer.apple.com/videos/play/wwdc2023/10072)
+
+## [Change log](https://developer.apple.com/design/human-interface-guidelines/designing-for-visionos#Change-log)
+
+Date| Changes  
+---|---  
+February 2, 2024| Included a link to Apple Vision Pro User Guide.  
+September 12, 2023| Updated intro artwork.  
+June 21, 2023| New page.  
+  

package/skills/hig-platforms/references/designing-for-watchos.md

@@ -0,0 +1,74 @@
+---
+title: "Designing for watchOS | Apple Developer Documentation"
+source: https://developer.apple.com/design/human-interface-guidelines/designing-for-watchos
+
+# Designing for watchOS
+
+When people glance at their Apple Watch, they know they can access essential information and perform simple, timely tasks whether they’re stationary or in motion.
+
+![A stylized representation of an Apple Watch frame shown on top of a grid. The image is overlaid with rectangular and circular grid lines and is tinted green to subtly reflect the green in the original six-color Apple logo.](https://docs-assets.developer.apple.com/published/4fb079e34e794b1a6b9fc03acf2c22a4/platforms-watchOS-intro%402x.png)
+
+As you begin designing your app for Apple Watch, start by understanding the following fundamental device characteristics and patterns that distinguish the watchOS experience. Using these characteristics and patterns to inform your design decisions can help you provide an app that Apple Watch users appreciate.
+
+**Display.** The small Apple Watch display fits on the wrist while delivering an easy-to-read, high-resolution experience.
+
+**Ergonomics.** Because people wear Apple Watch, they’re usually no more than a foot away from the display as they raise their wrist to view it and use their opposite hand to interact with the device. In addition, the Always On display lets people view information on the watch face when they drop their wrist.
+
+**Inputs.** People can navigate vertically or inspect data by turning the [Digital Crown](https://developer.apple.com/design/human-interface-guidelines/digital-crown), which offers consistent control on the watch face, the Home Screen, and within apps. They can provide input even while they’re in motion with standard [gestures](https://developer.apple.com/design/human-interface-guidelines/gestures) like tap, swipe, and drag. Pressing the [Action button](https://developer.apple.com/design/human-interface-guidelines/action-button) initiates an essential action without looking at the screen, and using [shortcuts](https://developer.apple.com/design/human-interface-guidelines/siri#Shortcuts-and-suggestions) helps people perform their routine tasks quickly and easily. People can also take advantage of data that device features provide, such as GPS, sensors for blood oxygen and heart function, and the altimeter, accelerometer, and gyroscope.
+
+**App interactions.** People glance at the Always On display many times throughout the day, performing concise app interactions that can last for less than a minute each. People frequently use a watchOS app’s related experiences — like complications, notifications, and Siri interactions — more than they use the app itself.
+
+**System features.** watchOS provides several features that help people interact with the system and their apps in familiar, consistent ways.
+
+  * [Complications](https://developer.apple.com/design/human-interface-guidelines/complications)
+
+  * [Notifications](https://developer.apple.com/design/human-interface-guidelines/notifications)
+
+  * [Always On](https://developer.apple.com/design/human-interface-guidelines/always-on)
+
+  * [Watch faces](https://developer.apple.com/design/human-interface-guidelines/watch-faces)
+
+
+
+
+## [Best practices](https://developer.apple.com/design/human-interface-guidelines/designing-for-watchos#Best-practices)
+
+Great Apple Watch experiences are streamlined and specialized, and integrate the platform and device capabilities that people value most. To help your experience feel at home in watchOS, prioritize the following ways to incorporate these features and capabilities.
+
+  * Support quick, glanceable, single-screen interactions that deliver critical information succinctly and help people perform targeted actions with a simple gesture or two.
+
+  * Minimize the depth of hierarchy in your app’s navigation, and use the [Digital Crown](https://developer.apple.com/design/human-interface-guidelines/digital-crown) to provide vertical navigation for scrolling or switching between screens.
+
+  * Personalize the experience by proactively anticipating people’s needs and using on-device data to provide actionable content that’s relevant in the moment or very soon.
+
+  * Use [complications](https://developer.apple.com/design/human-interface-guidelines/complications) to provide relevant, potentially dynamic data and graphics right on the watch face where people can view them on every wrist raise and tap them to dive straight into your app.
+
+  * Use [notifications](https://developer.apple.com/design/human-interface-guidelines/notifications) to deliver timely, high-value information and let people perform important actions without opening your app.
+
+  * Use background content such as [color](https://developer.apple.com/design/human-interface-guidelines/color) to convey useful supporting information, and use [materials](https://developer.apple.com/design/human-interface-guidelines/materials) to illustrate hierarchy and a sense of place.
+
+  * Design your app to function independently, complementing your notifications and complications by providing additional details and functionality.
+
+
+
+
+## [Resources](https://developer.apple.com/design/human-interface-guidelines/designing-for-watchos#Resources)
+
+#### [Related](https://developer.apple.com/design/human-interface-guidelines/designing-for-watchos#Related)
+
+[Apple Design Resources](https://developer.apple.com/design/resources/#watchos-apps)
+
+#### [Developer documentation](https://developer.apple.com/design/human-interface-guidelines/designing-for-watchos#Developer-documentation)
+
+[watchOS Pathway](https://developer.apple.com/watchos/get-started/)
+
+#### [Videos](https://developer.apple.com/design/human-interface-guidelines/designing-for-watchos#Videos)
+
+[![](https://devimages-cdn.apple.com/wwdc-services/images/3055294D-836B-4513-B7B0-0BC5666246B0/29B2363D-8DFB-4A25-A3DB-A804582858FD/9956_wide_250x141_1x.jpg) What’s new in watchOS 26 ](https://developer.apple.com/videos/play/wwdc2025/334)
+
+## [Change log](https://developer.apple.com/design/human-interface-guidelines/designing-for-watchos#Change-log)
+
+Date| Changes  
+---|---  
+June 5, 2023| Enhanced guidance for providing a glanceable, focused app experience, and emphasized the importance of the Digital Crown in navigation.  
+  

package/skills/hig-project-context/SKILL.md

@@ -0,0 +1,138 @@
+---
+name: hig-project-context
+version: 1.0.0
+description: ">-"
+  Create or update a shared Apple design context document that other HIG skills
+  use to tailor guidance. Use when the user says "set up my project context,"
+  "what platforms am I targeting," "configure HIG settings," or when starting a
+  new Apple platform project. Also activates when other HIG skills need project
+  context but none exists yet. This skill creates .claude/apple-design-context.md
+  so that hig-foundations, hig-platforms, hig-components-*, hig-inputs, and
+  hig-technologies can provide targeted advice without repetitive questions.
+risk: unknown
+source: community
+---
+
+# Apple HIG: Project Context
+
+Create and maintain `.claude/apple-design-context.md` so other HIG skills can skip redundant questions.
+
+Check for `.claude/apple-design-context.md` before asking questions. Use existing context and only ask for information not already covered.
+
+## Gathering Context
+
+Before asking questions, auto-discover context from:
+
+1. **README.md** -- Product description, platform targets
+2. **Package.swift / .xcodeproj** -- Supported platforms, minimum OS versions, dependencies
+3. **Info.plist** -- App category, required capabilities, supported orientations
+4. **Existing code** -- Import statements reveal frameworks (SwiftUI vs UIKit, HealthKit, etc.)
+5. **Assets.xcassets** -- Color assets, icon sets, dark mode variants
+6. **Accessibility audit** -- Grep for accessibility modifiers/attributes
+
+Present findings and ask the user to confirm or correct. Then gather anything still missing:
+
+### 1. Product Overview
+- What does the app do? (one sentence)
+- Category (productivity, social, health, game, utility, etc.)
+- Stage (concept, development, shipped, redesign)
+
+### 2. Target Platforms
+- Which Apple platforms? (iOS, iPadOS, macOS, tvOS, watchOS, visionOS)
+- Minimum OS versions
+- Universal or platform-specific?
+
+### 3. Technology Stack
+- UI framework: SwiftUI, UIKit, AppKit, or mixed?
+- Architecture: single-window, multi-window, document-based?
+- Apple technologies in use? (HealthKit, CloudKit, ARKit, etc.)
+
+### 4. Design System
+- System defaults or custom design system?
+- Brand colors, fonts, icon style?
+- Dark mode and Dynamic Type support status
+
+### 5. Accessibility Requirements
+- Target level (baseline, enhanced, comprehensive)
+- Specific considerations (VoiceOver, Switch Control, etc.)
+- Regulatory requirements (WCAG, Section 508)
+
+### 6. User Context
+- Primary personas (1-3)
+- Key use cases and environments (desk, on-the-go, glanceable, immersive)
+- Known pain points or design challenges
+
+### 7. Existing Design Assets
+- Figma/Sketch files?
+- Apple Design Resources in use?
+- Existing component library?
+
+## Context Document Template
+
+Generate `.claude/apple-design-context.md` using this structure:
+
+```markdown
+# Apple Design Context
+
+## Product
+- **Name**: [App name]
+- **Description**: [One sentence]
+- **Category**: [Category]
+- **Stage**: [Concept / Development / Shipped / Redesign]
+
+## Platforms
+| Platform | Supported | Min OS | Notes |
+|----------|-----------|--------|-------|
+| iOS      | Yes/No    |        |       |
+| iPadOS   | Yes/No    |        |       |
+| macOS    | Yes/No    |        |       |
+| tvOS     | Yes/No    |        |       |
+| watchOS  | Yes/No    |        |       |
+| visionOS | Yes/No    |        |       |
+
+## Technology
+- **UI Framework**: [SwiftUI / UIKit / AppKit / Mixed]
+- **Architecture**: [Single-window / Multi-window / Document-based]
+- **Apple Technologies**: [List any: HealthKit, CloudKit, ARKit, etc.]
+
+## Design System
+- **Base**: [System defaults / Custom design system]
+- **Brand Colors**: [List or reference]
+- **Typography**: [System fonts / Custom fonts]
+- **Dark Mode**: [Supported / Not yet / N/A]
+- **Dynamic Type**: [Supported / Not yet / N/A]
+
+## Accessibility
+- **Target Level**: [Baseline / Enhanced / Comprehensive]
+- **Key Considerations**: [List any specific needs]
+
+## Users
+- **Primary Persona**: [Description]
+- **Key Use Cases**: [List]
+- **Known Challenges**: [List]
+```
+
+## Updating Context
+
+When updating an existing context document:
+
+1. Read the current `.claude/apple-design-context.md`
+2. Ask what has changed
+3. Update only the changed sections
+4. Preserve all unchanged information
+
+## Related Skills
+
+- **hig-platforms** -- Platform-specific guidance
+- **hig-foundations** -- Color, typography, layout decisions
+- **hig-patterns** -- UX pattern recommendations
+- **hig-components-*** -- Component recommendations
+- **hig-inputs** -- Input method coverage
+- **hig-technologies** -- Apple technology relevance
+
+---
+
+*Built by [Raintree Technology](https://raintree.technology) · [More developer tools](https://raintree.technology)*
+
+## When to Use
+This skill is applicable to execute the workflow or actions described in the overview.