Communitygithub.com

steipete/swiftui-liquid-glass

SwiftUI Liquid Glass: 구현, 도입, 리팩토링, 정확성/성능/디자인 검토.

swiftui-liquid-glass란 무엇인가요?

이 스킬은 SwiftUI 앱에서 iOS 26+ Liquid Glass API를 올바르게 활용하도록 돕는 전문 가이드입니다. `glassEffect`, `GlassEffectContainer`, 유리 버튼 스타일 등 네이티브 API를 최우선으로 사용하며, Apple의 디자인 지침을 준수합니다. 기존 기능 리뷰, Liquid Glass 도입을 통한 개선, 새로운 기능 구현 등 다양한 시나리오를 지원하며, 각 경우에 맞는 워크플로우 결정 트리를 제공합니다. 핵심 지침으로는 레이아웃/시각적 수정자 이후에 `glassEffect` 적용, 여러 유리 요소가 공존할 때 `GlassEffectContainer` 사용, iOS 26 미만을 위한 폴백 UI 처리 등이 포함됩니다. 리뷰 체크리스트와 구현 체크리스트를 통해 정확성, 성능, 일관성을 보장하며, 형태 전환과 인터랙티브 유리 효과의 올바른 사용법을 명확히 설명합니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

SwiftUI Liquid Glass

참고: @Dimillian의 Dimillian/Skills에서 복사함 (2025-12-31).

개요

이 스킬은 iOS 26+ Liquid Glass API를 완전히 준수하는 SwiftUI 기능을 구축하거나 검토하는 데 사용합니다. 네이티브 API(glassEffect, GlassEffectContainer, 유리 버튼 스타일)와 Apple 디자인 지침을 우선시합니다. 사용법을 일관되게 유지하고, 필요 시 인터랙티브하게 만들며, 성능을 고려합니다.

워크플로우 결정 트리

요청에 맞는 경로를 선택하세요:

1) 기존 기능 검토

  • Liquid Glass를 적용해야 할 곳과 적용하지 말아야 할 곳을 확인합니다.
  • 올바른 수정자 순서, 모양 사용 및 컨테이너 배치를 확인합니다.
  • iOS 26+ 가용성 처리 및 적절한 폴백을 확인합니다.

2) Liquid Glass를 사용하여 기능 개선

  • 유리 처리 대상 컴포넌트(표면, 칩, 버튼, 카드)를 식별합니다.
  • 여러 유리 요소가 나타나는 경우 GlassEffectContainer를 사용하도록 리팩토링합니다.
  • 탭 가능하거나 포커스 가능한 요소에만 인터랙티브 유리를 도입합니다.

3) Liquid Glass를 사용하여 새 기능 구현

  • 먼저 유리 표면과 상호작용(모양, 중요도, 그룹화)을 설계합니다.
  • 레이아웃/외관 수정자 이후에 유리 수정자를 추가합니다.
  • 뷰 계층 구조가 애니메이션과 함께 변경될 때만 형태 전환을 추가합니다.

핵심 지침

  • 맞춤형 블러보다 네이티브 Liquid Glass API를 선호합니다.
  • 여러 유리 요소가 공존할 때 GlassEffectContainer를 사용합니다.
  • .glassEffect(...)는 레이아웃 및 시각적 수정자 이후에 적용합니다.
  • 터치/포인터에 반응하는 요소에는 .interactive()를 사용합니다.
  • 관련 요소 간에 모양을 일관되게 유지하여 응집력 있는 느낌을 줍니다.
  • #available(iOS 26, *)로 가드를 적용하고 유리가 없는 폴백을 제공합니다.

검토 체크리스트

  • 가용성: #available(iOS 26, *)가 폴백 UI와 함께 존재하는가?
  • 구성: 여러 유리 뷰가 GlassEffectContainer로 감싸져 있는가?
  • 수정자 순서: glassEffect가 레이아웃/외관 수정자 이후에 적용되었는가?
  • 인터랙티브: 사용자 상호작용이 있는 곳에만 interactive()가 사용되었는가?
  • 전환: 형태 전환을 위해 @Namespace와 함께 glassEffectID가 사용되었는가?
  • 일관성: 모양, 틴트 및 간격이 기능 전체에서 일치하는가?

구현 체크리스트

  • 대상 요소와 원하는 유리 중요도를 정의합니다.
  • 그룹화된 유리 요소를 GlassEffectContainer로 감싸고 간격을 조정합니다.
  • 필요에 따라 .glassEffect(.regular.tint(...).interactive(), in: .rect(cornerRadius: ...))를 사용합니다.
  • 액션에 대해 .buttonStyle(.glass) / .buttonStyle(.glassProminent)를 사용합니다.
  • 계층 구조가 변경될 때 glassEffectID로 형태 전환을 추가합니다.
  • 이전 iOS 버전을 위한 폴백 재질과 시각적 요소를 제공합니다.

빠른 코드 조각

이 패턴을 직접 사용하고 모양, 틴트, 간격을 사용자 정의하세요.

if #available(iOS 26, *) {
    Text("Hello")
        .padding()
        .glassEffect(.regular.interactive(), in: .rect(cornerRadius: 16))
} else {
    Text("Hello")
        .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("Confirm") { }
    .buttonStyle(.glassProminent)

참고 자료

  • 참조 가이드: references/liquid-glass.md
  • 최신 API 세부 정보는 Apple 문서를 선호합니다.

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.

관련 스킬