Communitygithub.com

steipete/swiftui-liquid-glass

SwiftUI Liquid Glass: Implementieren, Übernehmen, Refaktorieren, Prüfung auf Korrektheit/Leistung/Design.

Was ist swiftui-liquid-glass?

Dieses Skill ist darauf ausgelegt, Entwickler bei der Arbeit mit der nativen iOS 26+ Liquid Glass API in SwiftUI zu unterstützen. Es bietet einen strukturierten Workflow, um bestehende Funktionen auf die Verwendung von Liquid Glass zu überprüfen, sie entsprechend zu verbessern oder gänzlich neue Funktionen mit diesen APIs zu implementieren. Das Skill legt großen Wert auf die Einhaltung von Apples Designrichtlinien, die konsistente Verwendung von Glas-Effekten und die Leistungsoptimierung, insbesondere durch die empfohlene Nutzung von `GlassEffectContainer` für gruppierte Elemente und die Beschränkung interaktiver Effekte auf tatsächlich interaktive Komponenten. Es enthält detaillierte Checklisten für Code-Reviews und die Implementierung sowie Quick-Snippets für gängige Muster wie Schaltflächen, Container und morphing Übergänge. Dieses Skill ist besonders nützlich für iOS-Entwickler, die moderne, plattformkonforme Benutzeroberflächen erstellen und dabei einen konsistenten, hochwertigen „Liquid Glass“-Look gewährleisten möchten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/swiftui-liquid-glass

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

SwiftUI Liquid Glass

Zuschreibung: Kopiert von @Dimillians Dimillian/Skills (2025-12-31).

Übersicht

Verwenden Sie dieses Skill, um SwiftUI-Funktionen zu erstellen oder zu überprüfen, die vollständig mit der iOS 26+ Liquid Glass API übereinstimmen. Priorisieren Sie native APIs (glassEffect, GlassEffectContainer, Glass-Button-Stile) und Apples Designrichtlinien. Halten Sie die Verwendung konsistent, bei Bedarf interaktiv und leistungsbewusst.

Workflow-Entscheidungsbaum

Wählen Sie den Pfad, der zur Anfrage passt:

1) Überprüfen einer vorhandenen Funktion

  • Untersuchen Sie, wo Liquid Glass verwendet werden sollte und wo nicht.
  • Überprüfen Sie die korrekte Modifikator-Reihenfolge, Formularverwendung und Containerplatzierung.
  • Prüfen Sie auf iOS 26+ Verfügbarkeitsbehandlung und sinnvolle Fallbacks.

2) Verbessern einer Funktion mit Liquid Glass

  • Identifizieren Sie Zielkomponenten für die Glasbehandlung (Oberflächen, Chips, Buttons, Karten).
  • Refaktorieren Sie, um GlassEffectContainer zu verwenden, wo mehrere Glaselemente vorkommen.
  • Führen Sie interaktives Glas nur für berührbare oder fokussierbare Elemente ein.

3) Implementieren einer neuen Funktion mit Liquid Glass

  • Entwerfen Sie zuerst die Glasoberflächen und Interaktionen (Form, Prominenz, Gruppierung).
  • Fügen Sie Glasmodifikatoren nach Layout-/Darstellungsmodifikatoren hinzu.
  • Fügen Sie morphing Übergänge nur hinzu, wenn sich die View-Hierarchie mit Animation ändert.

Kernrichtlinien

  • Bevorzugen Sie native Liquid Glass APIs gegenüber benutzerdefinierten Unschärfen.
  • Verwenden Sie GlassEffectContainer, wenn mehrere Glaselemente nebeneinander existieren.
  • Wenden Sie .glassEffect(...) nach Layout- und visuellen Modifikatoren an.
  • Verwenden Sie .interactive() für Elemente, die auf Berührung/Zeiger reagieren.
  • Halten Sie die Formen über verwandte Elemente hinweg konsistent, um ein zusammenhängendes Erscheinungsbild zu erzielen.
  • Schützen Sie mit #available(iOS 26, *) und stellen Sie einen Nicht-Glas-Fallback bereit.

Review-Checkliste

  • Verfügbarkeit: #available(iOS 26, *) vorhanden mit Fallback-UI.
  • Zusammensetzung: Mehrere Glas-Views in GlassEffectContainer eingeschlossen.
  • Modifikator-Reihenfolge: glassEffect nach Layout-/Darstellungsmodifikatoren angewendet.
  • Interaktivität: interactive() nur dort, wo Benutzerinteraktion besteht.
  • Übergänge: glassEffectID verwendet mit @Namespace für Morphing.
  • Konsistenz: Formen, Tönung und Abstände sind über die Funktion hinweg abgestimmt.

Implementierungs-Checkliste

  • Ziel-Elemente und gewünschte Glas-Prominenz definieren.
  • Gruppierte Glaselemente in GlassEffectContainer einwickeln und Abstände anpassen.
  • .glassEffect(.regular.tint(...).interactive(), in: .rect(cornerRadius: ...)) wie benötigt verwenden.
  • .buttonStyle(.glass) / .buttonStyle(.glassProminent) für Aktionen verwenden.
  • Morphing-Übergänge mit glassEffectID hinzufügen, wenn sich die Hierarchie ändert.
  • Fallback-Materialien und -Visuals für frühere iOS-Versionen bereitstellen.

Kurzschnipsel

Verwenden Sie diese Muster direkt und passen Sie Formen, Tönungen und Abstände an.

if #available(iOS 26, *) {
    Text("Hallo")
        .padding()
        .glassEffect(.regular.interactive(), in: .rect(cornerRadius: 16))
} else {
    Text("Hallo")
        .padding()
        .background(.ultraThinMaterial, in: RoundedRectangle(cornerRadius: 16))
}
GlassEffectContainer(spacing: 24) {
    HStack(spacing: 24) {
        Image(systemName: "scribble.variable")
            .frame(width: 72, height: 72)
            .font(.system(size: 32))
            .glassEffect()
        Image(systemName: "eraser.fill")
            .frame(width: 72, height: 72)
            .font(.system(size: 32))
            .glassEffect()
    }
}
Button("Bestätigen") { }
    .buttonStyle(.glassProminent)

Ressourcen

  • Referenzhandbuch: references/liquid-glass.md
  • Bevorzugen Sie Apple-Dokumente für aktuelle API-Details.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Verwandte Skills