# Search Page Design Override

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

## Key Differences from Master

### Layout Structure
- **Large, prominent search bar** at top (72px height)
- **Search tabs** (All, Songs, Artists, Albums, Playlists)
- **Results grid** (responsive: 6 col desktop, 4 tablet, 2 mobile)
- **Recent searches** with clear button
- **Trending searches** as suggestions

### Visual Hierarchy
1. **Search Input** - Dominant, focused element
2. **Search Tabs** - Secondary navigation
3. **Results Count** - Tertiary info
4. **Filter/Sort Controls** - Quaternary

### Search Bar Styling
- Larger height (48px input, vs 40px in master)
- Prominent search icon
- Clear button appears on type
- Recent searches dropdown

## Components

### Search Input Field

```css
.search-container {
  position: sticky;
  top: 0;
  background: rgba(10, 14, 39, 0.95);
  backdrop-filter: blur(20px);
  padding: 20px 0;
  z-index: 20;
  border-bottom: 1px solid #2A2F4A;
}

.search-input-wrapper {
  position: relative;
  max-width: 800px;
  margin: 0 auto;
}

.search-input {
  width: 100%;
  height: 56px;
  background: #151932;
  border: 2px solid #2A2F4A;
  border-radius: 28px;
  padding: 0 60px 0 60px;
  font-size: 18px;
  font-weight: 400;
  color: #F0F4F8;
  transition: all 200ms ease;
}

.search-input::placeholder {
  color: #6B7280;
}

.search-input:focus {
  outline: none;
  border-color: #00F0FF;
  box-shadow: 0 0 0 4px rgba(0, 240, 255, 0.1);
  background: #1F2342;
}

.search-input-icon {
  position: absolute;
  left: 20px;
  top: 50%;
  transform: translateY(-50%);
  width: 24px;
  height: 24px;
  color: #6B7280;
  pointer-events: none;
  transition: color 200ms ease;
}

.search-input:focus + .search-input-icon {
  color: #00F0FF;
}

.search-clear-button {
  position: absolute;
  right: 16px;
  top: 50%;
  transform: translateY(-50%);
  width: 32px;
  height: 32px;
  background: #2A2F4A;
  border: none;
  border-radius: 50%;
  display: flex;
  align-items: center;
  justify-content: center;
  cursor: pointer;
  opacity: 0;
  visibility: hidden;
  transition: all 200ms ease;
}

.search-input:not(:placeholder-shown) + .search-input-icon ~ .search-clear-button {
  opacity: 1;
  visibility: visible;
}

.search-clear-button:hover {
  background: #3B4259;
}
```

### Search Tabs

```css
.search-tabs {
  display: flex;
  gap: 8px;
  padding: 20px 0;
  overflow-x: auto;
  scrollbar-width: none;
}

.search-tabs::-webkit-scrollbar {
  display: none;
}

.search-tab {
  padding: 10px 20px;
  background: transparent;
  border: none;
  border-radius: 20px;
  font-size: 14px;
  font-weight: 500;
  color: #9BA3B8;
  cursor: pointer;
  transition: all 200ms ease;
  white-space: nowrap;
}

.search-tab:hover {
  color: #F0F4F8;
  background: rgba(240, 244, 248, 0.05);
}

.search-tab.active {
  background: #F0F4F8;
  color: #0A0E27;
  font-weight: 600;
}
```

### Recent Searches

```css
.recent-searches-section {
  padding: 32px 0;
}

.recent-searches-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  margin-bottom: 20px;
}

.recent-searches-title {
  font-size: 20px;
  font-weight: 600;
  color: #F0F4F8;
}

.clear-recent-button {
  font-size: 14px;
  font-weight: 500;
  color: #00F0FF;
  background: transparent;
  border: none;
  cursor: pointer;
  transition: opacity 200ms ease;
}

.clear-recent-button:hover {
  opacity: 0.8;
}

.recent-search-item {
  display: flex;
  align-items: center;
  gap: 16px;
  padding: 16px 20px;
  background: #151932;
  border-radius: 12px;
  cursor: pointer;
  transition: all 200ms ease;
  border: 1px solid transparent;
}

.recent-search-item:hover {
  background: #1F2342;
  border-color: #2A2F4A;
}

.recent-search-icon {
  width: 20px;
  height: 20px;
  color: #6B7280;
  flex-shrink: 0;
}

.recent-search-text {
  flex: 1;
  font-size: 16px;
  font-weight: 400;
  color: #F0F4F8;
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}

.recent-search-remove {
  width: 32px;
  height: 32px;
  background: transparent;
  border: none;
  border-radius: 6px;
  display: flex;
  align-items: center;
  justify-content: center;
  cursor: pointer;
  opacity: 0;
  transition: all 200ms ease;
}

.recent-search-item:hover .recent-search-remove {
  opacity: 1;
}

.recent-search-remove:hover {
  background: rgba(255, 59, 59, 0.1);
  color: #FF3B3B;
}
```

### Search Results Grid

```css
.search-results {
  padding: 32px 0;
}

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

.results-count {
  font-size: 14px;
  font-weight: 500;
  color: #9BA3B8;
}

.results-sort {
  display: flex;
  align-items: center;
  gap: 12px;
}

.sort-dropdown {
  padding: 8px 16px;
  background: #151932;
  border: 1px solid #2A2F4A;
  border-radius: 8px;
  font-size: 14px;
  font-weight: 500;
  color: #F0F4F8;
  cursor: pointer;
  transition: all 200ms ease;
}

.sort-dropdown:hover {
  border-color: #00F0FF;
}

/* Results grid layout */
.results-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
  gap: 24px;
}

/* Song results (list view) */
.song-results-list {
  display: flex;
  flex-direction: column;
  gap: 8px;
}

.song-result-item {
  display: grid;
  grid-template-columns: 48px 1fr auto auto auto;
  gap: 16px;
  align-items: center;
  padding: 12px 16px;
  background: transparent;
  border-radius: 8px;
  cursor: pointer;
  transition: all 200ms ease;
}

.song-result-item:hover {
  background: rgba(240, 244, 248, 0.05);
}

.song-result-number {
  font-size: 14px;
  font-weight: 500;
  color: #6B7280;
}

.song-result-info {
  display: flex;
  align-items: center;
  gap: 12px;
  min-width: 0;
}

.song-result-image {
  width: 48px;
  height: 48px;
  object-fit: cover;
  border-radius: 6px;
  flex-shrink: 0;
}

.song-result-title {
  font-size: 16px;
  font-weight: 500;
  color: #F0F4F8;
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}

.song-result-artist {
  font-size: 14px;
  font-weight: 400;
  color: #9BA3B8;
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}

.song-result-album {
  font-size: 14px;
  font-weight: 400;
  color: #9BA3B8;
}

.song-result-duration {
  font-size: 14px;
  font-weight: 500;
  color: #6B7280;
}

.song-result-actions {
  display: flex;
  align-items: center;
  gap: 8px;
  opacity: 0;
  transition: opacity 200ms ease;
}

.song-result-item:hover .song-result-actions {
  opacity: 1;
}

.icon-button {
  width: 36px;
  height: 36px;
  background: transparent;
  border: none;
  border-radius: 50%;
  display: flex;
  align-items: center;
  justify-content: center;
  cursor: pointer;
  color: #9BA3B8;
  transition: all 200ms ease;
}

.icon-button:hover {
  color: #F0F4F8;
  background: rgba(240, 244, 248, 0.1);
}
```

### Trending Searches

```css
.trending-searches-section {
  padding: 32px 0;
  border-top: 1px solid #2A2F4A;
}

.trending-searches-title {
  font-size: 18px;
  font-weight: 600;
  color: #F0F4F8;
  margin-bottom: 20px;
}

.trending-searches-list {
  display: flex;
  flex-direction: column;
  gap: 12px;
}

.trending-search-item {
  display: flex;
  align-items: center;
  gap: 16px;
  padding: 12px 16px;
  border-radius: 8px;
  cursor: pointer;
  transition: all 200ms ease;
}

.trending-search-item:hover {
  background: rgba(240, 244, 248, 0.05);
}

.trending-rank {
  font-size: 18px;
  font-weight: 700;
  color: #00F0FF;
  width: 32px;
  flex-shrink: 0;
}

.trending-search-content {
  flex: 1;
}

.trending-search-query {
  font-size: 16px;
  font-weight: 500;
  color: #F0F4F8;
  margin-bottom: 4px;
}

.trending-search-meta {
  font-size: 13px;
  font-weight: 400;
  color: #6B7280;
}

.trending-arrow {
  width: 20px;
  height: 20px;
  color: #6B7280;
  flex-shrink: 0;
}
```

### No Results State

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

.no-results-icon {
  width: 100px;
  height: 100px;
  color: #2A2F4A;
  margin-bottom: 24px;
}

.no-results-title {
  font-size: 28px;
  font-weight: 600;
  color: #F0F4F8;
  margin-bottom: 12px;
}

.no-results-query {
  color: #00F0FF;
}

.no-results-description {
  font-size: 16px;
  font-weight: 400;
  color: #9BA3B8;
  margin-bottom: 8px;
  max-width: 500px;
}

.no-results-suggestions {
  font-size: 14px;
  font-weight: 400;
  color: #6B7280;
  margin-bottom: 32px;
}

.no-results-tips {
  display: flex;
  flex-direction: column;
  gap: 12px;
  text-align: left;
}

.no-results-tip {
  display: flex;
  align-items: center;
  gap: 12px;
  font-size: 14px;
  font-weight: 400;
  color: #9BA3B8;
}

.no-results-tip-icon {
  width: 16px;
  height: 16px;
  color: #00F0FF;
  flex-shrink: 0;
}
```

### Search Filters

```css
.search-filters {
  display: flex;
  align-items: center;
  gap: 12px;
  padding: 20px 0;
  flex-wrap: wrap;
}

.filter-chip {
  padding: 8px 16px;
  background: #151932;
  border: 1px solid #2A2F4A;
  border-radius: 20px;
  font-size: 13px;
  font-weight: 500;
  color: #9BA3B8;
  cursor: pointer;
  transition: all 200ms ease;
  display: flex;
  align-items: center;
  gap: 8px;
}

.filter-chip:hover {
  border-color: #00F0FF;
  color: #F0F4F8;
}

.filter-chip.active {
  background: linear-gradient(135deg, #00F0FF 0%, #00C8FF 100%);
  border-color: #00F0FF;
  color: #0A0E27;
}

.filter-chip-remove {
  width: 16px;
  height: 16px;
  opacity: 0.7;
}

.filter-chip-remove:hover {
  opacity: 1;
}
```

## Responsive Adjustments

### Mobile (< 768px)
- Search input height: 48px
- Search tabs: Scrollable horizontally
- Results grid: 2 columns
- Song list: Compact (hide album column)
- Filters: Horizontal scroll

### Tablet (768px - 1024px)
- Search input height: 52px
- Results grid: 4 columns
- Song list: Full layout

### Desktop (> 1024px)
- Use default sizes above
- Results grid: 6 columns

## Search Behavior

### Debouncing
- Wait **300ms** after typing before sending search request
- Cancel previous requests if user continues typing

### Keyboard Navigation
- **Escape**: Clear search and focus search input
- **Tab**: Navigate through results
- **Enter**: Search on press or navigate to first result
- **Arrow Down/Up**: Navigate through results list

### Search Suggestions
- Show **5 recent searches** max
- Show **10 trending searches** max
- Highlight matching text in results

## Additional Anti-Patterns for Search

❌ **NEVER search on every keystroke** - Debounce for 300ms
❌ **NEVER show results before user types** - Start with recent/trending
❌ **NEVER hide clear button** - Always visible when input has text
❌ **NEVER mix result types** - Use tabs to separate
❌ **NEVER skip empty state** - Provide helpful tips
❌ **NEVER ignore search history** - Save and show recent searches
❌ **NEVER use instant navigation** - Let user review results first

---

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