visionos-widgets
Master visionOS widget development with patterns for elevated and recessed mounting, material textures, and distance-aware layouts. Learn spatial widget families, container backgrounds, and rendering modes to create immersive widgets that adapt to user proximity and physical space.
visionOS Widgets helps you build spatial widgets with mounting styles, textures, and proximity-aware layouts for visionOS.
AI-generated summary based on this skill's SKILL.md
Install
rshankras/claude-code-apple-skills/widgets · repository language: Swift
git clone https://github.com/rshankras/claude-code-apple-skills
cp -r claude-code-apple-skills/skills/visionos/widgets ~/.claude/skills/widgetsFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How to create widgets for visionOS?
visionos-widgets helps you build spatial widgets by providing patterns for mounting styles, textures, and layouts. Start by defining your widget using WidgetKit with visionOS-specific families like systemExtraLargePortrait. Apply mounting styles (elevated or recessed) to control how your widget sits in space, then add material textures like glass or paper. Use the skill's templates to handle container backgrounds and rendering modes for immersive presentation.
What mounting styles and textures does visionos-widgets support?
visionos-widgets supports elevated and recessed mounting styles to position widgets in 3D space, plus glass and paper texture options for material appearance. Elevated mounts float above surfaces, while recessed mounts sit inset. Glass textures create transparent, reflective surfaces; paper textures offer matte, physical-like finishes. Combine these with container background rendering modes to achieve the visual depth and tactile quality your spatial design requires.
How do I implement proximity-aware layouts in visionOS widgets?
visionos-widgets enables proximity awareness by adjusting detail levels based on user distance. Use levelOfDetail parameters to simplify or enhance content as viewers move closer or farther away. Implement distance-aware layout logic that responds to spatial context, reducing visual complexity at distance and revealing detail up close. This creates adaptive, accessible widgets that optimize information density for viewing distance and accessibility needs.
Can I port an existing iOS widget to visionOS using this skill?
Yes, visionos-widgets provides patterns for porting iOS and iPadOS widgets to visionOS. Adapt your existing WidgetKit code by applying visionOS spatial families, mounting styles, and texture support. Handle rendering mode differences (accented mode, frame tinting) and test with visionOS-specific preview configurations. The skill guides you through container background handling and spatial layout adjustments needed for immersive presentation.
How do I debug widget rendering issues in accented mode?
visionos-widgets addresses accented rendering mode and frame tinting challenges. Check your container background rendering configuration and verify color values work in accented contexts. Use visionOS preview tools with systemExtraLargePortrait and other spatial families to test rendering. Inspect frame tinting application and ensure textures (glass/paper) display correctly. The skill provides debugging patterns for resolving visual inconsistencies across rendering modes.
What are visionOS spatial widget families and how do I use them?
visionos-widgets covers spatial widget families like systemExtraLargePortrait designed for visionOS's 3D environment. These families define layout constraints and aspect ratios optimized for spatial rendering. Choose families based on your content needs, then apply mounting styles and textures. Handle resizing (75–125 percent) and level-of-detail adjustments within each family. The skill provides best practices for avoiding common mistakes and maximizing immersion in spatial contexts.
SKILL.md
rendered from the published skill — quoted content, verbatim
visionOS Widgets
Patterns for building widgets that live in physical space on visionOS. Covers mounting styles, textures, proximity-aware detail levels, spatial widget families, and rendering modes.
When This Skill Activates
Use this skill when the user:
- Asks to create or adapt a widget for visionOS
- Mentions mounting styles (elevated, recessed)
- Wants glass or paper texture on a widget
- Asks about proximity awareness or level of detail in widgets
- Mentions spatial widget families or .systemExtraLargePortrait
- Wants to control container backgrounds or rendering modes (full color vs accented)
- Is porting an existing iOS/iPadOS widget to visionOS
Decision Tree
``` What do you need for your visionOS widget? | +- Where should the widget appear? | +- On a surface (table, shelf) -> .elevated
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
skills/visionos/widgets/SKILL.md