프런트엔드 디자인 마스터클래스 v2.1
사용자와 공명하는 인터페이스를 구축하세요. 단순히 렌더링하는 것을 넘어 의도적이고 대담한 디자인을 강제합니다. 모든 픽셀은 그 존재를 정당화해야 합니다.
1. 핵심 스택
- 프레임워크: Runes(
$state,$derived,$effect)를 사용하는 SvelteKit 5 - 런타임: Bun (서버, 패키지)
- 백엔드/API: Hono (엣지 우선 라우트, 미들웨어)
- UI 원시 요소: shadcn-svelte (헤드리스, 완전 사용자 정의 가능). 모든 기본값을 재정의하세요.
- 차트: LayerChart (Layer Cake 기반, shadcn-svelte 차트 강화)
- 애니메이션: Svelte Motion (
@humanspeak/svelte-motion) - 복잡한 오케스트레이션용. 표준 모션에는 내장된svelte/transition및svelte/animate를 사용합니다. 간단한 루프에는 CSS 키프레임을 사용합니다. - Mermaid: Shiki와 호환되는 테마 SVG 렌더링을 위한
beautiful-mermaid - 스타일링: CSS 사용자 정의 속성으로 확장된 Tailwind CSS v4
- 테스팅: 시각적 회귀 테스트를 위한 Playwright
- 에셋: 생성적 이미지 및 텍스처를 위한 Nano Banana
- 배포: 정적 사이트용
@sveltejs/adapter-static, SSR용@sveltejs/adapter-vercel
2. 의도 식별 (리소스 로딩 전)
참조를 로드하기 전에 세 가지 차원에 걸쳐 요청을 분류합니다. 이는 이후의 모든 디자인 결정을 형성합니다.
A. 제품 유형
무엇을 구축하는지 식별합니다. 각 제품 유형은 스타일, 색상 및 레이아웃 규범을 의미합니다.
| 제품 카테고리 | 권장 스타일 | 색상 방향 |
|---|---|---|
| SaaS / B2B / 생산성 | 스위스 그리드, 플랫 + 글래스모피즘 | 신뢰 파랑 + 강조 대비 |
| 이커머스 / 소매 | 생동감 있는 블록, 기능이 풍부한 쇼케이스 | 브랜드 기본 + 성공 녹색 |
| 이커머스 럭셔리 | 리퀴드 글래스, 시네마틱 | 어두운 중성색 + 금/샴페인 강조 |
| 핀테크 / 암호화폐 | 데이터 밀집, 다크 모드 OLED | 진한 감청/차콜 + 네온 강조 |
| 헬스케어 / 웰니스 | 오가닉 플로우, 소프트 UI | 부드러운 청록/세이지 + 따뜻한 중성색 |
| 크리에이티브 / 포트폴리오 | 네오-브루탈리스트, 운동 타이포그래피 | 고대비 + 하나의 대담한 강조색 |
| 게임 / 엔터테인먼트 | 사이버펑크, HUD/Sci-Fi | 깊은 어두움 + 네온 다중 강조 |
| 교육 / 문서 | 편집용 넓은 시트, 미니멀 | 따뜻한 종이 + 잉크 계층 구조 |
| AI / ML 플랫폼 | 오로라 UI, 모션 기반 | 그라데이션 기본 + 어두운 표면 |
| 대시보드 / 분석 | 벤토 그리드, 데이터 밀집 | 중성 표면 + 의미론적 데이터 색상 |
이 표를 제약 조건이 아닌 출발점으로 사용하세요. 항상 사용자 정의하세요.
B. 스타일 의도
컨텍스트 단서, 명시적 요청 또는 제품 유형에서 미적 목표를 결정합니다.
전체 사양은 references/landing-pages.md 섹션 3에서 8가지 시대를 초월한 스타일을 확인하세요.
C. 대상 및 컨텍스트
누가 이것을 어디서 사용하는지 고려하세요. 엔터프라이즈 사용자는 밀집도를 용인하지만 일반 소비자 사용자는 여유 공간이 필요합니다. 모바일 우선은 터치 대상, 타이포그래피 크기 및 애니메이션 강도에 대한 모든 것을 변화시킵니다.
3. 리소스 로딩 프로토콜
의도를 식별한 후 요청에서 트리거 키워드를 스캔합니다. 일치하는 참조 파일을 references/에서 로드하여 깊은 구현 패턴에 액세스합니다.
랜딩 페이지 및 히어로 섹션
트리거: "랜딩 페이지", "히어로", "접는 선 위", "홈페이지", "사이트 제목",
"헤드라인", "CTA", "클릭 유도 문안", "전환", "첫인상"
로드: references/landing-pages.md
제공: 히어로 섹션 해부학, 8가지 시대를 초월한 랜딩 페이지 스타일(Apple Keynote,
Editorial Broadsheet, Geometric Playground, Cinematic Immersive, Swiss Grid,
Neo-Brutalist, Organic Flow, Retro Terminal), 시각적 흐름 패턴(Z/F/황금/대각선),
전환 아키텍처, 모바일 우선 히어로 전략, 코드 패턴.
타이포그래피 및 글꼴 선택
트리거: "글꼴", "타이포그래피", "서체", "제목", "텍스트 스타일", "글꼴 페어링",
"타입 스케일", "자간", "줄 높이", "읽기 쉬운", "디스플레이 글꼴"
로드: references/typography.md
제공: 디스플레이/본문/고정폭 글꼴 카탈로그 및 페어링 권장 사항, 타입 스케일
구성(수학적 비율), clamp()를 사용한 반응형 타이포그래피, 가변 글꼴,
글꼴 로딩 및 성능, 타이포그래피 세부 사항(트래킹, 행잉 구두점, 광학
정렬), 가독성 체크리스트.
색상 시스템 및 테마
트리거: "색상", "팔레트", "테마", "다크 모드", "라이트 모드", "강조",
"색상 구성", "브랜드 색상", "대비", "색조", "채도"
로드: references/color-system.md
제공: 구조화된 3그룹 팔레트 아키텍처(베이스 톤, 프라이머리 톤,
액센트 톤), 색상 이론 조화 모델, 팔레트 생성 워크플로우, 라이트 테마
구성, 다크 테마 구성(독립 규칙), 보너스 테마(따뜻함/차가움/단색/고대비 변형)가 있는 테마 선택기, 의미론적 색상 토큰, CSS 사용자 정의
속성 시스템, WCAG 대비 준수.
이미지, 텍스처 및 배경
트리거: "이미지", "배경", "텍스처", "사진", "일러스트레이션", "디더링",
"오버레이", "패럴랙스 배경", "히어로 이미지", "Nano Banana", "듀오톤", "패턴"
로드: references/imagery.md
제공: 이미지 역할 분류, 크기 및 형식 전략, 3계층 배경 구성,
디더링 알고리즘(Atkinson/Floyd-Steinberg/Bayer), 오버레이 및
기하학적 경계(대각선, clip-path 모양, 코너 마크, 그리드 오버레이),
이미지의 움직임, 예술적 스타일 선택(포토리얼리스틱/일러스트레이션/
생성적/혼합 미디어/듀오톤), 버튼 및 배너 이미지, Nano Banana 통합, AI 이미지
프롬프트 가이드.
데이터 그래픽, 테이블, 차트 및 인포그래픽
트리거: "테이블", "차트", "인포그래픽", "데이터", "통계", "메트릭",
"대시보드 KPI", "비교", "타임라인", "프로세스 흐름", "숫자 표시"
로드: references/data-graphics.md
제공: 기본값을 넘어서는 테이블 디자인(그리드 없는 테이블, 상태 표시기, 스파크라인
셀, 고정 헤더, 강조 기법), 차트 미학 및 스토리텔링(그라데이션
채우기, 글로우 효과, 주석, 그리드 대체), Mermaid 다이어그램 통합,
인포그래픽 패턴(숫자 블록, 타임라인, 비교 그리드, 프로세스 흐름),
데이터 시각 자료를 위한 AI 프롬프팅, 인쇄 준비 데이터 그래픽.
마이크로애니메이션 및 대화형 컨트롤
트리거: "애니메이션", "호버", "클릭", "버튼", "토글", "피드백", "리플",
"로딩", "스켈레톤", "전환", "스냅", "마그네틱", "스크롤 애니메이션",
"마이크로인터랙션", "반응형 컨트롤", "상태 전환", "폼 애니메이션"
로드: references/microanimations.md
제공: 완전한 5상태 버튼 시스템(기본/호버/활성/포커스/비활성화),
탐색 피드백(메뉴 항목, 햄버거, 탭 표시기), 스크롤 기반 애니메이션
(계단식 나타나기, 진행률 표시줄, 카운터 애니메이션), 폼 상호작용(플로팅 레이블,
유효성 검사 피드백, 사용자 정의 체크박스), 로딩 상태(스켈레톤, 성공/오류),
페이지 전환, 촉각적 느낌 패턴(누르기, 바운스, 카드 리프트, 리플), 스냅 및
마그네틱 동작, 성능 규칙, 이징 및 타이밍 참조 테이블.
시각적 모션 및 깊이
트리거: "3d", "깊이", "패럴랙스", "틸트", "가짜 3d", "공간적", "운동",
"모션", "글래스모피즘", "홀로그래픽"
로드: references/visual-kinetics.md
제공: 애니메이션 계층 시스템(CSS -> Svelte -> Svelte Motion -> GSAP), 홀로그래픽
틸트 카드(글레어 포함), Nano Banana 레이어가 있는 패럴랙스 히어로, 글래스모피즘 2.0, 운동
타이포그래피(마스크 표시, 마키, 분할 텍스트), 스크롤 트리거 표시, 물리 기반
이징, 마그네틱 버튼, 성능 체크리스트.
데이터 시각화(차트 및 대시보드)
트리거: "layerchart", "차트 컴포넌트", "대시보드 레이아웃", "벤토 그리드",
"스파크라인", "실시간", "네온 차트", "편집용 차트"
로드: references/data-visualization.md
제공: LayerChart 합성 가능 패턴, shadcn-svelte 차트 통합, 차트
미적 모드(네온/편집용/미니멀), 테이블 스타일링 레시피, Bento 그리드 대시보드
레이아웃, 스파크라인, 실시간 데이터 패턴, 폴백 라이브러리.
다이어그램(Mermaid)
트리거: "mermaid", "다이어그램", "순서도", "시퀀스 다이어그램", "아키텍처 다이어그램"
로드: references/mermaid-theming.md
제공: beautiful-mermaid 설정 및 테마, Shiki 통합, 기본 Mermaid
themeVariables 매핑, SVG 후처리(텍스처 오버레이, 그림자, 테두리),
SvelteKit 컴포넌트 패턴, 다이어그램 유형별 스타일링 참고 사항, 인쇄 고려 사항.
여러 트리거가 감지되면 관련 참조를 모두 로드합니다. 트리거가 없으면 아래의 범용 명령을 직접 적용합니다.
4. 안티-슬롭 명령
LLM은 훈련 데이터의 높은 확률 "안전한" 설계 패턴으로 수렴하는 경향이 있습니다. 이것은 분포 수렴입니다. 의도적으로 싸우세요.
거부: 있는 그대로 제공되는 Bootstrap/Tailwind 기본값, Inter/Roboto/Arial/시스템 글꼴, 흰색 바탕에 보라색 색 구성표, 예측 가능한 카드 그리드, 판에 박은 듯한 히어로 섹션, 모든 것을 중앙에 배치하는 레이아웃, 스톡 사진, 일반 그라데이션, UI의 이모지 아이콘, 매직 넘버 간격, 보이지 않는 호버 상태, 호버 시 레이아웃을 변경하는 크기 변환, 투명도가 30% 미만인 라이트 모드 유리 카드, gray-500 대비 이하의 흐릿한 텍스트.
수용: 의도적인 타이포그래피 계층 구조, 비대칭 구성, 분위기 있는 깊이, 운동 피드백, 편집용 그리드, 기하학적 눈길 유도선, 인쇄 준비 정밀도, 색상 이론을 기반으로 구축된 사용자 정의 색상 팔레트, 독특한 글꼴 페어링, SVG 아이콘 시스템(Lucide, Heroicons)과 일관된 viewBox, 모든 클릭 가능한 요소에 cursor-pointer, 레이아웃을 방해하는 변환이 아닌 색상/투명도를 사용하는 안정적인 호버 상태.
5. 디자인 사고 (코드 작성 전)
코드를 작성하기 전에 방향을 결정하세요:
- 목적: 이것은 무엇을 해결합니까? 누가 사용합니까?
- 제품 유형: 초기 방향을 위해 섹션 2A의 표를 사용하여 분류합니다.
- 미적 톤: 하나를 선택하고 완전히 헌신하세요. 검증된 8가지 스타일에 대해서는
references/landing-pages.md섹션 3을 참조하세요. 또는 하이브리드를 발명하세요. - 색상 방향: 기본 색조를 선택하고 색상 이론 조화를 통해 강조색을 도출하세요.
전체 워크플로우는
references/color-system.md섹션 3을 참조하세요. - 타이포그래피:
references/typography.md카탈로그에서 디스플레이 + 본문 + 고정폭 세 가지를 선택하세요. - 기억에 남는 세부 사항: 사용자가 기억할 하나의 요소를 식별하세요.
- 복잡성 일치: 맥시멀리스트 = 정교한 코드. 미니멀리스트 = 수술적 정밀함.
6. 범용 미적 명령
타이포그래피
독특하고 개성 있는 페어링을 선택하세요. Google Fonts 또는 Fontsource에서 로드하세요.
전체 글꼴 카탈로그 및 페어링 전략은 references/typography.md를 참조하세요.
크게 수정하지 않는 한 Inter, Roboto, Open Sans, Lato 또는 기본 시스템 글꼴을 절대 사용하지 마세요.
여러 세대에 걸쳐 Space Grotesk로 수렴하지 마세요.
색상 (구조화된 팔레트)
3그룹 팔레트를 구축하세요: 베이스 톤, 프라이머리 톤, 액센트 톤.
전체 시스템은 references/color-system.md를 참조하세요.
라이트 테마: 단단한 그림자, 무거운 타이포그래피, 가는 선.
다크 테마: 유색 글로우, 오프-화이트 텍스트(#E8E8E8), 미묘한 표면 그라데이션.
순수한 보라색(H: 270-280)을 기본 색상으로 절대 사용하지 마세요. 인디고, 청록, 산호 또는 에메랄드로 전환하세요.
이미지 및 텍스처
히어로 섹션에 평평한 단색 배경을 절대 사용하지 마세요.
3계층 구성 기술, 디더링 알고리즘 및 Nano Banana 통합 패턴은 references/imagery.md를 참조하세요.
마이크로애니메이션 (필수)
모든 대화형 요소는 모션 피드백을 제공해야 합니다.
전체 5상태 버튼 시스템, 스크롤 기반 애니메이션 및 촉각적 느낌 패턴은 references/microanimations.md를 참조하세요.
공간 구성
수직 비계, 비대칭, 여백, 그리드를 깨는 요소.
시각적 흐름 패턴은 references/landing-pages.md 섹션 4를 참조하세요.
접근성 (논의 불가)
- 의미론적 HTML:
<article>,<section>,<nav>,<aside>,<main> - 포커스 상태: 절대
outline: none.outline: 2px solid var(--accent); outline-offset: 4px로 스타일 지정 - WCAG AA 대비 최소 기준.
references/color-system.md섹션 9 참조. - 모든 사용자 정의 대화형 컴포넌트에 ARIA 레이블
prefers-reduced-motion: 패럴랙스, 틸트, 복잡한 애니메이션 비활성화- 색상이 상태의 유일한 표시자가 되어서는 안 됩니다.
- 모든 이미지에는 대체 텍스트가 필요합니다. 폼 입력에는 레이블이 필요합니다.
인쇄 및 PDF
@media print가 활성화되면 사이트는 인쇄 가능한 보고서로도 기능해야 합니다.
탐색/바닥글/버튼을 숨기고, 흰색 배경을 강제하고, SVG 차트를 유지하고,
카드/차트/테이블에 break-inside: avoid를 사용하세요.
7. 구현 워크플로우
- 식별: 제품 유형, 스타일 의도, 대상을 분류합니다(섹션 2).
- 로드: 리소스 트리거를 스캔합니다. 관련 참조 파일을 로드합니다(섹션 3).
- 조사: 복잡한 빌드의 경우 유사한 수상 경력에 빛나는 사이트, 패턴 및 라이브러리 기능에 대해 심층 조사(최대 10회 웹 검색)를 수행합니다.
- 설계: SvelteKit 파일 구조를 계획합니다. CSS 변수 토큰을 정의합니다.
- 코딩: 의미론적 HTML, 확장된 Tailwind, Svelte 5 Runes를 작성합니다. 프로덕션 준비 완료, 플레이스홀더 없음.
- 다듬기: 마이크로애니메이션, 텍스처 레이어, 호버 상태, 스크롤 트리거를 적용합니다.
- 검증: 사전 전달 체크리스트(섹션 8)를 실행합니다. 모든 실패를 수정합니다.
- 반복: 미적 비전과 비교합니다. 돋보일 때까지 조정합니다.
8. 사전 전달 체크리스트
UI 코드를 전달하기 전에 이것을 실행하세요. 모든 항목은 알려진 실패 모드입니다.
시각적 품질
- UI 아이콘으로 이모지를 사용하지 않음(Lucide 또는 Heroicons SVG 사용)
- 모든 아이콘은 일치하는 viewBox(24x24)가 있는 단일 일관된 세트에서 가져옴
- 브랜드 로고가 공식 출처(Simple Icons)에 대해 확인됨
- 호버 상태가 레이아웃 변경을 일으키지 않음(크기 변환이 아닌 투명도/색상 사용)
- 사용자 정의 없이 기본 Tailwind 색상 클래스를 사용하지 않음
- 타이포그래피 페어링이 의도적이고 로드됨(시스템 폴백 아님)
상호작용
- 모든 클릭 가능한 요소에
cursor-pointer가 있음 - 모든 대화형 요소에 눈에 보이는 호버 피드백이 있음
- 전환은 150-300ms 지속 시간 사용(UI의 경우 절대 500ms 초과, 절대 0ms 아님)
- 포커스 상태가 보이고 스타일 지정됨(브라우저 기본값이 아니며 절대 제거되지 않음)
- 모바일에서 터치 대상은 최소 44x44px
라이트/다크 모드
- 라이트 모드: 텍스트 대비가 WCAG AA를 통과함
- 다크 모드: 오프-화이트 텍스트(#E8E8E8), 유색 글로우, 미묘한 그라데이션
- 테마 전환 시
<html>에data-theme속성 추가 - 윈도우 콘솔에서 테마 전환 확인(화면 깜빡임 없음)
반응형
- 레이아웃: 데스크톱 >768px, 모바일 <=768px에서 테스트 완료
- 모바일에서 타이포그래피가 줄 바꿈 처리됨(오버플로우나 자르기 없음)
- 테이블: 모바일에서 카드 레이아웃(가로 스크롤 없음) 또는 전용 반응형 테이블
- 데스크톱에서 콘텐츠가 뷰포트 높이를 채우지 못할 때 바닥글이 바닥에 고정됨
성능
- 이미지: WebP/AVIF 형식, lazy loading(lazy loading), 적절한 크기
- 글꼴:
font-display: swap사용, 필요한 굵기만 로드(4개 이하) - 레이아웃 전환 억제: 호버 변환에
transform: translateX/Y사용(X/Z가 아닌),will-change는 최소한으로 사용 - 애니메이션: 60fps 유지,
transform및opacity만 애니메이션화
코드 품질
- 모든 Svelte 5 Runes가 올바른 범위를 가짐(
$state는 로컬,$derived는 순수) - 사용자 정의 이벤트가 표준
onclick,onmouseenter등을 따름 - 스타일이 범위 지정됨(Svelte
<style>블록에서:global()은 신중하게 사용) - Tailwind:
@apply디렉티브 없음(구성 파일 확장 사용) - 빌드 오류 없음:
bun run build성공
9. 에러 상태 모범 사례
로딩 상태
- 스켈레톤:
radial-gradient()또는 CSS::before의사 요소로 불규칙한 블록 지원 - 스켈레톤에
skeleton-shimmer와 같은 부드러운 CSS 애니메이션 적용 - 카드 그리드와 같은 반복 레이아웃에
--skeleton-cols,--skeleton-rowsCSS 변수 사용 - 텍스트: 플레이스홀더의 너비 변형 사용 (다양한 콘텐츠 길이 시뮬레이션)
- 이미지: 색조가 적용된 흐림 효과 플레이스홀더(이미지 색상 평균) 또는 지연 로딩 시 저해상도 미리보기
빈 상태
- 작업 가능한 빈 상태: 첫 번째 방문자를 위한 안내 UI 제공
- 새 프로젝트의 보드: "새 열 추가" 버튼을 포함한 안내된 보드 초안
- 비어 있는 피드: 피드를 채우기 위한 제안된 작업(팔로우, 가입 등)
- 빈 데이터 상태: 빈 데이터와 빈 레이아웃의 차이점 표시
- "아직 기록이 없습니다": 데이터가 존재할 수 있지만 선택 항목과 일치하지 않음
- "아직 아무것도 없습니다": 시스템이 아직 데이터를 수신하지 않음
- 로그인 필요 상태: 비인증 사용자에게 가치 제안 표시
- 기능에 대한 스크린샷/미리보기
- "시작하기" CTA
- 이미 계정이 있는 경우 "로그인" 링크
오류 상태
- 오류 유형별 전용 피드백:
- 네트워크 오류: "연결이 끊어졌습니다" + 재시도 버튼 + 오프라인 표시기
- 검증 오류: 인라인(필드 수준) + 상단 요약(양식 수준)
- 권한 오류: 차단된 작업에 대한 명확한 이유 + 액세스 요청 방법
- 오류 메시지는 구체적이고 실행 가능해야 함:
- 불량: "오류가 발생했습니다"
- 양호: "결제를 처리할 수 없습니다. 은행에 문의하거나 다른 카드를 사용하세요"
- 오류 발생 시 중요한 사용자 데이터 보존(뒤로 가기 시 양식 데이터 재설정 안 함)
- 심각한 오류에 대한
onerror핸들러로 JavaScript 오류 포착
엣지 케이스
- 매우 긴 텍스트:
text-overflow: ellipsis가 있는 카드 제목,overflow-wrap: break-word가 있는 단락 - 매우 큰 숫자: 지표에 로케일 인식 형식(예:
Intl.NumberFormat)을 사용한 생략된 표시(1.2M, 45.7K 등) - 특수 문자 및 유니코드: 텍스트 렌더링이 깨지지 않도록 시스템 글꼴 폴백이 있는
font-family - 축소된 뷰포트: 극단적인 뷰포트(예: <320px)용 미디어 쿼리, 바닥글 숨기기 또는 재구성
- print 미디어: 인쇄된 보고서의 일관된 모양을 위해