MeshCore-MQTT-WebFlasher

Standalone web flasher and serial configurator for MeshCore MQTT repeater firmware.

This repository ships a static browser application that can:

• flash published MeshCore MQTT firmware images over Web Serial
• capture existing device settings before changes are made
• apply radio, identity, WiFi, and MQTT settings from the same page
• verify the resulting runtime state after configuration
• serve the flasher through Nginx, Docker Compose, and an optional Cloudflare tunnel

The application is designed for ESP32 and ESP32-S3 MeshCore repeater targets whose firmware binaries and manifests are committed into this repository under firmware/.

Quick Start

Run locally with Docker

docker compose up --build -d

Open http://127.0.0.1:8080.

Production deployment

1. Copy .env.example to .env.
2. Set CLOUDFLARED_TOKEN.
3. Start the stack:

docker compose up --build -d

The static site is served by Nginx on port 8080, and cloudflared can publish it through the configured tunnel.

Documentation

Project documentation lives in docs/.

• docs/README.md: documentation index
• docs/project-overview.md: purpose, repo layout, supported hardware
• docs/user-guide.md: operator workflow from backup to verification
• docs/configuration-reference.md: full field and command reference
• docs/architecture.md: frontend, serial, flash, and data architecture
• docs/deployment.md: local preview, container deployment, publishing workflow
• docs/troubleshooting.md: common failure modes and recovery steps