Skip to main content
skill CX Codex

ios-26-platform — Claude Code skill: features and installation

The ios-26-platform skill guides iOS 26 feature work in SwiftUI and helps preserve support for iOS 17/18. Use it when updating an interface or handling backward compatibility.

MIT ★ 233 updated 2026-01-18

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering
Open on GitHub

What ios-26-platform does

The skill covers Liquid Glass, newer SwiftUI APIs such as WebView and Chart3D, and compatibility with iOS 17/18. It helps decide where glass effects belong, when to guard APIs by availability, and what to consider for animations and accessibility settings.

Its workflow and reference material cover Liquid Glass, automatic interface adoption, SwiftUI APIs, navigation, and backward compatibility. Liquid Glass requires an iOS 26+ deployment target. To keep iOS 17/18 support, guard newer APIs with if #available(iOS 26, *); without those checks, older versions can break.

The guidance also calls for testing effects on devices and checking Reduce Transparency, Increase Contrast, and Reduce Motion. It recommends reserving glass effects for navigation rather than content areas.

What it helps with

  • add Liquid Glass to navigation elements
  • choose between Regular and Clear variants
  • guard new SwiftUI APIs by OS availability
  • preserve iOS 17/18 support while adopting iOS 26 features
  • check animation behavior against accessibility settings

Example prompts for the agent

  • Add Liquid Glass to the tab bar and guard it for iOS 26 and later.
  • Use WebView and Chart3D while keeping the app compatible with iOS 17 and 18.
  • Review where the Clear variant fits and account for Reduce Motion in animations.

How to install ios-26-platform

1Plugin marketplace

/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering

This installs the whole swift-engineering plugin with all its skills

2Skills CLI (Vercel)

npx skills add johnrogers/claude-swift-engineering --skill ios-26-platform -a claude-code

3Manually: put the files in place

~/.claude/skills/ios-26-platform/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/ios-26-platform/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about ios-26-platform

How do I install ios-26-platform in Claude Code?

Add the marketplace with /plugin marketplace add johnrogers/claude-swift-engineering, then install the plugin with /plugin install swift-engineering@claude-swift-engineering.

What does ios-26-platform do?

It guides implementation of iOS 26 features such as Liquid Glass and newer SwiftUI APIs, while covering support for iOS 17/18.

How can I keep support for iOS 17 and 18?

Guard Liquid Glass and newer APIs with if #available(iOS 26, *). Skipping those checks can break support for older iOS versions.

Source text

SKILL.md · MIT
---
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](references/liquid-glass.md)** | Implementing glass effects, choosing Regular vs Clear variants, or understanding visual properties |
| **[Automatic Adoption](references/automatic-adoption.md)** | Understanding what iOS 26 changes automatically vs what requires code |
| **[SwiftUI APIs](references/swiftui-apis.md)** | Using WebView, Chart3D, `@Animatable`, AttributedString, or new view modifiers |
| **[Toolbar & Navigation](references/toolbar-navigation.md)** | Customizing toolbars with spacers, morphing, glass button styles, or search |
| **[Backward Compatibility](references/backward-compat.md)** | 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.

© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering

Similar skills

All skills for Mobile →

From the same set33

The whole set →
swiftui-advanced swiftui-advanced — a Claude Code skill providing advanced SwiftUI workflows for multi-gesture composition, layout adaptation, architecture choice, and profiling. CX Codex +1 ★ 233repo stars haptics Add tactile responses for confirmations, errors, and custom patterns in an iOS app. The skill helps choose between UIKit feedback generators and Core Haptics. CX Codex +1 ★ 233repo stars storekit Walks an agent through StoreKit 2 purchases: the .storekit config, a StoreManager, transaction verification and SwiftUI product views. CX Codex +1 ★ 233repo stars swift-code-reviewer swift-code-reviewer inspects Swift and iOS implementations for concurrency safety, HIG rules, TCA patterns, and security before testing. CX Codex ★ 233repo stars swiftui-specialist swiftui-specialist builds SwiftUI screens that follow Apple HIG once the core logic and TCA layer are already in place. CX Codex ★ 233repo stars swift-ui-design swift-ui-design inspects mockups, screenshots, or UI descriptions to plan SwiftUI views and architecture before implementation begins. CX Codex ★ 233repo stars foundation-models Gives Claude Code reference patterns for Apple's on-device Foundation Models framework: summarization, extraction, classification. Covers setting up a LanguageModelSession and typed output with @Generable. CX Codex +1 ★ 233repo stars tca-engineer tca-engineer writes the code for a TCA feature from a finished design: reducers, state, actions, dependency clients with test doubles. Views are out of scope. CX Codex ★ 233repo stars

Project sponsors

Companies that keep this analytics open