HERO Planner v1.5.0 Release Notes

Release Date: December 11, 2025

Overview

This release focuses on improving custom shift functionality and modal management with comprehensive bug fixes and stability enhancements.

---

✨ New Features

Enhanced Custom Shift Color Support

• Added support for dynamic theme colors in custom shifts
• Theme colors now automatically update when app theme changes
• New Color Picker UI with both theme color presets and custom hex colors
• Improved visual feedback for selected colors

---

🔧 Improvements & Fixes

Modal Management & Architecture

• ✅ ModalContainer Integration - Centralized modal management system complete
• Integrated 25+ modals into single ModalContainer component (~505 lines)
• Removed scattered modal state management from App.jsx
• Improved prop passing and handler connections
• Foundation for future modal enhancements
• ✅ SelectWeeksModal Integration - Fixed missing SelectWeeksModal rendering for both PDF and HTML export paths
• Now properly passes weekCommencing and getStartOfWeek props
• Both export formats now fully support week selection
• ✅ Theme Modal Handlers - Connected all missing theme modal handlers to ModalContainer
• handleThemeChange - Now properly updates theme
• handleSaveCustomTheme - Now properly saves custom themes
• handleDeleteCustomTheme - Now properly deletes custom themes

Custom Shift Enhancements

• ✅ Theme Color Display Fixed - Custom shifts created with theme colors (Color 1/2/3) now display correctly immediately after creation
• Previously required editing to display correct color
• Now stores both theme color (for dynamic updates) and hex color (for immediate display)
• Colors update dynamically when app theme changes
• Resolved from Recommended Roadmap Phase 8 enhancements
• ✅ Color Normalization - All custom hex colors now normalized to uppercase for consistency
• ✅ Color Fallbacks - Improved color fallback logic to ensure shifts always display with a valid color

Validation & Data Integrity

• ✅ Custom Shift Validation - Fixed handleCellClick to use allShiftsMap instead of creating new map
• Custom shifts can now be properly placed on the rota
• Validation includes all shift types (base, custom presets, custom types, absences)
• ✅ Color Property Handling - Updated allShiftsMap fallback color from Tailwind class string to consistent hex color

Code Quality

• ✅ Added Missing Imports - Imported getTheme function for theme color resolution
• ✅ Enhanced Error Handling - Improved error messages for custom shift operations
• ✅ Dependency Management - Fixed dependency arrays in useCallback hooks for proper re-rendering

---

🗺️ Roadmap Completion

This release completes several items from the Recommended Roadmap (see RECOMMENDATIONS_ROADMAP.md):

Completed from Roadmap

• ✅ Phase 7: Component Refactoring - ModalContainer integration reduces App.jsx complexity
• ModalContainer.jsx created (~505 lines) - centralizes 25+ modal management
• Improved component separation and responsibility delegation

• Foundation for future component extraction

• ✅ Phase 8: UX Enhancements - Theme color system improvements

• Enhanced custom shift color support with dynamic theme colors
• Improved visual consistency across custom shifts

• Better user feedback on color selection

• ✅ Project Infrastructure - Cleanup phase

• Removed non-essential files and documentation (~20+ items)
• Improved project organization for maintainability
• Cleaner codebase for future contributors

---

🧹 Project Cleanup

• Removed 20+ non-essential items
• Old branch directories and outdated configurations
• Deprecated documentation and analysis files
• Obsolete test configurations and build artifacts
• Removed outdated documentation and old branch files
• Cleaned up project structure for improved maintainability
• Reduced noise for future contributors and development

---

📊 Test Status

• Test Suite: 95/95 tests passing (100%)
• ESLint: 0 errors
• npm audit: 0 vulnerabilities
• Build Status: ✅ All changes validated with zero regressions

---

📝 Technical Details

Files Modified

Core Application: - src/App.jsx - Updated version to 1.5.0, fixed validation logic, enhanced shift color handling - package.json - Updated version to 1.5.0

Components: - src/components/ModalContainer.jsx - Added missing modal handlers and props - src/components/ShiftPalette.jsx - Enhanced color display logic with theme support - src/components/AddCustomShift.jsx - Improved color handling in form submission - src/components/EditCustomShiftModal.jsx - Maintained color and theme color preservation

Utilities: - src/utils/validation.js - Fixed validation to support all shift types

Version Updates

• package.json: 1.3.0 → 1.5.0
• App.jsx UpdateChecker: 1.3.0 → 1.5.0

---

🎯 Known Limitations

None identified at this release.

---

🚀 Next Steps (Future Releases)

• Advanced shift analytics and reporting
• Staff preference settings for shift assignment
• Integration with external calendar systems
• Mobile app companion

---

📞 Support

For issues or feature requests, please contact the development team or open an issue on the project repository.

---

☕ Support Development

If you find HERO Planner valuable, please consider supporting development:

Your support helps us continue improving and maintaining this application!

---

🙏 Thanks

Thank you for using HERO Planner. Your feedback helps us improve!

Version: 1.5.0
Build Status: Production Ready
Last Updated: December 11, 2025