Need
Liquid Glass UI API
Default options
SwiftUI 와 glassEffect, GlassEffectContainer, Liquid Glass 버튼 스타일
Why it's needed
이들은 스킬이 우선 사용해야 할 네이티브 API입니다. 따라서 Codex는 머티리얼 시스템을 새로 구현하는 대신 커스텀 블러 레이어를 제거합니다.
Codex use case
Liquid Glass 도입하기
Codex를 사용해 기존 SwiftUI 앱을 iOS 26 API와 Xcode 26 기반의 Liquid Glass로 마이그레이션하세요.
Difficulty 고급
Time horizon 1시간
Codex와 Build iOS Apps 플러그인을 사용해 기존 iPhone 및 iPad UI를 점검하고, 커스텀 블러 또는 머티리얼 스택을 네이티브 Liquid Glass로 교체하며, iOS 26 가용성 검사와 시뮬레이터 기반 검증으로 안전하게 마이그레이션하세요.
적합한 대상
- 모호한 재디자인 지침이 아니라 실용적인 iOS 26 Liquid Glass 마이그레이션 계획이 필요한 기존 SwiftUI 앱
- Codex로 커스텀 카드, 시트, 탭 바, 툴바, 액션 버튼을 점검한 다음 마이그레이션을 단위별로 구현하려는 팀
- 이전 iOS 버전도 계속 지원하므로 일방적인 시각적 개편 대신 `#available(iOS 26, *)` 기반 폴백이 필요한 앱
Contents
Liquid Glass 도입하기
Codex를 사용해 기존 SwiftUI 앱을 iOS 26 API와 Xcode 26 기반의 Liquid Glass로 마이그레이션하세요.
Codex와 Build iOS Apps 플러그인을 사용해 기존 iPhone 및 iPad UI를 점검하고, 커스텀 블러 또는 머티리얼 스택을 네이티브 Liquid Glass로 교체하며, iOS 26 가용성 검사와 시뮬레이터 기반 검증으로 안전하게 마이그레이션하세요.
고급
1시간
Codex와 Build iOS Apps 플러그인을 사용해 기존 iPhone 및 iPad UI를 점검하고, 커스텀 블러 또는 머티리얼 스택을 네이티브 Liquid Glass로 교체하며, iOS 26 가용성 검사와 시뮬레이터 기반 검증으로 안전하게 마이그레이션하세요.
고급
1시간
적합한 대상
- 모호한 재디자인 지침이 아니라 실용적인 iOS 26 Liquid Glass 마이그레이션 계획이 필요한 기존 SwiftUI 앱
- Codex로 커스텀 카드, 시트, 탭 바, 툴바, 액션 버튼을 점검한 다음 마이그레이션을 단위별로 구현하려는 팀
- 이전 iOS 버전도 계속 지원하므로 일방적인 시각적 개편 대신 `#available(iOS 26, *)` 기반 폴백이 필요한 앱
스킬 및 플러그인
- SwiftUI Liquid Glass, SwiftUI UI 패턴, 시뮬레이터 디버깅 스킬을 사용해 iOS 화면을 현대화하고 네이티브 Liquid Glass 효과를 도입한 다음 iOS 26 시뮬레이터에서 결과를 검증하세요.
| Skill | Why use it |
|---|---|
| Build iOS Apps | SwiftUI Liquid Glass, SwiftUI UI 패턴, 시뮬레이터 디버깅 스킬을 사용해 iOS 화면을 현대화하고 네이티브 Liquid Glass 효과를 도입한 다음 iOS 26 시뮬레이터에서 결과를 검증하세요. |
시작 프롬프트
Build iOS Apps 플러그인과 여기에 포함된 SwiftUI Liquid Glass 스킬을 사용해 이 앱에서 사용량이 많은 플로우 하나를 Liquid Glass로 마이그레이션하세요.
제약 조건:
- 이 작업은 iOS 26 및 Xcode 26 마이그레이션으로 진행하되, 이전 배포 타깃에서는 `#available(iOS 26, *)` 조건을 적용해 Liquid Glass 미적용 폴백을 유지하세요.
- 먼저 플로우를 점검하세요. 네이티브 Liquid Glass로 바꿔야 할 커스텀 배경, 블러 스택, 칩, 버튼, 시트, 툴바와 일반 콘텐츠로 유지해야 할 표면을 각각 명시하세요.
- 커스텀 블러 대신 `glassEffect`, `GlassEffectContainer`, `glassEffectID`, `.buttonStyle(.glass)`, `.buttonStyle(.glassProminent)` 같은 시스템 컨트롤과 네이티브 API를 우선 사용하세요. 실질적인 모핑 전환이 플로우를 개선하는 경우에만 `glassEffectID` 및 `@Namespace` 조합을 사용하세요.
- `glassEffect` 적용은 레이아웃 및 시각적 수정자 뒤에 배치하고, 모양을 일관되게 유지하며, 실제로 터치에 반응하는 컨트롤에만 `.interactive()`를 사용하세요.
- XcodeBuildMCP로 iOS 26 시뮬레이터에서 빌드하고 실행한 다음 마이그레이션된 플로우의 스크린샷을 캡처하세요. 어떤 스킴과 시뮬레이터를 사용했고 어떤 검사를 수행했는지 정확히 명시하세요.
제공 항목:
- 플로우를 위한 간결한 마이그레이션 계획
- 구현된 Liquid Glass 범위
- iOS 26 미만 기기의 폴백 동작
- 사용한 시뮬레이터 검증 단계와 스크린샷
Build iOS Apps 플러그인과 여기에 포함된 SwiftUI Liquid Glass 스킬을 사용해 이 앱에서 사용량이 많은 플로우 하나를 Liquid Glass로 마이그레이션하세요.
제약 조건:
- 이 작업은 iOS 26 및 Xcode 26 마이그레이션으로 진행하되, 이전 배포 타깃에서는 `#available(iOS 26, *)` 조건을 적용해 Liquid Glass 미적용 폴백을 유지하세요.
- 먼저 플로우를 점검하세요. 네이티브 Liquid Glass로 바꿔야 할 커스텀 배경, 블러 스택, 칩, 버튼, 시트, 툴바와 일반 콘텐츠로 유지해야 할 표면을 각각 명시하세요.
- 커스텀 블러 대신 `glassEffect`, `GlassEffectContainer`, `glassEffectID`, `.buttonStyle(.glass)`, `.buttonStyle(.glassProminent)` 같은 시스템 컨트롤과 네이티브 API를 우선 사용하세요. 실질적인 모핑 전환이 플로우를 개선하는 경우에만 `glassEffectID` 및 `@Namespace` 조합을 사용하세요.
- `glassEffect` 적용은 레이아웃 및 시각적 수정자 뒤에 배치하고, 모양을 일관되게 유지하며, 실제로 터치에 반응하는 컨트롤에만 `.interactive()`를 사용하세요.
- XcodeBuildMCP로 iOS 26 시뮬레이터에서 빌드하고 실행한 다음 마이그레이션된 플로우의 스크린샷을 캡처하세요. 어떤 스킴과 시뮬레이터를 사용했고 어떤 검사를 수행했는지 정확히 명시하세요.
제공 항목:
- 플로우를 위한 간결한 마이그레이션 계획
- 구현된 Liquid Glass 범위
- iOS 26 미만 기기의 폴백 동작
- 사용한 시뮬레이터 검증 단계와 스크린샷
iOS 26 기준부터 시작하기
Liquid Glass를 먼저 iOS 26 및 Xcode 26 마이그레이션 프로젝트로 접근하세요. iOS 26 SDK로 앱을 다시 빌드하고 표준 SwiftUI 컨트롤에 기본으로 적용되는 결과를 확인한 다음, 여전히 지나치게 평면적이거나 무겁거나 시스템 UI와 동떨어져 보이는 커스텀 부분만 Codex에 재디자인하도록 요청하세요.
앱이 여전히 이전 iOS 버전을 지원한다면 이 제약 조건을 처음부터 명확히 하세요. Build iOS Apps 플러그인에 포함된 SwiftUI Liquid Glass 스킬은 새로운 Liquid Glass 전용 API에 #available(iOS 26, *) 조건을 적용하고 이전 기기에서도 가독성을 유지하는 폴백 경로를 제공해야 합니다.
iOS 플러그인 활용하기
Codex가 SwiftUI UI 변경과 시뮬레이터 기반 검증을 함께 수행하게 하려면 Build iOS Apps 플러그인을 사용하세요. Liquid Glass 작업에서는 Codex에 플로우 하나를 점검하고 일부 표면을 마이그레이션하도록 요청한 다음, 범위를 확장하기 전에 iOS 26 시뮬레이터에서 결과를 실행하고 스크린샷을 캡처하는 것이 효과적입니다.
이 플러그인에는 프롬프트에 반영할 만한 간단한 기본 원칙을 담은 SwiftUI Liquid Glass 스킬이 포함되어 있습니다:
- 커스텀 블러 뷰 대신 네이티브
glassEffect,GlassEffectContainer, Liquid Glass 버튼 스타일,glassEffectID전환을 우선 사용하세요. .glassEffect(...)적용은 레이아웃 및 시각적 수정자 뒤에 배치하여 머티리얼이 실제로 원하는 최종 모양에 맞게 적용되도록 하세요.- 여러 표면이 함께 나타날 때는 관련 Liquid Glass 요소를
GlassEffectContainer로 감싸세요. .interactive()적용 대상은 실제로 터치에 반응하는 버튼, 칩, 컨트롤로 제한하세요.- 제각각인 Liquid Glass 스타일을 섞지 말고 해당 기능 전체에서 모서리 모양, 틴트, 간격을 일관되게 유지하세요.
- iOS 26 미만 타깃을 위한 Liquid Glass 미적용 폴백을 유지하세요.
플러그인과 스킬 설치에 관한 자세한 내용은 플러그인 및 스킬 문서를 참고하세요.
WWDC 세션 시청하기
실제 프로덕션 플로우를 리팩터링하도록 Codex에 요청하기 전에 다음 WWDC25 세션을 참고하면 좋습니다:
마이그레이션 계획을 요청한 다음 일부 구현하기
Liquid Glass 마이그레이션은 Codex가 "Liquid Glass를 어디에 적용해야 하는가?"와 "지금 모든 코드를 작성하라."를 분리해 처리할 때 더 원활합니다. 먼저 간단한 검토를 요청한 다음, 에이전트가 시뮬레이터 검증을 거쳐 독립적으로 완결된 범위 하나를 구현하도록 하세요.
실용적인 팁
모든 요소에 Liquid Glass를 적용하지 않기
Liquid Glass는 콘텐츠 위에 명확한 컨트롤 레이어를 형성해야 하며 모든 카드를 빛나는 패널로 바꿔서는 안 됩니다. Codex에 시스템 머티리얼과 충돌하는 장식용 배경을 제거하도록 요청하고, 가독성이 가장 중요한 곳은 장식 없는 콘텐츠로 유지하며, 틴트는 의미를 강조하거나 주요 동작을 나타낼 때만 사용하세요.
사용량이 많은 플로우 하나부터 시작하기
앱 전체를 한 번에 마이그레이션하기보다 탭 루트, 상세 화면, 시트, 검색 화면, 온보딩 플로우 중 하나를 첫 마이그레이션 대상으로 삼는 편이 좋습니다. 그러면 검토가 쉬워지고 어떤 Liquid Glass 관련 결정을 재사용 가능한 컴포넌트 패턴으로 만들어야 하는지 명확해집니다.
폴백 동작을 꼼꼼히 검토하기
배포 타깃이 iOS 26 미만이라면 Codex에 Liquid Glass 버전과 폴백 구현을 함께 보여 달라고 요청하세요. 이 검토 단계에서 의도치 않은 API 가용성 회귀를 발견할 수 있으며, 최신 시뮬레이터에서만 작동하는 마이그레이션 결과가 출시되는 것을 방지할 수 있습니다.
Tech stack
Need
Default options
Why it's needed
Need
플랫폼 기준
Default options
iOS 26 및 Xcode 26
Why it's needed
Liquid Glass는 iOS 26 SDK부터 제공됩니다. Codex는 Xcode 26으로 컴파일하고 이전 OS 지원을 위한 명시적 폴백을 추가해야 합니다.
Need
시뮬레이터 검증
Default options
Why it's needed
시각적 마이그레이션에서는 빌드, 실행, 스크린샷 캡처, 로그 검사가 중요하며 여러 상태와 기기 크기를 검토할 때는 특히 그렇습니다.
| Need | Default options | Why it's needed |
|---|---|---|
| Liquid Glass UI API | SwiftUI 와 glassEffect , GlassEffectContainer , Liquid Glass 버튼 스타일 | 이들은 스킬이 우선 사용해야 할 네이티브 API입니다. 따라서 Codex는 머티리얼 시스템을 새로 구현하는 대신 커스텀 블러 레이어를 제거합니다. |
| 플랫폼 기준 | iOS 26 및 Xcode 26 | Liquid Glass는 iOS 26 SDK부터 제공됩니다. Codex는 Xcode 26으로 컴파일하고 이전 OS 지원을 위한 명시적 폴백을 추가해야 합니다. |
| 시뮬레이터 검증 | XcodeBuildMCP | 시각적 마이그레이션에서는 빌드, 실행, 스크린샷 캡처, 로그 검사가 중요하며 여러 상태와 기기 크기를 검토할 때는 특히 그렇습니다. |
관련 사용 사례
iOS 앱에 App Intents 추가
Codex와 Build iOS Apps 플러그인을 사용해 앱이 App Intents를 통해 노출해야 할 액션과 엔티티를 파악하고, 이를 단축어와 Spotlight...
iOS 코드
iOS 앱 빌드하기
Codex로 iOS SwiftUI 프로젝트를 스캐폴딩하고, `xcodebuild` 또는 Tuist를 사용해 빌드 루프를 CLI 중심으로 유지하며, 작업이 심화되면...
iOS 코드
iOS 시뮬레이터에서 디버깅
Codex를 사용해 적합한 Xcode 스킴과 시뮬레이터를 찾고, 앱을 실행하고, UI 트리를 검사하고, 탭·입력·스와이프를 수행하고, 스크린샷과 로그를 수집하고...
iOS 코드