added AGENTS.md

update layout for accessibility
2026-01-22 10:25:07 +01:00 · 2026-01-22 10:23:36 +01:00
4 changed files with 377 additions and 73 deletions
--- a/AGENTS.md
+++ b/AGENTS.md
@ -0,0 +1,187 @@
+# AGENTS.md
+
+This file provides guidance for AI coding agents working in this repository.
+
+## Project Overview
+
+Top 500 Albums analysis with data from Rolling Stone (2020) and Wikipedia (2023). Includes Python data processing scripts, an interactive web interface (vanilla HTML/CSS/JS), and album cover artwork from the iTunes API.
+
+## Build/Lint/Test Commands
+
+**No formal build system.** All Python scripts use only the standard library.
+
+```bash
+# Run Python scripts directly
+python scripts/download_all_covers.py
+python scripts/compare_top500_albums.py
+
+# Local dev server (required for CORS)
+python -m http.server 8000
+```
+
+**No tests or linting configured.** Manual testing only - run scripts and verify output, open website and check functionality.
+
+## Code Style Guidelines
+
+### Python
+
+```python
+#!/usr/bin/env python3
+"""Module docstring explaining the script's purpose."""
+
+import csv
+import json
+import os
+import re
+from typing import Dict, List, Optional, Tuple
+
+# Constants: UPPER_SNAKE_CASE
+MAX_RETRIES = 3
+
+# Functions/variables: snake_case
+def normalize_text(text: str) -> str:
+    """Normalize text for comparison."""
+    pass
+
+albums_2020 = {}
+```
+
+**Key patterns:**
+- Always use shebang: `#!/usr/bin/env python3`
+- Include module-level docstring
+- Standard library only - no external dependencies
+- Type hints for function signatures
+- Use `encoding='utf-8'` and `newline=''` for CSV operations
+
+**Error handling:**
+```python
+try:
+    with urllib.request.urlopen(url, timeout=15) as response:
+        data = json.loads(response.read().decode())
+except Exception as e:
+    print(f"Error: {e}")
+    return None
+```
+
+### JavaScript
+
+```javascript
+// Global variables at top
+let albumsData = [];
+const itemsPerPage = 50;
+
+// DOM refs cached on load
+const albumsGrid = document.getElementById('albumsGrid');
+
+// Initialize on DOMContentLoaded
+document.addEventListener('DOMContentLoaded', function() {
+    loadData();
+});
+
+// Async/await for fetch
+async function loadAlbumsData() {
+    try {
+        const response = await fetch('data.csv');
+        if (!response.ok) throw new Error('Failed');
+        // ...
+    } catch (err) {
+        console.error('Error:', err);
+    }
+}
+```
+
+**Key patterns:**
+- Variables/functions: camelCase
+- Use `console.warn()` for non-critical failures
+- Vanilla JS only - no frameworks
+
+### HTML/CSS
+
+- Semantic HTML5 elements
+- CSS custom properties for theming
+- Responsive design with Grid/Flexbox
+
+## Accessibility Requirements
+
+All UI changes must follow WCAG 2.1 AA guidelines:
+
+**Keyboard Navigation:**
+- All interactive elements must be keyboard accessible
+- Use `tabindex` appropriately (0 for focusable, -1 for programmatic focus)
+- Implement visible focus indicators (`:focus-visible` with `outline`)
+- Support skip links for main content
+
+**Screen Readers:**
+- Use semantic HTML (`<button>`, `<nav>`, `<main>`, `<article>`)
+- Add ARIA labels for icon-only buttons: `aria-label="Share album"`
+- Use `.sr-only` class for screen-reader-only text
+- Ensure proper heading hierarchy (`h1` > `h2` > `h3`)
+
+**Color & Contrast:**
+- Minimum 4.5:1 contrast ratio for normal text
+- Minimum 3:1 for large text and UI components
+- Never use color alone to convey information
+
+**Motion & Animations:**
+- Respect `prefers-reduced-motion` media query
+- Avoid layout shifts on hover (no `transform: translateY()` on cards)
+
+**Focus Management:**
+- Trap focus in modals/dialogs
+- Return focus to trigger element when closing overlays
+
+**Existing Patterns:**
+```css
+/* Screen reader only */
+.sr-only { position: absolute; width: 1px; height: 1px; ... }
+
+/* Focus indicators */
+button:focus-visible { outline: 2px solid var(--primary-color); outline-offset: 2px; }
+
+/* Reduced motion */
+@media (prefers-reduced-motion: reduce) { ... }
+```
+
+## Project Structure
+
+```
+top500albums/
+├── index.html, script.js, styles.css  # Website
+├── *.csv, *.json                       # Data files
+├── covers/                             # Album artwork (500 images)
+└── scripts/                            # Python utilities (36 scripts)
+```
+
+## Data Files
+
+| File | Notes |
+|------|-------|
+| `rolling_stone_top_500_albums_2020.csv` | Title case columns, ranks in reverse order |
+| `wikipedia_top_500_albums.csv` | Lowercase columns (`rank`, `artist`, `album`) |
+| `top_500_albums_2023.csv` | Combined comparison file |
+
+## Key Patterns
+
+**CSV column naming:**
+- Rolling Stone/Combined: Title case (`Rank`, `Artist`, `Album`)
+- Wikipedia: lowercase (`rank`, `artist`, `album`)
+
+**Album matching:** Uses `difflib` for fuzzy matching variations like "The Beatles" vs "Beatles"
+
+**API rate limiting:** `time.sleep(1.2)` between requests
+
+## Common Tasks
+
+**New Python script:**
+1. Create in `scripts/`, add shebang + docstring
+2. Standard library only
+3. Include `if __name__ == "__main__":` block
+
+**Working with album data:**
+```python
+import csv
+with open('top_500_albums_2023.csv', 'r', encoding='utf-8') as f:
+    for row in csv.DictReader(f):
+        rank, artist, album = int(row['Rank']), row['Artist'], row['Album']
+        status = row['Status']  # "New in 2023", "+10", "-5", "No change"
+```
--- a/index.html
+++ b/index.html
@ -10,13 +10,15 @@
    <link rel="stylesheet" href="styles.css">
 </head>
 <body>
+    <a href="#albumsGrid" class="skip-link">Skip to albums</a>
    <header class="header">
        <div class="container">
            <p class="supertitle">Rolling Stone Magazine's</p>
            <h1 class="title">Top 500 Albums of All Time</h1>
            <p class="subtitle">The Greatest Albums Ever Made - 2023 Edition</p>
            <div class="header-theme-selector">
-                <select id="themeSelect" class="theme-select-header" title="Choose theme">
+                <label for="themeSelect" class="sr-only">Color theme</label>
+                <select id="themeSelect" class="theme-select-header" aria-label="Color theme">
                    <option value="">Gruvbox</option>
                    <option value="purple">Basic Blue</option>
                    <option value="dark">Dark</option>
@ -34,9 +36,10 @@
        <div class="container">
            <div class="controls">
                <div class="search-container">
+                    <label for="searchInput" class="sr-only">Search albums and artists</label>
                    <input type="text" id="searchInput" placeholder="Search albums, artists..." class="search-input">
-                    <button id="searchButton" class="search-button">
-                        <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                    <button id="searchButton" class="search-button" aria-label="Search">
+                        <svg aria-hidden="true" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
                            <circle cx="11" cy="11" r="8"></circle>
                            <path d="m21 21-4.35-4.35"></path>
                        </svg>
@ -44,6 +47,7 @@
                </div>
                
                <div class="filters">
+                    <label for="statusFilter" class="sr-only">Filter by status</label>
                    <select id="statusFilter" class="filter-select">
                        <option value="">All Albums</option>
                        <option value="New in 2023">New in 2023</option>
@ -53,6 +57,7 @@
                    </select>
                    
                    <div class="sort-controls">
+                        <label for="sortBy" class="sr-only">Sort albums by</label>
                        <select id="sortBy" class="filter-select">
                            <option value="rank">Sort by Rank</option>
                            <option value="artist">Sort by Artist</option>
@ -60,8 +65,8 @@
                            <option value="year">Sort by Year</option>
                        </select>
                        
-                        <button id="reverseButton" class="reverse-button" title="Reverse order">
-                            <span id="reverseIcon">
+                        <button id="reverseButton" class="reverse-button" aria-label="Reverse sort order" aria-pressed="false">
+                            <span id="reverseIcon" aria-hidden="true">
                                <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
                                    <path d="M3 6h18M3 12h18M3 18h18"></path>
                                    <path d="M21 6l-2-2-2 2M21 18l-2 2-2 2"></path>
@ -74,41 +79,45 @@
                
                <div class="bookmark-controls">
                    <div class="jump-to-rank">
+                        <label for="jumpToRank" class="sr-only">Jump to rank number</label>
                        <input type="number" id="jumpToRank" placeholder="Jump to..." min="1" max="500" class="rank-input">
-                        <button id="jumpButton" class="jump-button" title="Jump to rank">Go</button>
+                        <button id="jumpButton" class="jump-button" aria-label="Jump to rank">Go</button>
                    </div>
                </div>
            </div>

-            <div class="stats" id="stats">
-                <div class="stat-item">
+            <div class="stats" id="stats" role="region" aria-label="Album statistics">
+                <button type="button" class="stat-item" data-filter="">
                    <span class="stat-number" id="totalAlbums">500</span>
                    <span class="stat-label">Total Albums</span>
-                </div>
-                <div class="stat-item">
+                </button>
+                <button type="button" class="stat-item" data-filter="New in 2023">
                    <span class="stat-number" id="newAlbums">192</span>
                    <span class="stat-label">New in 2023</span>
-                </div>
-                <div class="stat-item">
+                </button>
+                <button type="button" class="stat-item" data-filter="improved">
                    <span class="stat-number" id="improvedAlbums">164</span>
                    <span class="stat-label">Improved</span>
-                </div>
-                <div class="stat-item">
+                </button>
+                <button type="button" class="stat-item" data-filter="dropped">
                    <span class="stat-number" id="droppedAlbums">113</span>
                    <span class="stat-label">Dropped</span>
-                </div>
+                </button>
            </div>

-            <div class="albums-grid" id="albumsGrid">
+            <!-- Live region for screen reader announcements -->
+            <div aria-live="polite" aria-atomic="true" class="sr-only" id="resultsAnnouncement"></div>
+
+            <div class="albums-grid" id="albumsGrid" role="region" aria-label="Album list" tabindex="-1">
                <!-- Albums will be loaded here by JavaScript -->
            </div>

-            <div class="loading" id="loading">
-                <div class="loading-spinner"></div>
+            <div class="loading" id="loading" role="status" aria-live="polite">
+                <div class="loading-spinner" aria-hidden="true"></div>
                <p>Loading albums...</p>
            </div>

-            <div class="error" id="error" style="display: none;">
+            <div class="error" id="error" role="alert" style="display: none;">
                <p>Error loading albums. Please try again later.</p>
            </div>
        </div>
--- a/script.js
+++ b/script.js
@ -73,34 +73,14 @@ function setupEventListeners() {

 // Setup click handlers for stats cards
 function setupStatsClickHandlers() {
-    const totalAlbumsCard = document.querySelector('.stat-item:has(#totalAlbums)') || 
-                           document.querySelector('#totalAlbums').closest('.stat-item');
-    const newAlbumsCard = document.querySelector('.stat-item:has(#newAlbums)') || 
-                         document.querySelector('#newAlbums').closest('.stat-item');
-    const improvedAlbumsCard = document.querySelector('.stat-item:has(#improvedAlbums)') || 
-                              document.querySelector('#improvedAlbums').closest('.stat-item');
-    const droppedAlbumsCard = document.querySelector('.stat-item:has(#droppedAlbums)') || 
-                             document.querySelector('#droppedAlbums').closest('.stat-item');
-    
-    if (totalAlbumsCard) {
-        totalAlbumsCard.addEventListener('click', () => handleStatsCardClick(''));
-        totalAlbumsCard.style.cursor = 'pointer';
-    }
-    
-    if (newAlbumsCard) {
-        newAlbumsCard.addEventListener('click', () => handleStatsCardClick('New in 2023'));
-        newAlbumsCard.style.cursor = 'pointer';
-    }
-    
-    if (improvedAlbumsCard) {
-        improvedAlbumsCard.addEventListener('click', () => handleStatsCardClick('improved'));
-        improvedAlbumsCard.style.cursor = 'pointer';
-    }
-    
-    if (droppedAlbumsCard) {
-        droppedAlbumsCard.addEventListener('click', () => handleStatsCardClick('dropped'));
-        droppedAlbumsCard.style.cursor = 'pointer';
-    }
+    // Stats cards are now buttons with data-filter attributes
+    const statButtons = document.querySelectorAll('.stat-item[data-filter]');
+    statButtons.forEach(button => {
+        button.addEventListener('click', () => {
+            const filterValue = button.getAttribute('data-filter');
+            handleStatsCardClick(filterValue);
+        });
+    });
 }

 // Handle stats card clicks
@ -235,6 +215,11 @@ function renderAlbums() {
    
    if (currentPage === 1) {
        albumsGrid.innerHTML = '';
+        // Announce results to screen readers
+        const announcement = document.getElementById('resultsAnnouncement');
+        if (announcement) {
+            announcement.textContent = `Showing ${filteredData.length} albums`;
+        }
    }
    
    albumsToShow.slice(startIndex).forEach(album => {
@ -288,34 +273,34 @@ function createAlbumCard(album) {
    const nextAlbum = hasNext ? filteredData[currentIndex + 1] : null;
    
    card.innerHTML = `
-        <div class="album-header-grid">
-            <div class="album-rank">#${album.Rank}</div>
+        <article class="album-header-grid">
+            <div class="album-rank" aria-label="Rank ${album.Rank}">#${album.Rank}</div>
            <div class="album-details">
                <div class="album-title-row">
-                    <div class="album-title">${escapeHtml(album.Album)}</div>
-                    <button class="album-share album-share-desktop" title="Share this album" data-rank="${album.Rank}">
-                        <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                    <h2 class="album-title">${escapeHtml(album.Album)}</h2>
+                    <button class="album-share album-share-desktop" aria-label="Share ${escapeHtml(album.Album)}" data-rank="${album.Rank}">
+                        <svg aria-hidden="true" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
                            <path d="M4 12v8a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-8"></path>
                            <polyline points="16,6 12,2 8,6"></polyline>
                            <line x1="12" y1="2" x2="12" y2="15"></line>
                        </svg>
                    </button>
                </div>
-                <div class="album-artist">${escapeHtml(album.Artist)}</div>
-                ${album.Info ? `<div class="album-info">${escapeHtml(album.Info)}</div>` : ''}
+                <p class="album-artist">${escapeHtml(album.Artist)}</p>
+                ${album.Info ? `<p class="album-info">${escapeHtml(album.Info)}</p>` : ''}
            </div>
-        </div>
+        </article>
        <div class="album-cover">
            ${coverImagePath ? 
                `<img src="${coverImagePath}" alt="${escapeHtml(album.Album)} by ${escapeHtml(album.Artist)}" class="album-cover-image" onerror="this.style.display='none'; this.nextElementSibling.style.display='flex';">
-                 <div class="album-cover-icon" style="display: none;">🎵</div>` :
-                `<div class="album-cover-icon">🎵</div>`
+                 <div class="album-cover-icon" style="display: none;" aria-hidden="true">🎵</div>` :
+                `<div class="album-cover-icon" aria-hidden="true">🎵</div>`
            }
        </div>
        <div class="album-status-row">
            <div class="album-status ${statusClass}">${statusText}</div>
-            <button class="album-share album-share-mobile" title="Share this album" data-rank="${album.Rank}">
-                <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+            <button class="album-share album-share-mobile" aria-label="Share ${escapeHtml(album.Album)}" data-rank="${album.Rank}">
+                <svg aria-hidden="true" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
                    <path d="M4 12v8a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-8"></path>
                    <polyline points="16,6 12,2 8,6"></polyline>
                    <line x1="12" y1="2" x2="12" y2="15"></line>
@ -326,18 +311,18 @@ function createAlbumCard(album) {
        <div class="album-links">
            <div class="album-links-row">
                <a href="${generateWikipediaUrl(album.Album, album.Artist)}" target="_blank" rel="noopener noreferrer" class="wikipedia-link">
-                    View on Wikipedia →
+                    View on Wikipedia <span aria-hidden="true">→</span>
                </a>
                <a href="${generateSpotifyUrl(album.Album, album.Artist)}" target="_blank" rel="noopener noreferrer" class="spotify-link">
-                    <svg width="14" height="14" viewBox="0 0 24 24" fill="currentColor" style="margin-right: 0.5rem;">
+                    <svg aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="currentColor" style="margin-right: 0.5rem;">
                        <path d="M12 0C5.4 0 0 5.4 0 12s5.4 12 12 12 12-5.4 12-12S18.66 0 12 0zm5.521 17.34c-.24.359-.66.48-1.021.24-2.82-1.74-6.36-2.101-10.561-1.141-.418.122-.84-.179-.959-.539-.12-.421.18-.78.54-.9 4.56-1.021 8.52-.6 11.64 1.32.42.18.479.659.361 1.02zm1.44-3.3c-.301.42-.841.6-1.262.3-3.239-1.98-8.159-2.58-11.939-1.38-.479.12-1.02-.12-1.14-.6-.12-.48.12-1.021.6-1.141C9.6 9.9 15 10.561 18.72 12.84c.361.181.54.78.241 1.2zm.12-3.36C15.24 8.4 8.82 8.16 5.16 9.301c-.6.179-1.2-.181-1.38-.721-.18-.601.18-1.2.72-1.381 4.26-1.26 11.28-1.02 15.721 1.621.539.3.719 1.02.42 1.56-.299.421-1.02.599-1.559.3z"/>
                    </svg>
                    Listen on Spotify
                </a>
            </div>
            ${hasNext ? `
-            <button class="next-album-link next-album-link-wide" data-rank="${album.Rank}" title="Go to next album (#${nextAlbum.Rank})">
-                Next Album →
+            <button class="next-album-link next-album-link-wide" data-rank="${album.Rank}" aria-label="Go to next album, number ${nextAlbum.Rank}">
+                Next Album <span aria-hidden="true">→</span>
            </button>
            ` : ''}
        </div>
@ -466,8 +451,9 @@ function handleSort(event) {
 function handleReverse() {
    isReversed = !isReversed;
    
-    // Update button appearance
+    // Update button appearance and accessibility state
    reverseButton.classList.toggle('reversed', isReversed);
+    reverseButton.setAttribute('aria-pressed', isReversed.toString());
    
    // Reverse the current filtered data
    filteredData.reverse();
@ -481,6 +467,7 @@ function resetReverse() {
    if (isReversed) {
        isReversed = false;
        reverseButton.classList.remove('reversed');
+        reverseButton.setAttribute('aria-pressed', 'false');
    }
 }

--- a/styles.css
+++ b/styles.css
@ -5,6 +5,40 @@
    box-sizing: border-box;
 }

+/* Screen reader only utility class */
+.sr-only {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border: 0;
+}
+
+/* Skip link for keyboard navigation */
+.skip-link {
+    position: absolute;
+    top: -40px;
+    left: 0;
+    padding: 8px 16px;
+    background: var(--primary-color);
+    color: var(--text-light);
+    text-decoration: none;
+    font-weight: 500;
+    z-index: 1000;
+    border-radius: 0 0 4px 0;
+    transition: top 0.2s ease;
+}
+
+.skip-link:focus {
+    top: 0;
+    outline: 2px solid var(--text-light);
+    outline-offset: 2px;
+}
+
 /* Theme Variables */
 :root {
    /* Default theme - Gruvbox */
@ -228,11 +262,17 @@ body {
 }

 .theme-select-header:focus {
-    outline: none;
+    outline: 2px solid var(--text-light);
+    outline-offset: 2px;
    border-color: rgba(255, 255, 255, 0.6);
    background: rgba(255, 255, 255, 0.2);
 }

+.theme-select-header:focus-visible {
+    outline: 2px solid var(--text-light);
+    outline-offset: 2px;
+}
+
 .theme-select-header option {
    background: var(--card-background);
    color: var(--text-primary);
@ -269,12 +309,18 @@ body {
    border: 2px solid #e1e5e9;
    border-radius: 8px 0 0 8px;
    font-size: 1rem;
-    outline: none;
    transition: border-color 0.3s ease;
 }

 .search-input:focus {
-    border-color: #667eea;
+    outline: 2px solid var(--primary-color);
+    outline-offset: -2px;
+    border-color: var(--primary-color);
+}
+
+.search-input:focus-visible {
+    outline: 2px solid var(--primary-color);
+    outline-offset: -2px;
 }

 .search-button {
@ -299,6 +345,11 @@ body {
    background: var(--secondary-color);
 }

+.search-button:focus-visible {
+    outline: 2px solid var(--primary-color);
+    outline-offset: 2px;
+}
+
 .filters {
    display: flex;
    gap: 1rem;
@ -316,7 +367,6 @@ body {
    border: 2px solid #e1e5e9;
    border-radius: 8px;
    font-size: 1rem;
-    outline: none;
    transition: border-color 0.3s ease;
    cursor: pointer;
    background: var(--card-background);
@ -325,9 +375,16 @@ body {
 }

 .filter-select:focus {
+    outline: 2px solid var(--primary-color);
+    outline-offset: 2px;
    border-color: var(--primary-color);
 }

+.filter-select:focus-visible {
+    outline: 2px solid var(--primary-color);
+    outline-offset: 2px;
+}
+
 .filter-select option {
    background: var(--card-background);
    color: var(--text-primary);
@ -345,7 +402,11 @@ body {
    align-items: center;
    gap: 0.5rem;
    transition: all 0.3s ease;
-    outline: none;
+}
+
+.reverse-button:focus-visible {
+    outline: 2px solid var(--primary-color);
+    outline-offset: 2px;
 }

 .reverse-button:hover {
@ -401,14 +462,20 @@ body {
    border: 2px solid #e1e5e9;
    border-radius: 8px;
    font-size: 1rem;
-    outline: none;
    transition: border-color 0.3s ease;
 }

 .rank-input:focus {
+    outline: 2px solid var(--primary-color);
+    outline-offset: -2px;
    border-color: var(--primary-color);
 }

+.rank-input:focus-visible {
+    outline: 2px solid var(--primary-color);
+    outline-offset: -2px;
+}
+
 .theme-selector {
    margin-left: 1rem;
 }
@ -418,7 +485,6 @@ body {
    border: 2px solid #e1e5e9;
    border-radius: 8px;
    font-size: 1rem;
-    outline: none;
    transition: border-color 0.3s ease;
    cursor: pointer;
    background: var(--card-background);
@ -427,9 +493,16 @@ body {
 }

 .theme-select:focus {
+    outline: 2px solid var(--primary-color);
+    outline-offset: 2px;
    border-color: var(--primary-color);
 }

+.theme-select:focus-visible {
+    outline: 2px solid var(--primary-color);
+    outline-offset: 2px;
+}
+
 .theme-select option {
    background: var(--card-background);
    color: var(--text-primary);
@ -444,7 +517,11 @@ body {
    font-size: 1rem;
    cursor: pointer;
    transition: all 0.3s ease;
-    outline: none;
+}
+
+.jump-button:focus-visible {
+    outline: 2px solid var(--primary-color);
+    outline-offset: 2px;
 }

 .jump-button:hover {
@ -473,6 +550,9 @@ body {
    box-shadow: 0 4px 20px rgba(0,0,0,0.1);
    transition: all 0.3s ease;
    cursor: pointer;
+    border: none;
+    font-family: inherit;
+    width: 100%;
 }

 .stat-item:hover {
@ -481,6 +561,11 @@ body {
    background: var(--hover-background);
 }

+.stat-item:focus-visible {
+    outline: 2px solid var(--primary-color);
+    outline-offset: 2px;
+}
+
 .stat-number {
    display: block;
    font-size: 2.5rem;
@ -622,12 +707,16 @@ body {
    transform: scale(0.95);
 }

+.album-share:focus-visible {
+    outline: 2px solid var(--text-light);
+    outline-offset: 2px;
+}
+
 .album-share.copied {
    background: var(--secondary-color);
 }

 .album-card:hover {
-    transform: translateY(-4px);
    box-shadow: 0 8px 32px rgba(0,0,0,0.15);
 }

@ -782,6 +871,11 @@ body {
    transform: translateY(0);
 }

+.wikipedia-link:focus-visible {
+    outline: 2px solid var(--primary-color);
+    outline-offset: 2px;
+}
+
 .spotify-link {
    display: inline-block;
    color: #1db954; /* Spotify green */
@ -804,6 +898,11 @@ body {
    transform: translateY(0);
 }

+.spotify-link:focus-visible {
+    outline: 2px solid #1db954;
+    outline-offset: 2px;
+}
+
 /* Dark theme adjustments for Spotify link */
 [data-theme="dark"] .spotify-link,
 [data-theme="gruvbox"] .spotify-link,
@ -846,6 +945,11 @@ body {
    transform: translateY(0);
 }

+.next-album-link:focus-visible {
+    outline: 2px solid var(--primary-color);
+    outline-offset: 2px;
+}
+
 .next-album-link svg {
    color: inherit;
 }
@ -1061,3 +1165,20 @@ body {
        gap: 0.5rem;
    }
 }
+
+/* Reduced motion preference */
+@media (prefers-reduced-motion: reduce) {
+    *,
+    *::before,
+    *::after {
+        animation-duration: 0.01ms !important;
+        animation-iteration-count: 1 !important;
+        transition-duration: 0.01ms !important;
+        scroll-behavior: auto !important;
+    }
+    
+    .loading-spinner {
+        animation: none;
+        border: 3px solid var(--primary-color);
+    }
+}
Author	SHA1	Message	Date
Johan Lundberg	21042ec133	added AGENTS.md	2026-01-22 10:25:07 +01:00
Johan Lundberg	0b91798c96	update layout for accessibility	2026-01-22 10:23:36 +01:00