AudiOhm/design-system/pages/home.md

# Home Page Design Override

## Purpose
This file contains **page-specific design rules** that **override** the master design system for the Home page.

## Key Differences from Master

### Layout Structure
- **Hero Section**: Full-width gradient banner with quick picks
- **Horizontal scrolling sections** for album/playlist rows
- **Grid layout** for featured content (3 columns desktop, 2 tablet, 1 mobile)
- **Sticky sub-navigation** for content categories

### Visual Hierarchy
1. **Greeting & Quick Picks** (hero section) - Highest prominence
2. **Featured Playlists** - Large cards with gradients
3. **Recently Played** - Horizontal scroll row
4. **Made For You** - Grid of recommendation cards
5. **New Releases** - Compact list view

### Section Spacing
- Hero padding: **60px** (larger than master)
- Section gaps: **48px** (between major sections)
- Row padding: **24px** (within sections)

## Components

### Hero Section (Personalized Greeting)

```css
.hero-section {
  position: relative;
  background: linear-gradient(135deg, #0A0E27 0%, #151932 50%, #1F2342 100%);
  padding: 60px 40px;
  border-radius: 20px;
  margin-bottom: 48px;
  overflow: hidden;
}

/* Animated background gradient */
.hero-section::before {
  content: '';
  position: absolute;
  inset: 0;
  background: radial-gradient(circle at 20% 50%, rgba(0, 240, 255, 0.1) 0%, transparent 50%),
              radial-gradient(circle at 80% 50%, rgba(191, 0, 255, 0.1) 0%, transparent 50%);
  animation: gradient-shift 10s ease-in-out infinite;
}

@keyframes gradient-shift {
  0%, 100% { opacity: 1; }
  50% { opacity: 0.6; }
}

.hero-content {
  position: relative;
  z-index: 1;
}

.hero-greeting {
  font-size: 32px;
  font-weight: 700;
  color: #F0F4F8;
  margin-bottom: 24px;
}

.hero-subtitle {
  font-size: 18px;
  font-weight: 400;
  color: #9BA3B8;
  margin-bottom: 32px;
}
```

### Quick Picks Grid

```css
.quick-picks-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
  gap: 20px;
}

.quick-pick-card {
  aspect-ratio: 16/9;
  background: linear-gradient(135deg, rgba(0, 240, 255, 0.1) 0%, rgba(191, 0, 255, 0.1) 100%);
  border-radius: 16px;
  padding: 24px;
  display: flex;
  flex-direction: column;
  justify-content: flex-end;
  cursor: pointer;
  transition: all 250ms ease;
  border: 1px solid transparent;
  position: relative;
  overflow: hidden;
}

.quick-pick-card:hover {
  border-color: #00F0FF;
  transform: translateY(-4px);
  box-shadow: 0 12px 40px rgba(0, 240, 255, 0.2);
}

.quick-pick-card::before {
  content: '';
  position: absolute;
  inset: 0;
  background: radial-gradient(circle at var(--mouse-x, 50%) var(--mouse-y, 50%), rgba(0, 240, 255, 0.15), transparent 50%);
  opacity: 0;
  transition: opacity 250ms ease;
}

.quick-pick-card:hover::before {
  opacity: 1;
}

.quick-pick-title {
  font-size: 24px;
  font-weight: 600;
  color: #F0F4F8;
  margin-bottom: 8px;
}

.quick-pick-description {
  font-size: 14px;
  font-weight: 400;
  color: #9BA3B8;
}
```

### Horizontal Scroll Rows

```css
.section-row {
  margin-bottom: 48px;
}

.section-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  margin-bottom: 24px;
}

.section-title {
  font-size: 28px;
  font-weight: 700;
  color: #F0F4F8;
}

.see-all-link {
  font-size: 14px;
  font-weight: 600;
  color: #00F0FF;
  text-decoration: none;
  cursor: pointer;
  transition: opacity 200ms ease;
}

.see-all-link:hover {
  opacity: 0.8;
}

/* Horizontal scroll container */
.horizontal-scroll {
  display: flex;
  gap: 20px;
  overflow-x: auto;
  scroll-snap-type: x mandatory;
  padding-bottom: 8px;
  scrollbar-width: thin;
  scrollbar-color: #2A2F4A #0A0E27;
}

.horizontal-scroll::-webkit-scrollbar {
  height: 8px;
}

.horizontal-scroll::-webkit-scrollbar-track {
  background: #0A0E27;
  border-radius: 4px;
}

.horizontal-scroll::-webkit-scrollbar-thumb {
  background: #2A2F4A;
  border-radius: 4px;
}

.horizontal-scroll::-webkit-scrollbar-thumb:hover {
  background: #00F0FF;
}

.scroll-item {
  flex: 0 0 200px;
  scroll-snap-align: start;
}
```

### Album/Playlist Cards (Grid)

```css
.content-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
  gap: 24px;
}

.content-card {
  cursor: pointer;
  transition: all 250ms ease;
}

.content-card-image {
  width: 100%;
  aspect-ratio: 1/1;
  object-fit: cover;
  border-radius: 12px;
  margin-bottom: 12px;
  box-shadow: 0 4px 20px rgba(0, 0, 0, 0.3);
  transition: all 250ms ease;
}

.content-card:hover .content-card-image {
  box-shadow: 0 8px 30px rgba(0, 240, 255, 0.3);
  transform: translateY(-4px);
}

.content-card-title {
  font-size: 16px;
  font-weight: 600;
  color: #F0F4F8;
  margin-bottom: 4px;
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}

.content-card-subtitle {
  font-size: 14px;
  font-weight: 400;
  color: #9BA3B8;
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}

/* Play overlay on hover */
.play-overlay {
  position: absolute;
  top: 12px;
  left: 12px;
  right: 12px;
  aspect-ratio: 1/1;
  background: rgba(10, 14, 39, 0.8);
  border-radius: 12px;
  display: flex;
  align-items: center;
  justify-content: center;
  opacity: 0;
  transition: opacity 200ms ease;
}

.content-card:hover .play-overlay {
  opacity: 1;
}
```

### Featured Playlist Card (Large)

```css
.featured-card {
  background: linear-gradient(135deg, var(--gradient-start) 0%, var(--gradient-end) 100%);
  border-radius: 20px;
  padding: 32px;
  min-height: 250px;
  display: flex;
  flex-direction: column;
  justify-content: flex-end;
  cursor: pointer;
  transition: all 300ms ease;
  position: relative;
  overflow: hidden;
}

.featured-card::before {
  content: '';
  position: absolute;
  inset: 0;
  background: radial-gradient(circle at 80% 20%, rgba(255, 255, 255, 0.1) 0%, transparent 50%);
}

.featured-card:hover {
  transform: translateY(-8px);
  box-shadow: 0 16px 50px rgba(0, 0, 0, 0.4);
}

.featured-card-tag {
  position: absolute;
  top: 24px;
  left: 24px;
  background: rgba(10, 14, 39, 0.6);
  backdrop-filter: blur(10px);
  padding: 6px 12px;
  border-radius: 6px;
  font-size: 12px;
  font-weight: 600;
  color: #00F0FF;
  text-transform: uppercase;
  letter-spacing: 0.5px;
}

.featured-card-title {
  font-size: 32px;
  font-weight: 700;
  color: #F0F4F8;
  margin-bottom: 8px;
}

.featured-card-description {
  font-size: 16px;
  font-weight: 400;
  color: rgba(240, 244, 248, 0.8);
  max-width: 80%;
}
```

### Category Pills (Filter Bar)

```css
.category-filter-bar {
  display: flex;
  gap: 12px;
  padding: 20px 0;
  overflow-x: auto;
  scrollbar-width: none;
}

.category-filter-bar::-webkit-scrollbar {
  display: none;
}

.category-pill {
  padding: 10px 20px;
  background: rgba(21, 25, 50, 0.8);
  border: 1px solid #2A2F4A;
  border-radius: 24px;
  font-size: 14px;
  font-weight: 500;
  color: #9BA3B8;
  cursor: pointer;
  transition: all 200ms ease;
  white-space: nowrap;
}

.category-pill:hover {
  border-color: #00F0FF;
  color: #00F0FF;
}

.category-pill.active {
  background: linear-gradient(135deg, #00F0FF 0%, #00C8FF 100%);
  border-color: #00F0FF;
  color: #0A0E27;
  box-shadow: 0 4px 16px rgba(0, 240, 255, 0.4);
}
```

## Responsive Adjustments

### Mobile (< 768px)
- Hero padding: 40px 20px
- Hero greeting: 24px
- Quick picks: 1 column (100% width)
- Content grid: 2 columns (repeat(2, 1fr))
- Horizontal scroll: Enable momentum scroll
- Section title: 22px

### Tablet (768px - 1024px)
- Hero padding: 50px 30px
- Quick picks: 2 columns
- Content grid: 3 columns (repeat(3, 1fr))
- Section title: 26px

### Desktop (> 1024px)
- Use default sizes above
- Quick picks: 4 columns
- Content grid: 6 columns

## Loading States

### Skeleton Cards

```css
.skeleton-card {
  background: linear-gradient(90deg, #151932 25%, #1F2342 50%, #151932 75%);
  background-size: 200% 100%;
  animation: skeleton-loading 1.5s ease-in-out infinite;
  border-radius: 12px;
}

@keyframes skeleton-loading {
  0% { background-position: 200% 0; }
  100% { background-position: -200% 0; }
}

.skeleton-image {
  width: 100%;
  aspect-ratio: 1/1;
  border-radius: 12px;
  margin-bottom: 12px;
}

.skeleton-text {
  height: 16px;
  background: #1F2342;
  border-radius: 4px;
  margin-bottom: 8px;
}

.skeleton-text.short {
  width: 60%;
}

.skeleton-text.long {
  width: 90%;
}
```

## Empty States

```css
.empty-state {
  display: flex;
  flex-direction: column;
  align-items: center;
  justify-content: center;
  padding: 80px 40px;
  text-align: center;
}

.empty-state-icon {
  width: 80px;
  height: 80px;
  color: #2A2F4A;
  margin-bottom: 24px;
}

.empty-state-title {
  font-size: 24px;
  font-weight: 600;
  color: #F0F4F8;
  margin-bottom: 12px;
}

.empty-state-description {
  font-size: 16px;
  font-weight: 400;
  color: #9BA3B8;
  margin-bottom: 32px;
  max-width: 400px;
}
```

## Additional Anti-Patterns for Home

❌ **NEVER load all content at once** - Implement lazy loading for rows
❌ **NEVER auto-play audio on home** - User must explicitly click play
❌ **NEVER mix card sizes in same row** - Keep consistent sizing
❌ **NEVER hide horizontal scroll indicators** - Show shadow hint
❌ **NEVER use generic greetings** - Personalize with time of day
❌ **NEVER skip section anchors** - Allow deep linking to sections

---

*These page-specific rules override the master design system for the home page only.*