← 목록으로
디자인-개발 핸드오프 문서
스펙 템플릿, 컴포넌트 문서화
프로젝트 개요
목적
랜딩 페이지의 히어로 섹션을 현대적인 디자인으로 개선하여 전환율을 높이고
사용자 경험을 향상시킵니다. 반응형 디자인과 접근성을 고려한 구현이 필요합니다.
컴포넌트 스펙
.btn-primary {
height: 48px;
padding: 0 28px;
background: #4F46E5;
color: #FFFFFF;
font-size: 16px;
font-weight: 600;
border: none;
border-radius: 8px;
cursor: pointer;
transition: all 0.2s;
}
.btn-primary:hover {
background: #4338ca;
}
.btn-primary:active {
background: #3730a3;
}
.btn-primary:disabled {
opacity: 0.5;
cursor: not-allowed;
}
⚠️ 구현 주의사항
- 터치 디바이스를 위해 최소 높이 44px 유지
- 포커스 상태에 2px ring 추가 (접근성)
- 로딩 상태 시 스피너 아이콘 표시
Shadow (hover)
0 10px 15px rgba(0,0,0,0.1)
카드 제목
카드 내용이 들어갑니다. 간략한 설명을 포함합니다.
레이아웃 스펙
그리드
2열 (Desktop), 1열 (Mobile)
히어로 제목
설명 텍스트가 들어갑니다.
.hero-section {
max-width: 1280px;
margin: 0 auto;
padding: 96px 32px;
background: #f9fafb;
}
.hero-grid {
display: grid;
grid-template-columns: 1fr 1fr;
gap: 48px;
align-items: center;
}
@media (max-width: 768px) {
.hero-section {
padding: 64px 20px;
}
.hero-grid {
grid-template-columns: 1fr;
gap: 32px;
}
}
에셋 및 리소스
다운로드 가능한 파일
-
hero-background.svg
SVG • 45KB • 1920×1080
-
icon-set.zip
ZIP • 2.3MB • 50 icons
-
logo-variants.sketch
Sketch • 1.2MB
-
design-tokens.json
JSON • 12KB • Colors, Typography, Spacing
## 98. 디자인-개발 핸드오프 문서
```
Create a comprehensive design-to-development handoff document:
**Document Structure**:
```
📄 Design Handoff: [Feature Name]
├── 1. Overview
├── 2. Design Specifications
├── 3. Component Breakdown
├── 4. Responsive Behavior
├── 5. Interactive States
├── 6. Animations
├── 7. Assets
├── 8. Accessibility
└── 9. Edge Cases
```
**1. Overview Section**:
```markdown
# Homepage Hero Redesign
## Summary
Redesigned hero section with new gradient background,
updated typography, and improved CTA visibility.
## Links
- Design File: [Pencil.dev/Figma Link]
- Prototype: [Interactive Prototype Link]
- Related Ticket: JIRA-1234
- Design System: [Storybook Link]
## Team
- Designer: @designer-name
- Developer: @developer-name
- Due Date: Feb 15, 2026
- Status: Ready for Development
```
**2. Design Specifications**:
```markdown
## Layout
### Container
- Max-width: 1280px
- Padding: 0 32px (desktop), 0 16px (mobile)
- Background: Linear gradient 135deg, #667eea → #764ba2
### Grid
- Desktop: 12 columns, 24px gutter
- Content area: 6 columns left, 6 columns right
- Mobile: Single column, stacked
### Spacing
- Section padding: 96px top/bottom (desktop), 64px (mobile)
- Content gap: 48px between text and image
- Element spacing: See spacing diagram below
## Typography
| Element | Font | Size | Weight | Line Height | Color |
|------------|-------------|------|--------|-------------|---------|
| Headline | Inter | 56px | 700 | 1.1 | #FFFFFF |
| Subhead | Inter | 20px | 400 | 1.6 | #E2E8F0 |
| CTA Text | Inter | 16px | 600 | 1.0 | #FFFFFF |
## Colors
- Background gradient: #667eea → #764ba2
- Primary text: #FFFFFF
- Secondary text: #E2E8F0 (slate-200)
- CTA button: #FFFFFF bg, #667eea text
- CTA hover: #F1F5F9 bg
```
**3. Component Breakdown**:
```markdown
## Components Used
### 1. Hero Container
- Full-width wrapper
- Gradient background
- Min-height: 600px
### 2. Headline (existing: Typography/Heading)
- Variant: h1
- Color: white
- Props: { level: 1, color: 'white' }
### 3. CTA Button (existing: Button)
- Variant: primary-inverted
- Size: lg
- Props: { variant: 'primary-inverted', size: 'lg' }
### 4. Hero Image (new component)
- Floating illustration
- Dimensions: 480x480px
- Animation: Float up/down 6s ease-in-out infinite
```
**4. Responsive Behavior**:
```markdown
## Breakpoints
### Desktop (≥1024px)
- Two-column layout (50/50)
- Headline: 56px
- Full illustration visible
### Tablet (768px - 1023px)
- Two-column layout (60/40)
- Headline: 48px
- Illustration slightly smaller
### Mobile (<768px)
- Single column, stacked
- Headline: 36px
- Image above text (order reversed)
- CTA full-width
## Responsive Diagram
┌─────────────────────────────────────┐
│ Desktop (≥1024px) │
│ ┌───────────┬───────────┐ │
│ │ Text │ Image │ │
│ │ Block │ Block │ │
│ └───────────┴───────────┘ │
└─────────────────────────────────────┘
┌─────────────────────────────────────┐
│ Mobile (<768px) │
│ ┌───────────────────────┐ │
│ │ Image │ │
│ ├───────────────────────┤ │
│ │ Text │ │
│ │ Block │ │
│ │ [Full CTA] │ │
│ └───────────────────────┘ │
└─────────────────────────────────────┘
```
**5. Interactive States**:
```markdown
## Button States
| State |
... (내용이 길어 일부만 표시됩니다)