MeshWeb

Decentralized Web Over LoRa - A mesh network for hosting and browsing web pages without internet connectivity.

Overview

MeshWeb enables decentralized web browsing over LoRa radio, allowing users to:

• Host web pages on nodes that broadcast their content over LoRa
• Browse pages using companion devices that request and display HTML
• Discover nodes automatically as they announce their hosted pages
• Chat with other companions on the mesh network

Perfect for off-grid communication, disaster scenarios, or building local community networks.

Screenshots

Left to right: Node discovery, Companion discovery, Chat between companions, Hosted web page, Page download complete

Architecture

┌─────────────────┐         LoRa          ┌─────────────────┐
│   Host Node     │◄──────────────────────►│   Companion     │
│  (Heltec V3)    │   PAGE_ANNOUNCE        │  (XIAO/Heltec)  │
│                 │   PAGE_REQUEST         │                 │
│  Serves HTML    │   PAGE_DATA            │  Browse pages   │
│  files over     │                        │  via WiFi AP    │
│  LoRa radio     │                        │                 │
└─────────────────┘                        └─────────────────┘
                                                   │
                                              WiFi │
                                                   ▼
                                           ┌──────────────┐
                                           │   Phone/     │
                                           │   Laptop     │
                                           │   Browser    │
                                           └──────────────┘

Components

/host - Host Node Firmware

ESP32 + LoRa device that:

• Hosts HTML/CSS/JS files on SPIFFS
• Broadcasts PAGE_ANNOUNCE every 60 seconds
• Responds to page requests with chunked data
• Provides web interface for file management (/upload)

Supported boards: Heltec WiFi LoRa 32 V3

/companion - Companion Firmware

ESP32 + LoRa device that:

• Discovers host nodes on the mesh
• Requests and displays web pages
• Creates WiFi AP for phone/laptop to connect
• Supports companion-to-companion messaging

Supported boards: Seeed XIAO ESP32-S3 + Wio-SX1262, Heltec WiFi LoRa 32 V3

/android - Android App

Flutter-based mobile browser for MeshWeb (connects via WiFi to companion).

Quick Start

1. Flash a Host Node

cd host
pio run -e heltec-v3 -t upload

2. Flash a Companion

cd companion
# For XIAO ESP32-S3:
pio run -e xiao_esp32s3 -t upload

# For Heltec V3:
pio run -e heltec_v3 -t upload

3. Connect and Browse

1. Connect your phone/laptop to the companion's WiFi AP
   • SSID: MeshWeb-Browser - <name>
   • Password: meshweb123
2. Open browser to http://192.168.4.1
3. Click on discovered nodes to browse their pages

WiFi Credentials

Device	SSID Pattern	Password
Companion	MeshWeb-Browser - <name>	meshweb123
Host Node	MeshCore-Web - <name>	meshcore123

Protocol

MeshWeb uses a custom protocol over LoRa:

Message Type	Code	Description
PAGE_ANNOUNCE	0x01	Host broadcasts available pages
PAGE_REQUEST	0x02	Companion requests a page
PAGE_DATA	0x03	Host sends page chunks
COMPANION_ANNOUNCE	0x10	Companion announces presence
COMPANION_MESSAGE	0x11	Chat between companions

Radio Settings

• Frequency: 915.0 MHz (US ISM band)
• Bandwidth: 250 kHz
• Spreading Factor: 9
• Sync Word: 0x12

Creating Mesh Links

Link to pages on other nodes using the mesh:// protocol:

<a href="mesh://9e75cd90/index.html">Visit Node 9e75cd90</a>

The node ID is shown in the companion's web interface.

Features

• ✅ Automatic node discovery
• ✅ Progress bar during page downloads
• ✅ Inter-node linking with mesh:// protocol
• ✅ File upload/delete on host nodes
• ✅ Companion-to-companion chat
• ✅ Multiple companion support with request filtering

License

MIT License - See LICENSE for details.

Contributing

Contributions welcome! Please open an issue or PR.