$npx -y skills add johnrogers/claude-swift-engineering --skill ios-26-platformUse when implementing iOS 26 features (Liquid Glass, new SwiftUI APIs, WebView, Chart3D), deploying iOS 26+ apps, or supporting backward compatibility with iOS 17/18.
| 1 | # iOS 26 Platform |
| 2 | |
| 3 | iOS 26 introduces Liquid Glass, Apple's next-generation material design system that dynamically bends light, moves organically, and adapts automatically across all platforms. |
| 4 | |
| 5 | ## Overview |
| 6 | |
| 7 | iOS 26 modernizes UI with new materials (Liquid Glass), SwiftUI APIs (WebView, Chart3D, @Animatable), and advanced features (@BackoffAnimation, free-form windows). The core principle: modern UI gets updated automatically at compile time; most Liquid Glass benefits are "free" from recompiling with Xcode 26. |
| 8 | |
| 9 | ## Reference Loading Guide |
| 10 | |
| 11 | **ALWAYS load reference files if there is even a small chance the content may be required.** It's better to have the context than to miss a pattern or make a mistake. |
| 12 | |
| 13 | | Reference | Load When | |
| 14 | |-----------|-----------| |
| 15 | | **[Liquid Glass](references/liquid-glass.md)** | Implementing glass effects, choosing Regular vs Clear variants, or understanding visual properties | |
| 16 | | **[Automatic Adoption](references/automatic-adoption.md)** | Understanding what iOS 26 changes automatically vs what requires code | |
| 17 | | **[SwiftUI APIs](references/swiftui-apis.md)** | Using WebView, Chart3D, `@Animatable`, AttributedString, or new view modifiers | |
| 18 | | **[Toolbar & Navigation](references/toolbar-navigation.md)** | Customizing toolbars with spacers, morphing, glass button styles, or search | |
| 19 | | **[Backward Compatibility](references/backward-compat.md)** | Supporting iOS 17/18 alongside iOS 26, or using UIDesignRequiresCompatibility | |
| 20 | |
| 21 | ## Core Workflow |
| 22 | |
| 23 | 1. **Check deployment target** — iOS 26+ required for Liquid Glass |
| 24 | 2. **Recompile with Xcode 26** — Standard controls get glass automatically |
| 25 | 3. **Identify navigation layer** — Apply glass to tab bars, toolbars, navigation (not content) |
| 26 | 4. **Choose variant** — Regular (95% of cases) or Clear (media-rich backgrounds only) |
| 27 | 5. **Add @available guards** — For backward compatibility with iOS 17/18 |
| 28 | 6. **Test accessibility** — Verify Reduce Transparency, Increase Contrast, Reduce Motion |
| 29 | |
| 30 | ## Common Mistakes |
| 31 | |
| 32 | 1. **Ignoring backward compatibility** — Targeting iOS 26+ without `@available` guards breaks iOS 17/18 support. Always use `if #available(iOS 26, *)` for Liquid Glass or new APIs. |
| 33 | |
| 34 | 2. **Over-using glass effect** — Applying glass to content areas, not just navigation, creates visual noise. Glass works for: tab bars, toolbars, sheets, navigation. NOT for content areas. |
| 35 | |
| 36 | 3. **Animation performance issues** — Liquid Glass animations can be expensive. Respect Reduce Motion accessibility setting and profile with Instruments 26 before shipping. |
| 37 | |
| 38 | 4. **Assuming Clear variant looks good** — Clear is for media-rich backgrounds only (photos, video). Regular variant is correct 95% of the time. Only use Clear if you explicitly need the ultra-transparency. |
| 39 | |
| 40 | 5. **Not testing on actual devices** — Simulator rendering differs from hardware. Test glass effects on iPhone 15 Pro, iPad, and Mac to verify visual quality. |
| 41 | |
| 42 | 6. **Using old UIView patterns with new glass** — Mixing UIView-based navigation with iOS 26 glass creates inconsistent appearances. Migrate fully to SwiftUI or wrap carefully with UIViewRepresentable. |