Hive-Pal

🚀 What's New

Queen History Tracking

Full queen lifecycle management has arrived! Beekeepers can now track individual queens across hives, record transfers with dates and reasons, and view the complete history of queens in any hive.

• Queen List Page (/queens) — browse all queens with filtering by status (Active, Replaced, Dead, Unknown) and hive assignment
• Queen Detail Page — view detailed queen information including color, marking, year, source, and full movement history between hives
• Queen Transfer — record queen transfers between hives with date, reason, and notes
• Queen History Tab — new tab on the hive detail page showing all queens that have been in the hive, with action buttons to add or replace queens
• Queen marking in the hive detail header is clickable and links directly to the queen detail page
• "View Details" option added to the queen actions dropdown menu
• "Mark as Dead" and "Mark as Lost/Missing" actions now actually update the queen status via the API and set the replaced date (previously no-ops)

Inspection Scores, Frame Observations & Box Configuration

A significant overhaul of the inspection workflow that introduces structured scoring and richer per-frame data:

• Inspection scoring — capture standardized scores during an inspection to track hive condition over time
• Frame-level observations — record observations at the individual frame level (brood pattern, stores, etc.)
• Box configuration — configure the boxes that make up a hive and surface them in inspections
• Pending box updates queue with retry mechanism and safe JSON parsing for resilient offline-tolerant updates
• Score calculation is skipped for subjective apiary inspections so totals reflect real measurements

AI-Powered Inspection Suggestions

AI assistance has been added to the inspection form to help beekeepers fill in observations and recommendations:

• AI suggestions for observation fields, including numeric values
• AI-suggested recommendations powered by a new Python service (ai-python-image) with its own GHCR build workflow
• LLM prompts are now internationalized so suggestions match the user's selected language
• UX polish for missing AI data, visibility of AI suggestions, and merging AI output with user-entered values
• Graceful handling of weather service errors when an apiary has no location set

Equipment Planning Overhaul

A complete rework of equipment management:

• New equipment planning flow with clearer status tracking
• Expanded set of default equipment items so new users start with sensible defaults
• Equipment table is now horizontally scrollable on mobile

Apiary Sharing

Initial support for sharing apiaries between users, laying the groundwork for collaborative beekeeping.

Photos on Inspections

Inspections can now have photos attached directly, so visual records live alongside the observations they relate to (in addition to the standalone photo uploads introduced in v0.17.0).

Inspection Date & Time Improvements

• UTC date handling is now consistent across the app
• Time of day is preserved correctly for all-day inspections
• Reschedule dialog uses the improved date/time picker
• "Add Inspection" is now available directly from the "Add Entry" button

Mobile UI Polish

A round of mobile-specific UX improvements:

• Sidebar collapses when a link is tapped
• Floating Action Button (FAB) action labels show on all screen sizes with proper card background
• Apiary header button labels are hidden on small screens to save space
• Hive table rows and hive names are now tappable links to the hive detail page
• Installation and last-inspection dates are formatted per the user's preferences
• General layout, notifications, and settings cleanup

Email & SMTP Documentation

The README now documents all email-related environment variables, including MAIL_PROVIDER, RESEND_API_KEY, SMTP_REJECT_UNAUTHORIZED, and the existing SMTP settings, making self-hosted email setup clearer.

Login & Onboarding Fixes

• Language switcher buttons on the login screen are now readable on the dark background
• Resolved an error screen that could appear during signup before onboarding completed

🐛 Bug Fixes

• Fixed getColor not defined error in the queen information component — replaced with the correct getQueenColorClass function
• Fixed "Mark as Dead" and "Mark as Lost/Missing" actions which were previously no-ops
• Deduplicated queen actions dropdown in mobile and inline views — now reuses a shared menu component
• Restored Weblate-managed locale formatting and added .prettierignore so translation files don't get reformatted out from under translators
• Various lint and ESLint fixes across frontend and backend
• Removed unused imports and dead code in equipment and inspection forms
• Fixed JSX structure in the reschedule dialog's InspectionDateTimePicker

🔒 Security

• Resolved 10 additional ReDoS (regular expression denial of service) vulnerabilities in the jwt-utils test suite
• Additional security hardening across the AI Python service

🔧 Technical Improvements

• New QueenMovement database model for tracking queen transfers between hives
• New API endpoints for queen history (/api/queens/hive/:hiveId/history), queen movement history (/api/queens/:id/history), and queen transfer (/api/queens/:id/transfer)
• QueenColorBadge extracted as a reusable component
• Shared queen constants extracted to reduce code duplication
• New React Query hooks: useQueenHistory, useHiveQueenHistory, useRecordQueenTransfer
• AI logic moved into a dedicated hook for reuse
• New GitHub Actions workflow to build the ai-python-image container
• Vite changed to autoUpdate and API caching removed from Vite config
• Multiple SonarCloud quality-gate fixes and component-duplication refactors
• Translation keys added for all new features across supported languages (English, German, French, Italian, Slovak, Danish, Serbian, Dutch)

🌍 Translations

• Dutch — new language added via Weblate
• French — significant updates via Weblate
• Serbian — extensive updates via Weblate
• Danish — continued contributions

🤝 Contributors

A huge thank you to everyone who contributed to this release!

• @Wollycobbles — queen history tracking, inspection date/time enhancements (PR #159), and mobile UI polish (PR #157)
• @MacNite — inspection scores, frame observations, and box configuration (PR #164, #168)
• @JacKruczek — equipment planning overhaul (PR #158) and expanded default equipment items (PR #166)
• @TomsaJ — LLM prompt internationalization (PR #148)
• Weblate translators for Dutch, French, Serbian, and Danish

Track your queens from hive to hive — every transfer, every generation! 🐝👑