mtg_python_deckbuilder/RELEASE_NOTES_TEMPLATE.md

# MTG Python Deckbuilder ${VERSION}

## [Unreleased]

### Summary
Web UI improvements with Tailwind CSS migration, component library, and optional card image caching for faster performance.

### Added
- **Card Image Caching**: Optional local image cache for faster card display
  - Downloads card images from Scryfall bulk data
  - Graceful fallback to Scryfall API for uncached images
  - Enable with `CACHE_CARD_IMAGES=1` environment variable
  - Intelligent statistics caching (weekly refresh, matching card data staleness)
- **Component Library**: Living documentation at `/docs/components`
  - Interactive examples of all UI components
  - Reusable Jinja2 macros for consistent design
  - Component partial templates for reuse across pages

### Changed
- **Migrated CSS to Tailwind**: Consolidated and unified CSS architecture
  - Tailwind CSS v3 with custom MTG color palette
  - PostCSS build pipeline with autoprefixer
  - Minimized inline styles in favor of shared CSS classes
- **Docker Build Optimization**: Improved developer experience
  - Hot reload for templates and CSS (no rebuild needed)
- **Template Modernization**: Migrated templates to use component system

### Removed
_None_

### Fixed
_None_

### Performance
- Hot reload for CSS/template changes (no Docker rebuild needed)
- Optional image caching reduces Scryfall API calls
- Faster page loads with optimized CSS

### For Users
- Faster card image loading with optional caching
- Cleaner, more consistent web UI design
- Improved page load performance

### Deprecated
_None_

### Security
_None_