Communitygithub.com

ComeOnOliver/skillshub

레이아웃이 다양한 화면 크기, iPad 멀티태스킹 또는 iOS 26 자유형 창에 적응해야 할 때 사용합니다. ViewThatFits, AnyLayout, onGeometryChange에 대한 의사 결정 트리, 크기 클래스 제한 및 기기 기반 레이아웃 오류를 방지하는 안티 패턴을 제공합니다.

skillshub란 무엇인가요?

이 스킬은 디바이스 가정보다는 사용 가능한 공간에 반응하는 적응형 레이아웃을 구축하기 위한 규율을 강화합니다. '이 레이아웃을 아이패드와 아이폰에서 모두 작동하게 하려면?', 'GeometryReader를 써야 할까, ViewThatFits를 써야 할까?', '레이아웃이 스플릿 뷰나 스테이지 매니저에서 깨져요'와 같은 상황에서 적합한 도구를 선택할 수 있도록 의사 결정 트리를 제공합니다. ViewThatFits, AnyLayout, onGeometryChange, GeometryReader 사용법을 실제 패턴과 함께 설명하며, 특히 iOS 26 자유형 창과 iPad 크기 클래스의 한계를 심층적으로 다룹니다. 또한 기기 방향 관찰자, 화면 경계, 기기 모델 확인 등 흔한 안티 패턴을 지적하고 올바른 접근법을 제시하여, 미래의 새로운 디바이스나 멀티태스킹 모드에서도 깨지지 않는 레이아웃을 설계할 수 있도록 돕습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/CharlesWiltgen/Axiom/axiom-swiftui-layout

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

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

문서

SwiftUI 적응형 레이아웃

개요

디바이스 가정이 아닌 사용 가능한 공간에 반응하는 레이아웃을 구축하기 위한 규율을 강화하는 스킬입니다. 도구 선택, 크기 클래스 제한, iOS 26 자유형 창 및 일반적인 안티 패턴을 다룹니다.

핵심 원칙: 내일 애플이 새 기기를 출시하거나 내년에 iPadOS에 새로운 멀티태스킹 모드가 추가되어도 레이아웃이 올바르게 작동해야 합니다. 디바이스에 대한 가정이 아닌 컨테이너에 반응하세요.

이 스킬을 사용해야 할 때

  • "이 레이아웃을 iPad와 iPhone에서 모두 작동하게 하려면?"
  • "GeometryReader를 써야 할까, ViewThatFits를 써야 할까?"
  • "Split View / Stage Manager에서 레이아웃이 깨져요"
  • "크기 클래스가 필요한 정보를 제공하지 않아요"
  • "디자이너가 세로 방향과 가로 방향에 따라 다른 레이아웃을 원해요"
  • "iOS 26 창 크기 조절을 위한 앱 준비"

의사 결정 트리

"레이아웃을 적응시켜야 합니다..."
│
├─ 사용 가능한 공간(컨테이너 기반)에 따라
│   │
│   ├─ "가장 잘 맞는 변형 선택"
│   │   → ViewThatFits
│   │
│   ├─ "H↔V 간 애니메이션 전환"
│   │   → AnyLayout + 조건
│   │
│   ├─ "계산을 위해 크기 읽기"
│   │   → onGeometryChange (iOS 16+)
│   │
│   └─ "커스텀 레이아웃 알고리즘"
│       → Layout 프로토콜
│
├─ 플랫폼 특성에 따라
│   │
│   ├─ "Compact vs Regular 너비"
│   │   → horizontalSizeClass (⚠️ iPad 제한 사항)
│   │
│   ├─ "접근성 텍스트 크기"
│   │   → dynamicTypeSize.isAccessibilitySize
│   │
│   └─ "플랫폼 차이"
│       → #if os() / Environment
│
└─ 창 모양(종횡비)에 따라
    │
    ├─ "세로 vs 가로 방향 의미"
    │   → Geometry + 사용자 정의 임계값
    │
    ├─ "열 자동 표시/숨기기"
    │   → NavigationSplitView (iOS 26에서 자동)
    │
    └─ "창 생명주기"
        → @Environment(\.scenePhase)

도구 선택

빠른 결정

계산된 값(너비, 높이)이 필요합니까?
├─ 예 → onGeometryChange
└─ 아니오 → 애니메이션 전환이 필요합니까?
         ├─ 예 → AnyLayout + 조건
         └─ 아니오 → ViewThatFits

각 도구를 사용해야 할 때

필요한 기능이 도구 사용이 도구는 사용하지 않음
2-3개 레이아웃 변형 중 선택ViewThatFitsif size > X
H↔V 애니메이션 전환AnyLayout조건부 HStack/VStack
컨테이너 크기 읽기onGeometryChangeGeometryReader
접근성 텍스트 적응dynamicTypeSize고정된 중단점
Compact 너비 감지horizontalSizeClassUIDevice.idiom
iPad에서 좁은 창 감지Geometry + 임계값크기 클래스 단독
사이드바 표시/숨기기NavigationSplitView수동 열 로직
커스텀 레이아웃 알고리즘Layout 프로토콜중첩된 GeometryReader

패턴 1: ViewThatFits

사용 시기: 2-3개의 레이아웃 변형이 있고 SwiftUI가 처음으로 맞는 것을 선택하도록 하려는 경우.

ViewThatFits {
    // 첫 번째 선택: 가로
    HStack {
        Image(systemName: "star")
        Text("Favorite")
        Spacer()
        Button("Add") { }
    }

    // 대체: 세로
    VStack {
        HStack {
            Image(systemName: "star")
            Text("Favorite")
        }
        Button("Add") { }
    }
}

제한 사항: ViewThatFits는 어떤 변형이 선택되었는지 노출하지 않습니다. 다른 뷰에서 이 상태가 필요하다면 대신 AnyLayout을 사용하세요.


패턴 2: 애니메이션 전환을 위한 AnyLayout

사용 시기: 레이아웃 간 애니메이션 전환이 필요하거나 현재 레이아웃 상태를 알아야 하는 경우.

struct AdaptiveStack<Content: View>: View {
    @Environment(\.horizontalSizeClass) var sizeClass

    let content: Content

    var layout: AnyLayout {
        sizeClass == .compact
            ? AnyLayout(VStackLayout(spacing: 12))
            : AnyLayout(HStackLayout(spacing: 20))
    }

    var body: some View {
        layout {
            content
        }
        .animation(.default, value: sizeClass)
    }
}

Dynamic Type의 경우:

@Environment(\.dynamicTypeSize) var dynamicTypeSize

var layout: AnyLayout {
    dynamicTypeSize.isAccessibilitySize
        ? AnyLayout(VStackLayout())
        : AnyLayout(HStackLayout())
}

패턴 3: onGeometryChange (기하학 정보에 선호되는 방법)

사용 시기: 계산을 위해 실제 치수가 필요한 경우. GeometryReader보다 선호됩니다.

struct ResponsiveGrid: View {
    @State private var columnCount = 2

    var body: some View {
        LazyVGrid(columns: Array(repeating: GridItem(.flexible()), count: columnCount)) {
            ForEach(items) { item in
                ItemView(item: item)
            }
        }
        .onGeometryChange(for: Int.self) { proxy in
            max(1, Int(proxy.size.width / 150))
        } action: { newCount in
            columnCount = newCount
        }
    }
}

화면 비율 감지(iPad "방향")의 경우:

struct WindowShapeReader: View {
    @State private var isWide = true

    var body: some View {
        content
            .onGeometryChange(for: Bool.self) { proxy in
                proxy.size.width > proxy.size.height * 1.2
            } action: { newValue in
                isWide = newValue
            }
    }
}

패턴 4: GeometryReader (필요한 경우)

사용 시기: iOS 15 이하에서 기하학 정보가 필요하거나, 레이아웃 단계 중에 기하학 정보가 필요한 경우(단순한 부작용이 아닌 경우).

// ✅ 올바름: 제한된 GeometryReader
VStack {
    GeometryReader { geo in
        Text("Width: \(geo.size.width)")
    }
    .frame(height: 44)  // 반드시 제한!

    Button("Next") { }
}

// ❌ 잘못됨: 제한 없음(탐욕적)
VStack {
    GeometryReader { geo in
        Text("Width: \(geo.size.width)")
    }
    // 모든 사용 가능한 공간을 차지하며 형제 뷰를 누름
    Button("Next") { }
}

크기 클래스 진리표 (iPad)

구성가로세로
전체 화면 세로.regular.regular
전체 화면 가로.regular.regular
70% Split View.regular.regular
50% Split View.regular.regular
33% Split View.compact.regular
Slide Over.compact.regular
키보드 사용 시(변화 없음)(변화 없음)

핵심 통찰: 크기 클래스는 iPad에서 약 33% 너비 또는 Slide Over에서만 .compact가 됩니다. 더 세밀한 제어가 필요하면 기하학 정보를 사용하세요.


iOS 26 자유형 창

변경 사항

iOS 26 이전iOS 26+
고정된 Split View 크기자유형 드래그하여 크기 조절
UIRequiresFullScreen 허용됨사용 중단됨
iPad에 메뉴 바 없음.commands를 통한 메뉴 바
수동 열 가시성NavigationSplitView 자동 적응

Apple의 지침

"앱 크기를 조정해도 레이아웃이 영구적으로 변경되어서는 안 됩니다. 가능하면 원래 상태로 되돌릴 기회를 노리세요."

해석: 창 크기에 따라 레이아웃 상태를 저장하지 마세요. 창이 원래 크기로 돌아가면 레이아웃도 함께 돌아가야 합니다.

NavigationSplitView 자동 적응

// iOS 26: 열이 자동으로 표시/숨겨짐
NavigationSplitView {
    Sidebar()
} content: {
    ContentList()
} detail: {
    DetailView()
}
// 수동 columnVisibility 관리 불필요

마이그레이션 체크리스트

  • Info.plist에서 UIRequiresFullScreen 제거
  • 임의의 창 크기에서 테스트(33/50/66%만이 아님)
  • 크기 조정 후 레이아웃이 "고정"되지 않는지 확인
  • 일반적인 작업에 대한 메뉴 바 명령 추가
  • 창 컨트롤이 툴바 항목과 겹치지 않는지 테스트

안티 패턴

❌ 기기 방향 관찰자

// ❌ 잘못됨: 창이 아닌 기기를 보고함
NotificationCenter.default.addObserver(
    forName: UIDevice.orientationDidChangeNotification, ...
)

let orientation = UIDevice.current.orientation
if orientation.isLandscape { ... }

실패 이유: 물리적 기기 방향을 보고하며 창 모양을 보고하지 않습니다. Split View, Stage Manager, iOS 26에서 잘못됩니다.

수정: onGeometryChange를 사용하여 실제 창 치수를 읽으세요.

❌ 화면 경계

// ❌ 잘못됨: 전체 화면을 반환하며 사용자의 창이 아님
let width = UIScreen.main.bounds.width
if width > 700 { useWideLayout() }

실패 이유: 멀티태스킹에서 앱은 화면의 40%만 가질 수 있습니다.

수정: 뷰의 실제 컨테이너 크기를 읽으세요.

❌ 기기 모델 확인

// ❌ 잘못됨: 새 기기에서 깨지며 멀티태스킹에서 오작동
if UIDevice.current.userInterfaceIdiom == .pad {
    useWideLayout()
}

실패 이유: 1/3 Split View의 iPad는 iPhone 14 Pro Max 가로 방향보다 좁습니다.

수정: 기기 식별이 아닌 사용 가능한 공간에 반응하세요.

❌ 제한 없는 GeometryReader

// ❌ 잘못됨: GeometryReader는 탐욕적
VStack {
    GeometryReader { geo in
        Text("Size: \(geo.size)")
    }
    Button("Next") { }  // 눌림
}

수정: .frame()으로 제한하거나 onGeometryChange를 사용하세요.

❌ 크기 클래스를 방향 프록시로 사용

// ❌ 잘못됨: iPad는 두 방향 모두 .regular
var isLandscape: Bool {
    horizontalSizeClass == .regular  // iPad에서는 항상 참!
}

수정: 화면 비율이 필요하면 실제 기하학 정보에서 계산하세요.


압박 시나리오

"디자이너가 iPhone 전용 레이아웃을 원해요"

유혹: if UIDevice.current.userInterfaceIdiom == .phone

응답: "이것들을 'compact'와 'regular' 레이아웃으로 구현하여 사용 가능한 공간에 따라 전환하겠습니다. iPhone 레이아웃은 창이 좁을 때 iPad에도 나타납니다. 이렇게 하면 Stage Manager와 iOS 26에 대비할 수 있습니다."

"그냥 GeometryReader를 쓰세요, 괜찮아요"

유혹: 모든 것을 GeometryReader로 감싸기.

응답: "GeometryReader는 알려진 레이아웃 부작용이 있습니다. 탐욕적으로 확장됩니다. onGeometryChange는 레이아웃에 영향을 주지 않고 동일한 데이터를 읽습니다. iOS 16으로 이식되어 있습니다."

"크기 클래스가 이전에는 잘 작동했어요"

유혹: 모든 것을 크기 클래스를 통해 강제하기.

응답: "크기 클래스는 조악합니다. iPad는 두 방향 모두 .regular입니다. 넓은 범주에는 크기 클래스를, 정밀한 임계값에는 기하학 정보를 사용하겠습니다."

"iPad 멀티태스킹을 지원하지 않아요"

유혹: UIRequiresFullScreen = true

응답: "Apple은 iOS 26에서 전체 화면 전용을 사용 중단했습니다. 활성 Split View 지원이 없더라도 앱은 크기가 조정될 때 깨질 수 없습니다. 공간 기반 레이아웃은 동일한 비용이 듭니다."


리소스

WWDC: 2025-208, 2024-10074, 2022-10056

스킬: axiom-swiftui-layout-ref, axiom-swiftui-debugging, axiom-liquid-glass

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

관련 스킬