Communitygithub.com

coastdigitalgroup/coastai-skills

뷰포트 잠금, 다중 창 웹 애플리케이션 및 SaaS 대시보드를 위한 체계적인 레이아웃 프레임워크를 설계합니다. 스크롤 컨테이닝, 접이식 패널, 강력한 반응형 적응을 구축합니다.

coastai-skills란 무엇인가요?

이 스킬은 뷰포트 잠금(Viewport-Locked) 기반의 다중 창 웹 인터페이스, 즉 애플리케이션 쉘(application shell) 또는 워크스페이스를 설계하기 위한 체계적인 방법론을 제공합니다. 일반적인 문서 기반 페이지와 달리 대시보드 쉘은 메인 뷰포트 높이를 정확히 `100dvh`로 고정하고 작업 공간을 여러 기능 영역으로 분할합니다. 이 스킬은 '스크롤 속 스크롤' 잠김, 뷰포트 고무줄 현상, 패널 접힘 전환 시 레이아웃 이동, 중첩 다이얼로그 포커스 트랩 등 일반적인 공간적 마찰 지점을 해결하여 미적 디자인과 기술적 CSS 컨테이닝 간의 간극을 메웁니다. 결과적으로 응집력 있고 기능적이며 접근성 높은 워크스페이스를 제공합니다. 주요 사용 사례로는 B2B SaaS 핵심 워크스페이스, 데이터 분석 대시보드, 관리 및 운영 패널, 리치 콘텐츠 편집 인터페이스 등이 있습니다. 반면 마케팅 랜딩 페이지, 블로그 기사, 이커머스 상품 목록 페이지, 단순 유틸리티 도구에는 적합하지 않습니다. 이 스킬은 뷰포트 잠금 및 스크롤 컨테이닝 설정, 패널 시각적 앵커 정의, 접이식 패널 메커니즘 설계, 접근성 랜드마크 코딩, 반응형 적응(폴딩 규칙) 계획 등의 워크플로우를 안내합니다. 또한 Grid와 Flexbox의 선택 기준, 스크롤 관리, 동적 뷰포트 높이(dvh), 포커스 표시기, 이중 스크롤바 방지, 터치 대상 최소 크기 등 구체적인 결정 규칙과 제약 사항을 포함하여 실무에 바로 적용 가능한 가이드를 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/dashboard-layout-system

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

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

문서

대시보드 레이아웃 시스템

목적

대시보드 레이아웃 시스템은 뷰포트 잠금(Viewport-Locked) 기반의 다중 창 웹 인터페이스(종종 애플리케이션 쉘 또는 워크스페이스라고 함)를 위한 체계적인 설계 방법론을 제공합니다. 단일 스크롤 컨테이너 안에서 무한히 아래로 흐르는 표준 문서 기반 페이지와 달리, 대시보드 쉘은 메인 뷰포트 높이를 정확히 100vh(또는 100dvh)로 고정하고 작업 공간을 여러 개의 뚜렷한 기능 영역으로 분할합니다.

체계적인 접근 방식은 '스크롤 속 스크롤' 잠김, 뷰포트 고무줄 현상, 패널 축소 전환 중 레이아웃 이동, 중첩 다이얼로그 포커스 트랩과 같은 일반적인 공간적 마찰 지점을 해결합니다. 미적 시각 디자인과 기술적 CSS 컨테이닝 간의 간극을 메워 응집력 있고 고도로 기능적이며 접근성 높은 워크스페이스를 만듭니다.

사용 사례

  • B2B SaaS 핵심 워크스페이스: 사이드바, 필터, 목록 컨트롤, 콘텐츠 상세 패널을 동시에 볼 수 있어야 하는 웹 플랫폼.
  • 데이터 분석 대시보드: 실시간 데이터, 메트릭, 차트, 컨트롤 사이드바를 통합된 뷰로 제공하는 고밀도 다중 패널 그리드.
  • 관리 및 운영 패널: 고정된 작업 헤더와 방대한 데이터 그리드 옆의 컨텍스트별 상세 서랍이 필요한 중대형 운영 소프트웨어.
  • 리치 콘텐츠 편집 인터페이스: 중앙 캔버스 또는 리치 텍스트 워크스페이스(예: CMS 편집기, 이메일 빌더, 디자인 캔버스 도구) 양옆에 접을 수 있는 포맷/속성 사이드 서랍이 있는 레이아웃.

사용하지 말아야 할 때

  • 마케팅 및 랜딩 페이지: 스토리텔링과 행동 유도에 최적화된 선형적인 수직 스크롤 여정이 필요한 경우. 대신 hero-design-system 및 section-composition-system을 사용하세요.
  • 에디토리얼 및 블로그 기사: 독자가 단일 선형 텍스트 흐름과 함께 표준 기본 브라우저 스크롤을 기대하는 경우. 대신 article-layout-system 및 table-of-contents-system을 사용하세요.
  • 이커머스 상품 목록 페이지(PLP): 무한 스크롤 또는 표준 페이지네이션 레이아웃이 지속적인 상품 스캔에 더 적합한 경우.
  • 간단한 유틸리티 도구: 다중 창 레이아웃 쉘의 이점이 없는 단일 입력 유틸리티(예: 간단한 파일 변환기 또는 이미지 리사이저).

입력

  1. 워크스페이스 창 인벤토리: 애플리케이션에 필요한 공간 영역 목록(예: 사이드바 탐색, 상단바 작업 공간, 중앙 콘텐츠 워크스페이스, 오른쪽 속성 서랍).
  2. 대화형 컨트롤 레이아웃: 접을 수 있는 패널, 크기 조정 가능한 창, 트리거 영역에 대한 사양.
  3. 타이포그래피 및 간격 토큰: 깔끔한 정렬 그리드를 설정하기 위한 유동 타이포그래피 및 상대적 간격 시스템(fluid-spacing-system 및 fluid-typography-system).
  4. 목표 중단점: 패널 접기, 레일 축소, 모바일 서랍 전환을 결정하는 responsive-grid-system의 장치 레이아웃 정의.

출력

  1. 뷰포트 컨테이닝 청사진: 상위 차원을 100dvh로 고정하고 스크롤을 특정 하위 컨테이너로 격리하는 HTML 및 CSS 그리드/플렉스박스 공간 사양.
  2. 창 구성 사양: 탐색, 유틸리티 헤더, 워크스페이스를 분할하는 시각적 정의, 너비 제약 조건, 테두리선.
  3. 전환 및 모션 모델: 부드럽고 변화 없는 접이식 패널 전환을 위한 하드웨어 가속 CSS 애니메이션 지침(transform, opacity).
  4. 반응형 접기 규칙: 데스크톱, 태블릿, 모바일 뷰포트 범위에 걸친 레이아웃 적응을 상세히 설명하는 사양.
  5. 접근성 랜드마크 맵: 정의된 ARIA 역할 영역 및 키보드 탐색 흐름 매개변수.

워크플로우

1. 뷰포트 잠금 및 스크롤 컨테이닝 설정

메인 브라우저 뷰포트를 잠가 전체 페이지 스크롤 및 고무줄 현상을 방지합니다. 모든 레이아웃 구성 요소는 이 고정된 뷰포트 컨테이너 내에 맞아야 하며, 스크롤은 격리된 콘텐츠 창에만 엄격히 위임되어야 합니다.

  • 상위 컨테이너(예: .app-shell)를 width: 100vw 및 height: 100dvh(동적 뷰포트 높이)로 설정하고 overflow: hidden을 적용합니다.
  • 2계층 레이아웃 그리드를 사용하여 .app-shell을 분할합니다.
    • 계층 1 (외부 그리드): 왼쪽 사이드바와 오른쪽 콘텐츠 워크스페이스를 분리합니다.
    • 계층 2 (내부 그리드): 워크스페이스 상단바/헤더와 스크롤 가능한 콘텐츠 캔버스를 분리합니다.
  • 스크롤 가능한 창의 경우 overflow-y: auto와 -webkit-overflow-scrolling: touch를 적용하여 모바일 Safari에서 부드러운 관성 스크롤을 보장합니다.

2. 창 시각적 앵커 및 테두리 정의

시각적 혼란을 추가하지 않고 고밀도 대시보드를 구성하기 위해 명확한 시각적 경계를 사용합니다.

  • 테두리 분리: 지속적인 인접 패널 사이에 무거운 그림자 계층을 피합니다. 대신 깔끔하고 대비가 낮은 1px 테두리 구분선(예: 1px solid var(--border-neutral-muted))을 사용하여 섹션을 분할합니다.
  • 배경 대비: 미묘한 배경 음영 차이를 사용하여 탐색 영역과 활성 콘텐츠를 구분합니다. 탐색 사이드바는 약간 더 어둡거나 밝은 음영(예: 중성 색조)으로 설정하고, 메인 콘텐츠 워크스페이스는 깔끔한 캔버스 흰색 또는 진한 어두운 표면을 사용합니다.
  • 스크롤 그림자: 스크롤 콘텐츠 영역의 경우 상단 및 하단 가장자리 경계에 미묘한 선형 그라데이션 페이드 오버레이를 구현하여 접힌 부분 너머에 더 많은 콘텐츠가 있음을 사용자에게 시각적으로 알립니다.

3. 접이식 패널 메커니즘 설계

접이식 패널(사이드바 또는 오른쪽 상세 서랍 등)은 누적 레이아웃 이동 또는 시각적 저크 없이 부드럽게 상태를 변경해야 합니다.

  • 너비 전환 피하기: CSS width 애니메이션은 모든 프레임에서 모든 하위 요소의 레이아웃을 다시 계산하도록 브라우저에 강제하여 낮은 프레임 속도를 유발합니다.
  • 변환 선호: 사이드 서랍을 절대 위치 또는 캔버스 경계 밖에 배치하고 CSS transform: translateX()와 하드웨어 가속 전환을 결합하여 가시성을 애니메이션합니다.
  • 콘텐츠 마스킹: 포함하는 래퍼 블록에 overflow: hidden을 사용하여 슬라이딩 패널이 인접한 보기 뒤에서 깔끔하게 잘리도록 합니다.

4. 접근성 랜드마크 코딩 및 전달

대시보드 레이아웃 템플릿은 스크린 리더 및 키보드 사용자를 위해 구조화된 시맨틱 랜드마크 계층을 제공해야 합니다.

  • 랜드마크 할당: 각 창이 적절한 HTML5 시맨틱 태그에 매핑되도록 합니다.
    • 전역 탐색 사이드바: <nav aria-label="메인 탐색">
    • 워크스페이스 상단바 / 헤더: <header>
    • 중앙 워크스페이스: <main>
    • 속성 / 컨텍스트 서랍: <aside aria-label="속성 및 메타데이터">
  • 포커스 관리: 접이식 패널이 닫히면 프로그래밍 방식으로 포커스를 해당 패널을 닫은 트리거 버튼으로 이동합니다. 모바일 서랍이 열리면 해당 패널 내에서 키보드 탭 포커스를 가둡니다.
  • Inert 속성: 모달 패널 또는 모바일 사이드 서랍이 활성화된 경우 중앙 메인 패널에 inert HTML 속성을 토글하여 키보드 사용자가 실수로 보이는 화면 오버레이 밖으로 탭 이동하는 것을 방지합니다.

5. 반응형 적응 계획 (접기 규칙)

다양한 장치에서 대시보드 워크스페이스를 우아하게 확장합니다.

  • 데스크톱 범위 (>1200px): 다중 창 레이아웃이 완전히 확장됩니다. 왼쪽 탐색 사이드바 고정, 워크스페이스 헤더 고정, 중앙 캔버스 자동 스크롤, 오른쪽 속성 서랍 확장.
  • 태블릿 범위 (768px-1200px): 왼쪽 탐색 사이드바를 간결한 '레일'(아이콘만 표시)로 축소합니다. 오른쪽 속성 서랍을 고정 그리드 열에서 작업 버튼으로 트리거되는 오버레이 시트로 전환합니다.
  • 모바일 범위 (<768px): 사이드바와 속성 서랍을 모두 오버레이 서랍 뒤에 숨깁니다. 기본 레이아웃은 햄버거 메뉴 트리거, 작업 버튼, 격리된 스크롤 가능 콘텐츠 워크스페이스를 포함하는 모바일 상단바 헤더로 구성된 단일 열 보기로 단순화됩니다.

결정 규칙

쉘 구조를 위한 Grid vs. Flexbox

측면CSS Grid 사용CSS Flexbox 사용
주축2차원(행과 열이 모두 동적/고정).1차원(선형 행 스택 또는 열 스택).
레이아웃 목적외부 프레임 구조화(사이드바 열 + 메인 콘텐츠 열).내부 헤더 내용 정렬(로고 왼쪽 + 작업 오른쪽).
패널 접기사이드바 열이 동적으로 정확히 0 너비로 축소될 때.하위 항목이 자연스럽게 늘어나고 줄어들며 줄바꿈되어야 할 때.

스크롤 관리: 전역 스크롤 vs. 창별 스크롤

  • 전역 페이지 스크롤 (대시보드에서 사용 금지): 전체 헤더, 사이드바, 대시보드 프레임이 화면 밖으로 스크롤되어 사용자가 탐색에 접근하기 위해 다시 위로 스크롤해야 합니다.
  • 격리된 창 스크롤 (표준 대시보드 패턴): 외부 프레임워크(헤더, 레일, 작업)를 화면 가장자리에 완벽하게 고정하는 동시에 데이터 테이블, 차트 피드 또는 문서 편집기만 뷰포트 셀 내에서 독립적으로 스크롤합니다.

제약 사항

  • 동적 뷰포트 높이: 외부 상위 컨테이너에는 항상 vh(100vh) 대신 dvh 단위(100dvh)를 사용하세요. 모바일 브라우저에서 표준 vh 단위는 확장/축소되는 브라우저 크롬(주소 표시줄, 탐색 컨트롤)을 고려하지 않아 대시보드 하단이 도달 범위 밖으로 잘릴 수 있습니다.
  • 포커스 표시기: 대화형 패널 트리거에서 포커스 링이 매우 잘 보이도록 하세요. WCAG 2.2 대비 규칙을 충족해야 하며 overflow: hidden 컨테이너 가장자리로 잘려서는 안 됩니다.
  • 이중 스크롤바 없음: CSS calc() 또는 Flex/Grid 자동 제약 조건을 사용하여 컨테이너 여백, 패딩, 높이 경계를 정확히 계산하여 스크롤 창이 중첩된 이중 스크롤바를 나란히 트리거하지 않도록 합니다.
  • 터치 대상 최소 크기: 크기 조정 가능한 패널, 사이드바 확장 버튼, 탭 토글을 위한 핸들러는 최소 24x24px(WCAG 2.2 SC 2.5.8)의 터치 대상을 제공해야 하며, 44x44px가 선호됩니다.

일반적인 실패 패턴

  • 주소 표시줄 클리핑 (모바일): 모바일에서 100vh를 사용하여 사용자 프로필 바닥글 또는 사이드바 하단의 기본 제출 버튼이 모바일 브라우저 작업 표시줄 뒤에 숨겨집니다.
  • 레이아웃 트위치: 탐색 메뉴에서 width 속성을 애니메이션하여 축소 전환 중 메인 워크스페이스 내부의 카드, 차트, 그리드가 급격히 점프하고 다시 렌더링됩니다.
  • 스크롤 트랩 / 스크롤 누수: 열린 오버레이 창 내에서 스크롤 이벤트를 격리하지 못하여 사용자가 모바일 탐색 서랍에서 스와이프할 때 기본 배경 콘텐츠가 아래에서 스크롤됩니다.
  • 레이블이 지정되지 않은 스크롤 컨테이너: 페이지 컨테이너에 overflow: auto를 추가하면서 역할이나 키보드 포커스 경로를 제공하지 않아 키보드 전용 사용자가 해당 컨테이너 내의 데이터를 스크롤할 수 없습니다.
  • 이중 스크롤바 혼란: 엄격한 높이 제한 없이 중첩된 래퍼를 만들어 메인 브라우저 창과 내부 컨테이너 모두에 이중 스크롤바가 표시되어 탐색을 혼란스럽게 만듭니다.

검증 기준

  • 외부 레이아웃 컨테이너 높이가 100dvh(또는 대체 100vh)로 고정되고 기본 문서 overflow가 hidden으로 설정되었습니다.
  • 스크롤 데이터 목록 또는 워크스페이스와 상호 작용할 때 이중 스크롤바가 표시되지 않습니다.
  • 데스크톱, 태블릿, 모바일 범위에 걸쳐 적절한 서랍 및 레일 변환을 포함한 반응형 상태가 정의되었습니다.
  • 슬라이딩 패널 및 사이드바가 하드웨어 가속 CSS 속성(transform: translateX())을 사용하여 애니메이션됩니다.
  • 워크스페이스가 적절한 시맨틱 HTML5 랜드마크(<nav>, <header>, <main>, <aside>)를 사용합니다.
  • 모바일에서 오버레이 서랍 또는 패널이 열려 있을 때 배경 요소가 inert로 설정되거나 키보드 포커스 흐름에서 숨겨집니다.
  • 패널 트리거, 토글, 핸들의 터치 대상이 최소 크기 요구 사항 24x24px(44px 선호)를 충족합니다.
  • 활성 최상위 레이어 오버레이 시트 내에서 스와이프/스크롤할 때 비활성 배경 창 요소가 스크롤되지 않습니다(스크롤 누수 방지).

Individual skills in this repo

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

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

관련 스킬