dpearson2699/swift-ios-skills

swiftui-liquid-glass

Implement, review, or improve SwiftUI Liquid Glass effects for iOS 26+.

Vedi sorgente

Come usare

  1. Copia il comando e controlla il pacchetto prima di installarlo nel tuo ambiente agente.
  2. Controlla strumenti, credenziali e ambienti richiesti nel documento originale.
  3. Descrivi input e risultato desiderato; confronta l’output con le fonti.
npx skills add https://github.com/dpearson2699/swift-ios-skills --skill swiftui-liquid-glass

Prima di iniziare

  • L’installazione non include abbonamenti, quote API o accesso ai file.
  • Stelle e installazioni indicano attività, non un test indipendente di qualità o sicurezza.
Documento Skill originale

Contenuto dal repository con titoli, esempi, codice, tabelle, link e immagini preservati.

SwiftUI Liquid Glass

Liquid Glass is the dynamic translucent material introduced across Apple platforms

  1. Standard SwiftUI bars and presentations adopt it automatically when built with

the current SDK. Reserve custom glass for functional controls and navigation surfaces, not general content backgrounds.

See references/liquid-glass.md for the full API reference with additional examples.

Contents

Workflow

Choose the path that matches the request:

1. Implement a new feature with Liquid Glass

  1. Identify target surfaces (floating controls, custom bars, transient controls).
  2. Decide shape, prominence, and whether each element is a real control or static status.
  3. Wrap grouped glass elements in a GlassEffectContainer.
  4. Apply .glassEffect() after layout and appearance modifiers.
  5. Add .interactive() only to tappable/focusable elements.
  6. Add morphing transitions with glassEffectID(_:in:) where the view hierarchy

changes with animation. Put glassEffectTransition(_:) on the inserted or removed glass child, not on the always-present container, and choose the style using Morphing & Transitions.

  1. Gate with if #available(iOS 26, *) and provide a fallback for earlier versions.

2. Improve an existing feature with Liquid Glass

  1. Find custom control or navigation backgrounds that can be replaced with .glassEffect().
  2. Wrap sibling glass elements in GlassEffectContainer for blending and performance.
  3. Replace custom glass-like buttons with .buttonStyle(.glass), .buttonStyle(.glassProminent), or configurable styles such as .buttonStyle(.glass(.clear)). Use .glass(_:) when the button needs a specific tint or variant; reserve .glassProminent for high-emphasis primary actions.
  4. Add morphing transitions where animated insertion/removal occurs.

3. Review existing Liquid Glass usage

Trace each effect through content/control ownership, layout order, container scope, interactivity, transitions, availability, accessibility settings, and fallback. Restore the same UI fixture and rerun the checklist after each correction.

Core API Summary

glassEffect(_:in:)

Applies Liquid Glass behind a view. Default: .regular variant in a Capsule shape.

swift
nonisolated func glassEffect(
    _ glass: Glass = .regular,
    in shape: some Shape = DefaultGlassEffectShape()
) -> some View

Glass struct

Property / MethodPurpose
.regularStandard glass material
.clearClear variant; add dimming/contrast treatment when legibility needs it
.identityNo visual effect (pass-through)
.tint(_:)Add a color tint for prominence
.interactive(_:)React to touch and pointer interactions

Chain them: .regular.tint(.blue).interactive()

GlassEffectContainer

Wraps multiple glass views for shared rendering, blending, and morphing.

swift
GlassEffectContainer(spacing: 24) {
    // child views with .glassEffect()
}

The spacing controls when nearby glass shapes begin to blend. Match or exceed the interior layout spacing so shapes merge during animated transitions but remain separate at rest.

Morphing & Transitions

ModifierPurpose
glassEffectID(_:in:)Stable identity for morphing during view hierarchy changes
glassEffectUnion(id:namespace:)Merge multiple views into one glass shape
glassEffectTransition(_:)Control how glass appears/disappears

Transition decision: use .matchedGeometry for nearby effects inside the container's spacing; use .materialize for distant insertion/removal or when no geometry match should occur; use .identity only when no transition animation is wanted.

Button Styles

swift
Button("Action") { }
    .buttonStyle(.glass)           // standard glass button

Button("Primary") { }
    .buttonStyle(.glassProminent)  // prominent glass button

Button("Media") { }
    .buttonStyle(.glass(.clear))    // configurable variant; verify contrast

Related iOS 26 APIs

APIUse
scrollEdgeEffectStyleConfigure a scroll boundary's visual treatment.
backgroundExtensionEffectExtend one background under safe-area edges with mirrored blur.
ToolbarSpacerCreate a visual break between toolbar items.

See the corresponding sections in references/liquid-glass.md for signatures and examples.

Code Examples

Glass button with availability gate

swift
if #available(iOS 26, *) {
    Button("Show Status") { showStatusDetails() }
        .buttonStyle(.glass)
} else {
    Button("Show Status") { showStatusDetails() }
        .buttonStyle(.bordered)
}

Grouped glass shapes in a container

swift
let symbols = ["pencil", "eraser.fill", "lasso"]

GlassEffectContainer(spacing: 24) {
    HStack(spacing: 24) {
        ForEach(symbols, id: \.self) { symbol in
            Image(systemName: symbol)
                .frame(width: 56, height: 56)
                .glassEffect()
        }
    }
}

Nearby morphing transition

swift
@State private var isExpanded = false
@Namespace private var ns

var body: some View {
    GlassEffectContainer(spacing: 40) {
        HStack(spacing: 40) {
            Image(systemName: "pencil")
                .frame(width: 80, height: 80)
                .glassEffect()
                .glassEffectID("pencil", in: ns)

            if isExpanded {
                Image(systemName: "eraser.fill")
                    .frame(width: 80, height: 80)
                    .glassEffect()
                    .glassEffectID("eraser", in: ns)
                    .glassEffectTransition(.matchedGeometry)
            }
        }
    }

    Button("Toggle") {
        withAnimation { isExpanded.toggle() }
    }
    .buttonStyle(.glass)
}

Unioning views into a single glass shape

swift
@Namespace private var ns

GlassEffectContainer(spacing: 20) {
    HStack(spacing: 20) {
        ForEach(items.indices, id: \.self) { i in
            Image(systemName: items[i])
                .frame(width: 80, height: 80)
                .glassEffect()
                .glassEffectUnion(id: i < 2 ? "group1" : "group2", namespace: ns)
        }
    }
}

Tinted glass icon control

swift
struct GlassIconControl: View {
    let icon: String
    let tint: Color
    let action: () -> Void

    var body: some View {
        Button(action: action) {
            Image(systemName: icon)
                .font(.title2)
                .padding()
        }
        .buttonStyle(.glass(.regular.tint(tint)))
    }
}

Clear glass action over bright content

swift
if #available(iOS 26, *) {
    ZStack {
        Capsule()
            .fill(.black.opacity(0.28))

        Button {
            playRecap()
        } label: {
            Label("Play", systemImage: "play.fill")
                .font(.headline)
                .padding(.horizontal, 8)
        }
        .buttonStyle(.glass(.clear))
    }
    .fixedSize()
} else {
    Button("Play", systemImage: "play.fill") { playRecap() }
        .buttonStyle(.borderedProminent)
}

Use clear glass only when the background still leaves labels and symbols readable. On bright or busy backgrounds, add a subtle dimming layer or choose a more opaque button style.

Static status count, not a toolbar control

swift
VStack(spacing: 8) {
    Text("24")
        .font(.headline.monospacedDigit())
        .accessibilityLabel("24 options expiring")

    Text("Options Expiring")
        .font(.subheadline)
        .foregroundStyle(.secondary)
}
// Keep read-only status out of toolbar control slots and do not add .interactive().

Common Mistakes

MistakeFix
Glass decorates static contentKeep it in the controls/navigation layer.
Read-only status uses .interactive() or an action slotPresent status as content, or make the whole badge one real accessible action.
Related effects use nested containersUse one GlassEffectContainer per related blending/morphing group.
.glassEffect() precedes padding/frame/styleApply layout and appearance first, then glass.
Custom effects assume default accessibility settingsTest Reduce Transparency, Reduce Motion, contrast, and legibility.
No pre-iOS 26 pathGate the effect and preserve a functional fallback.

Review Checklist

  • [ ] Availability: if #available(iOS 26, *) present with fallback UI.
  • [ ] Container: Multiple glass views wrapped in GlassEffectContainer.
  • [ ] Modifier order: .glassEffect() applied after layout/appearance modifiers.
  • [ ] Interactivity: .interactive() used only where user interaction exists.
  • [ ] Status vs action: Static counts/status are not toolbar controls and do not expose press/hover affordance.
  • [ ] Transitions: glassEffectID used with @Namespace for morphing animations.
  • [ ] Transition type: .matchedGeometry for nearby effects; .materialize for distant ones, applied to the conditional glass child.
  • [ ] Consistency: Shapes, tints, and spacing are uniform across related elements.
  • [ ] Performance: Glass effects are limited in number; container used for grouping.
  • [ ] Accessibility: Tested with Reduce Transparency and Reduce Motion enabled.
  • [ ] Button styles: Standard .glass, .glassProminent, or configurable .glass(_:) used for buttons; .glass(_:) is primary when a tint or clear variant is required.
  • [ ] Clear glass contrast: Clear glass over bright content has a dimming/contrast treatment or uses a more legible style.
  • [ ] Concurrency: IDs passed to glassEffectID / glassEffectUnion are Sendable; MainActor-annotated Liquid Glass APIs stay in SwiftUI UI code.

References

Correlati per attività

dallo stesso repository

Altri Skills

Tutti gli Skills
dpearson2699
Community

app-intents

Implement App Intents for Siri, Shortcuts, Spotlight, widgets, Control Center, and Apple Intelligence on iOS. Covers AppIntent actions, AppEntity and EntityQuery models, AppShortcutsProvider phrases, IndexedEntity Spotlight indexing, WidgetConfigurationIntent, SnippetIntent, and assistant schemas. Use when exposing app actions or entities to system surfaces.

Installazioni / 1h
2
GitHub Stars
1,3K
Aggiornato
31 lug
dpearson2699
Community

carplay

Build CarPlay-enabled apps using the CarPlay framework. Use when creating navigation, audio, communication, EV charging, parking, or food ordering apps for the car display, working with CPTemplateApplicationScene, CPInterfaceController template hierarchies, CPListTemplate, CPMapTemplate, CPNowPlayingTemplate, configuring CarPlay entitlements, or integrating with CarPlay Simulator for testing.

Installazioni / 1h
2
GitHub Stars
1,3K
Aggiornato
31 lug
dpearson2699
Community

ios-accessibility

Build and audit SwiftUI, UIKit, and AppKit accessibility for VoiceOver, Voice Control, Switch Control, Full Keyboard Access, Dynamic Type, focus restoration, labels/traits/actions, traversal, custom rotors, NSAccessibility, XCTest checks, adaptive system preferences, and App Store accessibility declarations. Use when implementing accessible UI, fixing an accessibility audit, testing assistive-technology behavior, or substantiating App Store Accessibility Nutrition Labels.

Installazioni / 1h
1
GitHub Stars
1,3K
Aggiornato
31 lug
dpearson2699
Community

speech-recognition

Transcribe speech to text using Apple's Speech framework. Use when implementing live microphone transcription with AVAudioEngine, recognizing recorded audio files, handling speech and microphone authorization, choosing on-device vs server-backed SFSpeechRecognizer behavior, or adopting SpeechAnalyzer, SpeechTranscriber, DictationTranscriber, AssetInventory, and async result streams on iOS 26+.

Installazioni / 1h
1
GitHub Stars
1,3K
Aggiornato
31 lug