Skip to content

Hive-Pal

Automation & Workflows

A modern, mobile‑first application for managing apiaries, hives, inspections and queen lineage.

TypeScript Latest v0.18.0 · 8d ago Security brief →

Features

  • Manage multiple apiaries with location data
  • Track individual hive status and configuration
  • Record detailed inspection observations and actions
  • Monitor queen lineage and replacement history
  • Mobile‑first UI optimized for field use

Recent releases

View all 6 releases →
Monitor
v0.18.0 Breaking risk

Queens, Inspection Scoring, Equipment Planning, Apiary Sharing, Photos

v0.17.0 Breaking risk
⚠ Upgrade required
  • New local storage option: set `STORAGE_TYPE=local` to store files on the server filesystem instead of S3.
  • Apiaries can now be edited after creation (name, location, etc.).
  • Hives and apiaries can be deleted directly from the UI.
Breaking changes
  • Quick Check button removed; replaced by "Add Entry" dropdown menu across hive detail, apiary sidebar, and dashboard timeline.
Notable features
  • Standalone photo uploads to hives or apiaries with thumbnail preview and lightbox.
  • Document upload support for PDFs or scanned images attached to any hive or apiary.
  • Unified "Files" page listing all photos and documents with filter, download, and delete actions.
Full changelog

🚀 What's New

Quick Add Menu

The Quick Check button has been replaced with a new "Add Entry" dropdown menu across all three locations (hive detail, apiary sidebar, and dashboard timeline). The dropdown consolidates multiple actions into a single entry point:

  • Quick Check — same as before, available everywhere
  • Action — available at hive level (replaces the separate "Add Action" button)
  • Photo — upload a standalone photo with an optional caption (requires storage)
  • Document — upload a PDF or scanned document with a title and notes (requires storage)

Standalone Photo Uploads

Upload photos directly to a hive or apiary without creating a quick check first. Photos appear in the activity timeline with a thumbnail preview and lightbox for full-size viewing.

Document Uploads

Attach PDF documents or scanned images to any hive or apiary. Useful for storing veterinary certificates, purchase receipts, treatment records, or any paperwork related to your beekeeping. Documents appear in the timeline with a download link.

Files Page

A new "Files" page (accessible from the sidebar) provides a unified table view of all uploaded photos and documents in your active apiary. Filter by file type, hive, or search by name. Download or delete files directly from the table.

Local File Storage

A new local storage option for file uploads as an alternative to S3. Set STORAGE_TYPE=local to store files on the server filesystem instead of requiring an S3-compatible object store.

Edit Apiary

Apiaries can now be edited after creation. Update the name, location, and other details of your apiaries without having to recreate them.

Delete Hives & Apiaries

You can now delete hives and apiaries directly from the UI. This makes it easy to clean up test data or remove apiaries and hives you no longer manage.

Apiary Header & Statistics

The apiary detail page has a new header component and redesigned statistics display, giving you a cleaner overview of your apiary at a glance.

Hive Detail Page

The hive detail page has been updated with an improved layout and better organization of hive information.

Feature Photo

Set a feature photo for your hives and apiaries to make them easily recognizable in lists and cards.

Dashboard Improvements

Dashboard now links directly to apiaries and hives. Tab routing has been added to the apiary detail page, and fixes were applied for map overflow and hive count display.

New Language Support

  • Danish and Serbian — thanks to community contributions via Weblate!
  • French — contributed by @RedWaxxx
  • German — contributed by @MacNite and @MarianKlemm via Weblate
  • Slovak translations have also been updated
  • Equipment planning, calendar, and sidebar components now fully internationalized

🐛 Bug Fixes

  • Fixed empty ?tab= query parameter causing issues on the apiary detail page
  • Hive card layout is now more compact and consistent
  • Aligned the apiary summary display

🔧 Technical Improvements

  • New Photo and Document Prisma models with apiary-level data isolation
  • Backend modules for photos and documents following existing patterns (ownership checks, signed URLs, storage integration)
  • Shared Zod schemas for photo and document validation
  • Existing Quick Check and Add Action dialogs now support controlled mode for use inside the dropdown menu
  • Centralized language switching logic for more consistent i18n handling
  • Additional translation keys for better localization coverage
  • Internationalization support for equipment planning, calendar, and sidebar components
  • Playwright upgrade and i18n support in E2E tests
  • GHCR publish workflow for container images

🤝 Contributors

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

  • @TomsaJ — internationalization for equipment planning, calendar, and sidebar components
  • @Wollycobbles — dashboard links, tab routing, map overflow fix, hive count fix, and repository cleanup
  • @RedWaxxx — French translation
  • @MacNite — German translations via Weblate and GHCR publish workflow
  • @MarianKlemm — German translations via Weblate
  • @prasneg — Serbian translations via Weblate
  • @janchrillesen — Danish translations via Weblate

Keep your hive records organized — from photos in the field to documents in the office! 🐝📁

v0.16.0 Breaking risk
Breaking changes
  • Frontend and backend now ship as a single unified Docker image; separate containers must be replaced.
Notable features
  • Edit hive details directly from the hive detail page with a pre‑populated form.
  • LLM Prompt Generator creates a structured AI prompt summarizing hive state for health assessment.
  • Quick Checks allow lightweight observations, tags, notes, and up to 5 photos per hive.
Full changelog

Version v0.16.0 The Bee Whisperer

Released: 2026-02-28

🚀 What's New

Edit Hive

You can now edit hive details directly from the hive detail page. Update name, apiary, notes, installation date, advanced settings, and box configuration — all from a single form that loads pre-populated with the hive's current data.

LLM Prompt Generator

Generate a structured prompt summarizing your hive's current state — including queen info, box configuration, health scores, alerts, and recent inspection history — ready to paste into your preferred AI assistant for a hive health assessment. Available from the "LLM Prompt" button in the hive detail sidebar. You can review and edit the prompt before copying.

Quick Checks

A lightweight alternative to full inspections — record quick observations at the hive with just a few taps. Select observation tags (calm, defensive, healthy, varroa present, etc.) and reminder tags (needs super, low stores, queen issues, etc.), add an optional note, and attach up to 5 photos. Quick checks appear on the hive timeline alongside inspections and actions. Available from the hive detail sidebar and the dashboard.

Dashboard Activity Timeline

The dashboard now features a "Recent Activity" timeline showing inspections, actions, and quick checks across all hives in your active apiary. Each event displays the hive name so you can see activity at a glance. Click any event to navigate to its detail page. Filter by event type, date range, or specific hive using the hive filter dropdown.

Prisma 7 Migration

The backend has been upgraded to Prisma 7, bringing improved performance and better TypeScript integration for all database operations.

Italian Language Support

Hive Pal now supports Italian — thanks to @zero0n3 for the community contribution!

⚠️ Breaking Changes

Single Docker Image

The frontend and backend now ship as a single unified Docker image, simplifying deployment. If you were previously running separate frontend and backend containers, you'll need to switch to the new combined image.

🔧 Technical Improvements

  • Reusable Timeline Component: The hive timeline display has been extracted into a shared component, enabling timeline views in multiple places across the app
  • Optimized Weather Fetching: Weather data is now only fetched for users who have logged in recently, reducing unnecessary API calls
  • Optimized Query Logic: Improved retry logic and conditional fetching for better performance and reduced unnecessary network requests
  • Dependency Updates: Updated backend dependencies for security and performance improvements

Keep your hives happy and your data flowing! 🐝

v0.15.0 Breaking risk
Breaking changes
  • Removed the redundant "Box Type" (variant) dropdown; frame size now solely determines box variant.
Notable features
  • Smart Frame Size Filtering: secondary boxes show only compatible sizes based on main box's hive system.
  • Auto-Conversion on System Change: changing main box frame size automatically converts all secondary boxes to the equivalent size in the new hive system.
  • Queen Editing: directly update queen details (marking, color, year, source, status) and reassign queens from the hive detail page.
Full changelog

Released: 2026-02-25

🚀 What's New

Simplified Box Configuration

The box configurator has been streamlined by removing the redundant "Box Type" (variant) dropdown. Frame Size is now the single source of truth — selecting a frame size automatically determines the box variant behind the scenes.

Smart Frame Size Filtering

When configuring secondary boxes, the frame size dropdown now only shows sizes compatible with the main box's hive system. Custom frame sizes remain available for all configurations.

Auto-Conversion on System Change

Changing the main box's frame size to a different hive system (e.g., Langstroth to National) automatically converts all secondary boxes to the equivalent frame size in the new system.

Queen Editing

You can now edit queen details directly from the hive detail page. Update marking, color, year, source, status, and reassign a queen to a different hive.

Custom Frame Sizes

Users can now create custom frame sizes. After admin approval, custom sizes become available to all users.

🎨 UI/UX Improvements

  • Cleaner Box Visuals: Removed redundant variant label from box display — the frame size name already conveys this information
  • Less Confusion: No more seeing "Custom" in a variant dropdown when it refers to frame size custom options
  • Default Frame Size: New boxes now start with a matching frame size pre-selected

🐛 Bug Fixes

  • Queen Color Display: Fixed queen color circle not showing correctly for red and blue queens on the hive detail page, and added support for all available colors (purple, indigo, pink, gray, black)
  • Queen Edit Form Defaults: Fixed hive and status dropdowns not defaulting to the queen's current values when editing
  • Queen Edit Active Warning: The "hive already has an active queen" warning no longer incorrectly appears when editing the queen that is already assigned to that hive
  • Dark Mode Styling: Fixed numerous components that were missing dark mode color variants, causing light backgrounds and poor contrast in dark mode. Affected areas include inspection form rating bars, observation badges, calendar event cards, calendar sidebar, alert badges/cards/items, and feed type pill selectors

This release simplifies box configuration by letting the frame size drive everything. Less dropdowns, fewer decisions, same flexibility. 🐝

v0.14.2 Bugfix

Fixed automatic migration execution for the self‑hosted app.

Changelog

Fixes issue with migrations needed to be run manually in self hosted app

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

About

Stars
28
Forks
11
Languages
TypeScript Python Nix

Install & Platforms

Install via
docker-compose

Beta — feedback welcome: [email protected]