Calendink/Provider/.agents/workflows/frontend-ota.md at ebb0ccecf4dc81233d117ddb9e7cceae454c48e9

Files

Patedam 56acf92f75 Added a workflow to let the agent automatically deploy frontend onto the esp32.

2026-03-08 15:19:17 -04:00

description

description
Build, package, and deploy frontend updates via OTA

This workflow automates the process of building the frontend, packaging it into a LittleFS binary, and uploading it to the ESP32 device.

Important

Ensure VITE_API_BASE in frontend/.env is set to the target device's IP address.

Build and Package Frontend Run the following command in the frontend/ directory to build the production assets and create the versioned .bin file:
```
npm run build:esp32 && npm run ota:package
```
Deploy Update Run the deployment script to upload the latest version to the device:
```
npm run ota:deploy
```
Verify Update Wait for the device to reboot and verify the changes on the dashboard.

If you also need to update the firmware, use the universal bundle workflow:

Build Firmware From the project root:
```
idf.py build
```
Create Bundle In the frontend/ directory:
```
npm run ota:bundle
```
Deploy Bundle In the frontend/ directory:
```
npm run ota:deploy-bundle
```