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)

.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

.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

.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)

.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)

.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)

.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

.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

.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.