CamilleScholtz/swmpc / .agents/skills/swiftui-specialist
swiftui-specialist
VerifiedAuthoritative SwiftUI best practices from Apple: @Observable data flow, identity in ForEach/List, animations, environment values, and performance.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.0 KB |
| references/animations.md | markdown | 2.7 KB |
| references/dataflow.md | markdown | 32.2 KB |
| references/environment.md | markdown | 39.1 KB |
| references/foreach.md | markdown | 21.8 KB |
| references/localization.md | markdown | 11.3 KB |
| references/modifiers.md | markdown | 4.4 KB |
| references/soft-deprecated-apis.md | markdown | 32.6 KB |
| references/soft-deprecation.md | markdown | 4.3 KB |
| references/structure.md | markdown | 11.4 KB |
references/animations.md
View on GitHub# @Animatable macro
To make the properties of a custom `View` or `Shape` participate in SwiftUI animations, conform such a type to the `Animatable` protocol. Use the `@Animatable` macro to avoid writing out the protocol requirement `animatableData`:
```swift
@Animatable
struct CoolShape: Shape {
var width: CGFloat
var angle: Angle
// ...
}
```
If the property cannot participate in `animatableData`, the `@Animatable` macro will emit an error suggesting marking the property with `@AnimatableIgnored` or conform it to either the `VectorArithmetic` or `Animatable` protocol:
```swift
@Animatable
struct CoolShape: Shape {
var width: CGFloat
var angle: Angle
var isOpaque: Bool // ❌ Cannot automatically synthesize 'animatableData'.
// Mark this property with '@AnimatableIgnored'.
// Conform the type of this property to 'Animatable' or 'VectorArithmetic'.
}
```
If changes to this property need to be animated, conform its type to either `Animatable` or `VectorArithmetic` protocols. Otherwise, opt-out the property from `animatableData` using `@AnimatableIgnored` macro:
```swift
@Animatable
struct CoolShape: Shape {
var width: CGFloat
var angle: Angle
@AnimatableIgnored var isOpaque: Bool // opt-out the Bool property from 'animatableData'
}
```
# When to implement `animatableData`
Reach for an explicit `animatableData` when the interpolated value needs custom logic that doesn't correspond 1:1 to a stored property, like normalization, clamping, or driving a derived value.
For deployment target >= 26.0, use `AnimatableValues`:
```swift
// A wave shape whose `phase` needs to stay in 0..<2π during animation so
// long-running animations don't accumulate unbounded values, and whose
// `amplitude` must be clamped to `maxAmplitude` on every tick.
struct WaveShape: Shape {
var amplitude: CGFloat
var phase: CGFloat
var maxAmplitude: CGFloat
var animatableData: AnimatableValues<CGFloat, CGFloat> {
get { AnimatableValues(amplitude, phase) }
set {
amplitude = min(max(newValue.value.0, 0), maxAmplitude)
phase = newValue.value.1.truncatingRemainder(dividingBy: 2 * .pi)
}
}
// ...
}
```
For earlier deployment targets, use `AnimatablePair`:
```swift
struct WaveShape: Shape {
var amplitude: CGFloat
var phase: CGFloat
var maxAmplitude: CGFloat
var animatableData: AnimatablePair<CGFloat, CGFloat> {
get { AnimatablePair(amplitude, phase) }
set {
amplitude = min(max(newValue.first, 0), maxAmplitude)
phase = newValue.second.truncatingRemainder(dividingBy: 2 * .pi)
}
}
// ...
}
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |