# swiftui-whats-new-27

A reference skill covering SwiftUI API updates across 2027 Apple platforms. It prevents build failures when @State transitions to a macro and guides migration.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 737 installs · ★ 352
- Author: superagents-lab
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/superagents-lab/xcode27-skills/tree/HEAD/swiftui-whats-new-27/SKILL.md
- Updated: 2026-06-09
- HTML: https://affpapa.org/en/nevibecode/skills/swiftui-whats-new-27

## What it does

This reference guide details framework modifications across the 2027 operating systems from Apple. When developers update their toolchains, coding models frequently select outdated parameter signatures from memory. The documentation directs the assistant to verified function signatures instead of speculative guesses.

Inside, separate guides describe container sorting with `reorderable()`, swipe gestures in scroll views via `swipeActionsContainer()`, and caching setups for `AsyncImage`. It also details `ReadableDocument` and `WritableDocument` implementations, which replace older document protocols.

Reordering stored property assignments inside an init method will cause bad runtime behavior. The guide forbids that shortcut and provides the correct migration path. tvOS 27 lacks support for container reordering and custom swipe areas.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add superagents-lab/xcode27-skills --skill swiftui-whats-new-27 -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/swiftui-whats-new-27/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/swiftui-whats-new-27/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add superagents-lab/xcode27-skills --skill swiftui-whats-new-27 -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/swiftui-whats-new-27/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add superagents-lab/xcode27-skills --skill swiftui-whats-new-27 -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/swiftui-whats-new-27/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install superagents-lab/xcode27-skills swiftui-whats-new-27
```

2. **Manually: put the files in place**
- File: `.github/skills/swiftui-whats-new-27/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add superagents-lab/xcode27-skills --skill swiftui-whats-new-27 -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/superagents-lab/xcode27-skills --path swiftui-whats-new-27
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/swiftui-whats-new-27/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add superagents-lab/xcode27-skills --skill swiftui-whats-new-27 -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/superagents-lab/xcode27-skills/tree/HEAD/swiftui-whats-new-27/SKILL.md

## When to use it
- resolve build failures caused by the @State macro migration
- implement drag reordering on stacks or custom layouts
- enable swipe interactions inside generic scroll views
- assign custom network caching rules to AsyncImage requests
- migrate document workflows to the ReadableDocument protocol

## Example prompts
- Help fix our view initialization after upgrading to the SDK 27 macro version of @State.
- How do I configure swipe interaction inside a ScrollView on iOS 27?
- Set up an AsyncImage instance with custom URLRequest caching options.

## Similar
- [swiftui-design-skill](https://affpapa.org/en/nevibecode/skills/swiftui-design-skill.md) — skill · 1000 installs
- [swiftui-patterns](https://affpapa.org/en/nevibecode/skills/affaan-m-swiftui-patterns.md) — skill · 4600 installs
- [axiom-swiftui](https://affpapa.org/en/nevibecode/skills/axiom-swiftui.md) — skill · 1500 installs
- [swiftui-animation](https://affpapa.org/en/nevibecode/skills/jamesrochabrun-swiftui-animation.md) — skill · 567 installs
- [swiftui-navigation](https://affpapa.org/en/nevibecode/skills/swiftui-navigation.md) — skill · 4400 installs
- [swiftui-uikit-interop](https://affpapa.org/en/nevibecode/skills/swiftui-uikit-interop.md) — skill · 4100 installs

From the same set: [superagents-lab/xcode27-skills](https://affpapa.org/en/nevibecode/by/superagents-lab/xcode27-skills.md) — 7 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md