Agent-Skills.md

Agent Skills: iOS 26 Platform

Use when implementing iOS 26 features (Liquid Glass, new SwiftUI APIs, WebView, Chart3D), deploying iOS 26+ apps, or supporting backward compatibility with iOS 17/18.

UncategorizedID: johnrogers/claude-swift-engineering/ios-26-platform

Repository

johnrogers/claude-swift-engineering
johnrogersLicense: MIT
17913

Install this agent skill to your local

pnpm dlx add-skill https://github.com/johnrogers/claude-swift-engineering/tree/HEAD/plugins/swift-engineering/skills/ios-26-platform

Skill Files

Browse the full folder contents for ios-26-platform.

Download Skill

Loading file tree…

plugins/swift-engineering/skills/ios-26-platform/SKILL.md

Skill Metadata

Name
ios-26-platform
Description
Use when implementing iOS 26 features (Liquid Glass, new SwiftUI APIs, WebView, Chart3D), deploying iOS 26+ apps, or supporting backward compatibility with iOS 17/18.

iOS 26 Platform

iOS 26 introduces Liquid Glass, Apple's next-generation material design system that dynamically bends light, moves organically, and adapts automatically across all platforms.

Overview

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.

Reference Loading Guide

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.

| Reference | Load When | |-----------|-----------| | Liquid Glass | Implementing glass effects, choosing Regular vs Clear variants, or understanding visual properties | | Automatic Adoption | Understanding what iOS 26 changes automatically vs what requires code | | SwiftUI APIs | Using WebView, Chart3D, @Animatable, AttributedString, or new view modifiers | | Toolbar & Navigation | Customizing toolbars with spacers, morphing, glass button styles, or search | | Backward Compatibility | Supporting iOS 17/18 alongside iOS 26, or using UIDesignRequiresCompatibility |

Core Workflow

  1. Check deployment target — iOS 26+ required for Liquid Glass
  2. Recompile with Xcode 26 — Standard controls get glass automatically
  3. Identify navigation layer — Apply glass to tab bars, toolbars, navigation (not content)
  4. Choose variant — Regular (95% of cases) or Clear (media-rich backgrounds only)
  5. Add @available guards — For backward compatibility with iOS 17/18
  6. Test accessibility — Verify Reduce Transparency, Increase Contrast, Reduce Motion

Common Mistakes

  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.

  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.

  3. Animation performance issues — Liquid Glass animations can be expensive. Respect Reduce Motion accessibility setting and profile with Instruments 26 before shipping.

  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.

  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.

  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.