Aphrodite v4.0.2 Release Notes

Major Development Environment Overhaul

This release focuses on massively improving the contributor experience by creating a complete, cross-platform development environment that gets new contributors up and running in under 5 minutes.

Complete Development Setup

• Fixed broken development environment - docker-compose.dev.yml now works properly with volume mounts for hot reloading
• Cross-platform support - Development scripts available for both Windows (PowerShell) and Linux/macOS (Bash)
• 5-minute contributor onboarding - Automated setup scripts handle everything from database initialization to service startup

New Development Scripts

Both PowerShell (.ps1) and Bash (.sh) versions provided:

• dev-setup - Automated development environment setup
• test - Comprehensive test runner with backend/frontend/integration options
• reset-db - Database reset utility for clean development state
• build - Production build with Tailwind v4 compatibility
• clean - Development environment cleanup
• validate-setup - Setup validation and health checks

Enhanced Docker Development

• New Dockerfile.dev - Development-optimized container with hot reloading and debug tools
• Frontend hot reloading - frontend/Dockerfile.dev enables Next.js hot module replacement
• Volume mounts - Live code changes reflected immediately without rebuilds
• Hybrid development - Option to run databases in Docker while developing natively

Comprehensive Documentation

• Complete CONTRIBUTING.md - Detailed guide covering both PowerShell and Linux workflows
• Development setup guide - Step-by-step instructions in docs/development/setup.md
• Tailwind v4 requirements - Clear instructions for GitHub Actions compatibility
• Troubleshooting guides - Common issues and solutions for development setup

Tailwind v4 Support

• Frontend build requirements - Proper handling of Tailwind v4 for production deployments
• GitHub Actions compatibility - Build scripts ensure CI/CD pipeline works correctly
• Local build validation - Scripts verify frontend builds before deployment

Bug Fixes

UI Improvements

• Fixed Docker icon display - Replaced broken SVG with proper Container icon in About page Execution Mode card

Review System Fixes

• Fixed review fetcher method signatures - Corrected parameter mismatch in IMDbFetcher after OMDb consolidation
• Optimized API calls - Maintained single OMDb API call while fixing TypeError in review badge processing

Enhanced Features

Video Resolution Detection

• HDR/Dolby Vision detection - Intelligent image mapping for enhanced video formats
• Parallel processing - Improved performance with caching for series metadata
• Enhanced metadata extraction - Better video stream analysis
• 100% backward compatibility - All existing functionality preserved
• Comprehensive error handling - Robust fallbacks for edge cases

Technical Improvements

Development Workflow

• Hot reloading - Both frontend (Next.js HMR) and backend (FastAPI reload) work seamlessly
• Database management - Easy reset and initialization for development
• Test automation - Comprehensive test suites with granular execution options
• Environment validation - Automated checks ensure proper setup

Cross-Platform Compatibility

• Windows PowerShell - Full development environment support for VS Code users
• Linux/macOS Bash - Traditional Unix-style development workflows
• Docker Desktop - Consistent environment across all platforms
• Git integration - Proper .gitignore configuration for development files

For Contributors

New Contributor Experience

# Clone and get started in under 5 minutes
git clone https://github.com/jackkerouac/aphrodite.git
cd aphrodite

# Windows/PowerShell users
.\scripts\dev-setup.ps1

# Linux/macOS users  
chmod +x scripts/*.sh && ./scripts/dev-setup.sh

# Access your development environment
# Frontend: http://localhost:3000
# Backend: http://localhost:8000
# API Docs: http://localhost:8000/docs

What's Included

• Automated setup - No manual configuration required
• Hot reloading - See changes instantly during development
• Complete documentation - Clear guidelines for contribution
• Test automation - Run tests with simple commands
• Database management - Easy reset and sample data
• Production builds - Verify changes work in production environment

Breaking Changes

• None - This release maintains 100% backward compatibility

Migration Notes

• Existing production deployments are unaffected
• Development environments should use new setup scripts for best experience
• Old development workflows continue to work but new scripts are recommended

For Maintainers

This release significantly reduces contributor onboarding friction and support overhead by providing:

• Self-service development environment setup
• Comprehensive documentation reducing common questions
• Automated testing and validation tools
• Consistent development experience across platforms

Full Changelog: v4.0.1...v4.0.2