# Hive monitor

Hive monitor is a frontend for displaying data from MQTT server receiving events from bee hives. The complementary project [hivemonitor-ESP32-firmware]() reads sensor values and publishes on MQTT topic.

Complemetary hivemonitor repositories:

- [Hive monitor ESP32 Firmware](https://github.com/kevinmidboe/hivemonitor-esp32-firmware)
- [Hive monitor ESP32 PCB design](https://github.com/kevinmidboe/hivemonitor-pcb)

## Preview

[Preview site](https://hive.schleppe.cloud)

![Hive monitor site, 4 pages](https://github.com/KevinMidboe/hivemonitor/assets/2287769/7fdb3f1c-3f2b-4e1f-b8c8-290b7e6d1d2b)

# Requirements

This sveltekit project requires Node.js and yarn installed:

- [node.js]()
- [yarn]()

Page requires data from MQTT topic, use a public or locally hosted MQTT broker:

- [Connect to public broker]()
- [Setup and connect to self hosted broker]()

# Config

Set `PUBLIC_MQTT_BROKER_WS_URL` environment variable for MQTT broker. Since browsers don't support MQTT natively we want to connect to MQTT over WebSockets for events.

```bash
cp .env.example .env

# edit .env in favorite text editor
# PUBLIC_MQTT_BROKER_WS_URL=ws://test.mosquitto.org
```

# Run

Using docker:

```bash
docker run -d -p 8080:8080 --name hivemonitor ghcr.io/kevinmidboe/hivemonitor
```

# Setup

## Install

Clone repo, navigate into folder and install node dependencies:

```bash
git clone https://github.com/KevinMidboe/hivemonitor.git
cd hivemonitor
yarn
```

## Development

Run development server using `yarn dev` command. Add `--host` flag for allowing connections for any device on same network.

## Production

Build static files and serve them with your favorite webserver, or use included docker configuration.

Compile project into static files located at generated folder: ./build.

```bash
yarn build
```

Build and run using nginx in docker:

```bash
docker build -t hivemonitor .
docker run -p 8080:8080 --name hivemonitor-frontend hivemonitor
```

## Example mqtt payloads

should automate generating interfaces or grpc.

telemetry/gateway/[id]:

```json
{
	"gateway_name": "Elisabeth",
	"t": "2025-02-08 15:03:30",
	"temperature": "22",
	"battery_level": "20"
}
```

telemetry/hive/[id]:

```json
{
	"hive_name": "Elisabeth",
	"t": "2025-02-08 15:03:30",
	"temperature": "22",
	"humidity": "30",
	"pressure": "30",
	"weight": "30",
	"battery_level": "20"
}
```