The MeshCore Companion App - a web-based interface for connecting to and managing MeshCore Companion LoRa devices.

Current version: v1.45.0 (build 71)

This is the web version of the MeshCore Companion App, built with Flutter. It allows you to connect to MeshCore devices via Bluetooth Low Energy (BLE) or USB Serial directly from your web browser, enabling you to send messages, manage contacts, and interact with the MeshCore mesh network.

To run it: pull the pre-built Docker image ghcr.io/axistem-dev/meshcore-web:latest This repo mainly publishes that image, hosts the static web build, and documents maintainer workflows.

• Connect to MeshCore Companion devices via BLE or USB Serial
• Send and receive messages on the mesh network
• Manage contacts, channels and remote repeaters
• View network topology and node information
• Real-time mesh network interaction
• Docker deployment for containerized hosting

Chrome/Edge (desktop or Android) via HTTPS or localhost access required for functionality.

The MeshCore Companion App is the original application created by Liam Cottle.

App stores & hosted web:

• Android: Google Play Store
• iOS: App Store
• Web: MeshCore Web App (also this repo’s Docker image)

Desktop & web archives on files.liamcottle.net/MeshCore, per version:

• Web builds (this repository)
• macOS
• Windows
• Linux (x86_64 .zip and .AppImage)

Run the MeshCore web app in a container (nginx on Alpine). Use the published image:

ghcr.io/axistem-dev/meshcore-web:latest

Pull and run the image directly (works on any machine with Docker):

docker run -d \
  -p 8080:80 \
  --restart unless-stopped \
  --name meshcore-web \
  ghcr.io/axistem-dev/meshcore-web:latest

Open http://localhost:8080

To use another port, change -p (e.g. -p 3000:80 for http://localhost:3000).

Clone this repo only if you want the included docker-compose.yml (same image, plus health check and restart policy):

git clone https://github.com/aXistem-dev/meshcore-web.git
cd meshcore-web
docker compose up -d

Only if you need a custom image built from this repository’s files:

git clone https://github.com/aXistem-dev/meshcore-web.git
cd meshcore-web
docker build -t meshcore-web .
docker run -d -p 8080:80 --name meshcore-web meshcore-web

For maintainers refreshing this repository from upstream web builds.

• ./update-from-source.sh — Downloads and updates files locally only (does not commit changes)
• ./update-from-source-and-push.sh — Downloads, updates README.md, commits, and pushes to this repository

For manual updates, see the Manual Update Workflow section below.

When updating to a new version manually:

1. Download the new version from the MeshCore releases (e.g., MeshCore-v1.44.0+70-86c0436-web.zip)

2. Extract and replace files in the repository:

   • Extract the zip file
   • Copy all files from the web/ directory to the repository root

3. Verify changes by checking unstaged files:

   git status
   git diff

4. Update README.md with the new version:

   • Update the version number and build number in the "Current version" line
   • Update the download link URL to match the new version

5. Stage and commit all changes:

   git add -A
   git commit -m "Update to v1.XX.X (build XX)"

6. Verify the commit includes all necessary files:

   git log -1 --stat

The MeshCore Companion App is closed source, built with Flutter, and is free for anyone to use.

Use of the app is subject to the Privacy Policy.

• Official Website: meshcore.io

This repository contains the web build files of the MeshCore Companion App, maintained by aXistem. The original MeshCore Companion App is developed by Liam Cottle (Liam's GitHub page). See the Privacy Policy for data practices.