SwiftUI animation patterns including springs, transitions, PhaseAnimator, KeyframeAnimator, SF Symbol effects, scroll-driven effects, mesh gradients, text renderers, and shader effects. Use when implementing, reviewing, or fixing animation or visual-effect code on iOS/macOS.
The English summary is being prepared. Showing the original description.
Run score Not tested
See how to installReview the instructions the agent will receive before you install.
Correct API shapes and patterns for SwiftUI animations. Prevents the most common mistakes: mixed spring parameter generations, wrong PhaseAnimator/KeyframeAnimator closure signatures, and using matchedGeometryEffect where matchedTransitionSource is needed.
Use this skill when the user:
scrollTransition, visualEffect)colorEffect, distortionEffect, layerEffect)Choose the right reference file based on what the user needs:
What are you animating?
│
├─ A state change (opacity, position, color)
│ └─ → core-animations.md
│ ├─ withAnimation { } — explicit animation
│ ├─ .animation(_:value:) — implicit animation
│ └─ Spring configuration — .spring, .bouncy, .snappy, .smooth
│
├─ A multi-step / sequenced animation
│ └─ → phase-keyframe-animators.md (PhaseAnimator)
│ └─ Cycles through discrete phases automatically or on trigger
│
├─ A complex multi-property animation (scale + rotation + offset)
│ └─ → phase-keyframe-animators.md (KeyframeAnimator)
│ └─ Timeline-based keyframes with per-property tracks
│
├─ A view appearing / disappearing
│ └─ → transitions.md
│ ├─ .transition() — insertion/removal
│ ├─ .contentTransition() — text/symbol changes
│ └─ .asymmetric() — different in/out
│
├─ A hero / zoom navigation transition
│ └─ → transitions.md (matchedTransitionSource section)
│ ├─ iOS 18+: matchedTransitionSource + .navigationTransition(.zoom)
│ ├─ UIKit: preferredTransition = .zoom (capture stable IDs, never views)
│ └─ iOS 14+: matchedGeometryEffect (NOT for NavigationStack)
│
├─ A UIKit view driven by SwiftUI state or gestures
│ └─ → transitions.md (Bridging UIKit and SwiftUI Animations)
│ └─ UIView.animate(.spring(...)) / context.animate in updateUIView
│
├─ An SF Symbol animation
│ └─ → symbol-effects.md
│ └─ .symbolEffect(.bounce), .pulse, .wiggle, .breathe, .rotate
│
├─ A scroll-driven, geometry-driven, or shader effect
│ └─ → visual-effects.md
│ ├─ .scrollTransition — carousel scale/parallax/caption fades
│ ├─ .visualEffect — position-based effects without GeometryReader
│ ├─ MeshGradient — animatable multi-point gradients
│ ├─ TextRenderer — per-line / per-glyph text animation
│ └─ ShaderLibrary + .colorEffect / .distortionEffect / .layerEffect
│
└─ Spring physics / timing configuration
└─ → core-animations.md (Spring Configurations section)
| API | Minimum Version | Reference |
|---|---|---|
withAnimation | iOS 13 | core-animations.md |
.animation(_:value:) | iOS 13 | core-animations.md |
.spring(response:dampingFraction:) | iOS 13 | core-animations.md |
.matchedGeometryEffect | iOS 14 | transitions.md |
.transition(.push(from:)) | iOS 16 | transitions.md |
.contentTransition(.numericText()) | iOS 16 | transitions.md |
PhaseAnimator | iOS 17 | phase-keyframe-animators.md |
KeyframeAnimator | iOS 17 | phase-keyframe-animators.md |
.spring(duration:bounce:) | iOS 17 | core-animations.md |
Spring presets (.bouncy, .snappy, .smooth) | iOS 17 | core-animations.md |
withAnimation(_:completionCriteria:_:completion:) | iOS 17 | core-animations.md |
.symbolEffect() | iOS 17 | symbol-effects.md |
.transition(.blurReplace) | iOS 17 | transitions.md |
.contentTransition(.symbolEffect(.replace)) | iOS 17 | transitions.md |
Transition protocol / TransitionPhase | iOS 17 | transitions.md |
TransactionKey, scoped .animation / .transaction variants | iOS 17 | core-animations.md |
KeyframeTimeline, .mapCameraKeyframeAnimator | iOS 17 | phase-keyframe-animators.md |
.scrollTransition, .visualEffect | iOS 17 | visual-effects.md |
Shaders: .colorEffect / .distortionEffect / .layerEffect | iOS 17 | visual-effects.md |
MeshGradient | iOS 18 | visual-effects.md |
TextRenderer / TextAttribute | iOS 18 | visual-effects.md |
.matchedTransitionSource | iOS 18 | transitions.md |
.navigationTransition(.zoom) — push, sheet, fullScreenCover | iOS 18 | transitions.md |
UIViewController.preferredTransition = .zoom | iOS 18 | transitions.md |
UIView.animate(_: Animation) / context.animate | iOS 18 | transitions.md |
| # | Mistake | Fix | Details |
|---|---|---|---|
| 1 | spring(response:bounce:) — mixing parameter generations | Use either spring(response:dampingFraction:) (iOS 13) or spring(duration:bounce:) (iOS 17) | core-animations.md |
| 2 | .animation(.spring()) without value: parameter | Always pass value: — the no-value variant is deprecated (iOS 15) | core-animations.md |
| 3 | Wrong PhaseAnimator closure signature | PhaseAnimator(phases) { content, phase in } — not { phase in } | phase-keyframe-animators.md |
| 4 | Using matchedGeometryEffect for NavigationStack transitions | Use matchedTransitionSource + .navigationTransition(.zoom) on iOS 18+ | transitions.md |
| 5 | Using withAnimation for SF Symbol effects | Use .symbolEffect() modifier instead | symbol-effects.md |
When reviewing animation code, verify:
AccessibilityMotionEffect or UIAccessibility.isReduceMotionEnabled; provide non-motion alternatives.animation(.spring()) without value: is deprecated; .animation(nil) is replaced by withTransactionresponse with bounce)withAnimation(_:completionCriteria:_:completion:) (iOS 17+), not inventing .onAnimationCompleted.transition() only affects views inside if/switch controlled by state; not for views that are always presentcontent closures, visualEffect closures, TextRenderer.draw, and Animatable view bodies run every frame; no allocation, formatting, or layout math inside| File | Content |
|---|---|
| core-animations.md | withAnimation, springs, completions, transactions + TransactionKey, timing curves, Animatable mechanics, fluid-interface principles (momentum projection, rubber-banding, hysteresis) |
| phase-keyframe-animators.md | PhaseAnimator, KeyframeAnimator, KeyframeTimeline, MapKit camera keyframes, custom animations |
| transitions.md | View transitions, custom Transition protocol, matched geometry, navigation/zoom transitions (SwiftUI + UIKit), interruptibility, UIKit↔SwiftUI bridging, gesture-driven springs |
| symbol-effects.md | SF Symbol effects, accessibility |
| visual-effects.md | scrollTransition, visualEffect, MeshGradient, TextRenderer, shader effects (colorEffect/distortionEffect/layerEffect), effect pipelines, semantic alignment guides |
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Run a structured accessibility audit on an iOS/macOS app — automated XCUITest audits, Accessibility Inspector, manual VoiceOver/Dynamic Type passes, and App Store Accessibility Nutrition Label evaluation. Use before release, when preparing Nutrition Label declarations, or for EU Accessibility Act compliance.
The English summary is being prepared. Showing the original description.
Generate accessibility infrastructure for VoiceOver, Dynamic Type, and accessibility features. Use when improving app accessibility, adding accessibility labels and hints, or auditing compliance.
The English summary is being prepared. Showing the original description.
Generates an Apple-compliant account deletion flow with multi-step confirmation UI, optional data export, configurable grace period, Keychain cleanup, and server-side deletion request. Use when user needs account deletion, right-to-delete, or Apple App Review compliance for account removal.
The English summary is being prepared. Showing the original description.
Privacy-preserving ad measurement with AdAttributionKit (SKAdNetwork's successor) — install and re-engagement attribution, conversion-value strategy under crowd anonymity, and end-to-end postback testing. Use when running paid acquisition beyond Apple Ads, measuring re-engagement campaigns, designing conversion values, or migrating from SKAdNetwork.
The English summary is being prepared. Showing the original description.
AlarmKit integration for scheduling alarms and timers with custom UI, Live Activities, and snooze support. Use when implementing alarm or timer features in iOS 26+ apps.
The English summary is being prepared. Showing the original description.
Interpret app metrics and make data-driven decisions. Covers DAU/MAU, retention, LTV, ARPU, App Store Connect analytics, AARRR funnel analysis, cohort analysis, and diagnostic decision trees. Use when user wants to understand their metrics, diagnose problems, or build a data-driven growth plan.
The English summary is being prepared. Showing the original description.