" aria-label="Chat log">
19 |
--------------------------------------------------------------------------------
/.github/dependabot.yml:
--------------------------------------------------------------------------------
1 | # Copyright © 2025-26 l5yth & contributors
2 | #
3 | # Licensed under the Apache License, Version 2.0 (the "License");
4 | # you may not use this file except in compliance with the License.
5 | # You may obtain a copy of the License at
6 | #
7 | # http://www.apache.org/licenses/LICENSE-2.0
8 | #
9 | # Unless required by applicable law or agreed to in writing, software
10 | # distributed under the License is distributed on an "AS IS" BASIS,
11 | # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 | # See the License for the specific language governing permissions and
13 | # limitations under the License.
14 |
15 | version: 2
16 | updates:
17 | - package-ecosystem: "ruby"
18 | directory: "/web"
19 | schedule:
20 | interval: "weekly"
21 | - package-ecosystem: "python"
22 | directory: "/"
23 | schedule:
24 | interval: "weekly"
25 |
--------------------------------------------------------------------------------
/app/android/settings.gradle.kts:
--------------------------------------------------------------------------------
1 | pluginManagement {
2 | val flutterSdkPath =
3 | run {
4 | val properties = java.util.Properties()
5 | file("local.properties").inputStream().use { properties.load(it) }
6 | val flutterSdkPath = properties.getProperty("flutter.sdk")
7 | require(flutterSdkPath != null) { "flutter.sdk not set in local.properties" }
8 | flutterSdkPath
9 | }
10 |
11 | includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")
12 |
13 | repositories {
14 | google()
15 | mavenCentral()
16 | gradlePluginPortal()
17 | }
18 | }
19 |
20 | plugins {
21 | id("dev.flutter.flutter-plugin-loader") version "1.0.0"
22 | id("com.android.application") version "8.11.1" apply false
23 | id("org.jetbrains.kotlin.android") version "2.2.20" apply false
24 | }
25 |
26 | include(":app")
27 |
--------------------------------------------------------------------------------
/web/lib/potato_mesh/application/errors.rb:
--------------------------------------------------------------------------------
1 | # Copyright © 2025-26 l5yth & contributors
2 | #
3 | # Licensed under the Apache License, Version 2.0 (the "License");
4 | # you may not use this file except in compliance with the License.
5 | # You may obtain a copy of the License at
6 | #
7 | # http://www.apache.org/licenses/LICENSE-2.0
8 | #
9 | # Unless required by applicable law or agreed to in writing, software
10 | # distributed under the License is distributed on an "AS IS" BASIS,
11 | # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 | # See the License for the specific language governing permissions and
13 | # limitations under the License.
14 |
15 | # frozen_string_literal: true
16 |
17 | module PotatoMesh
18 | module App
19 | # Raised when a remote instance fails to provide valid federation data.
20 | class InstanceFetchError < StandardError; end
21 | end
22 | end
23 |
--------------------------------------------------------------------------------
/app/ios/Flutter/AppFrameworkInfo.plist:
--------------------------------------------------------------------------------
1 |
2 |
3 |
17 | <% unless private_mode %>
18 | <%= erb :"shared/_chat_panel", locals: { full_screen: false } %>
19 | <% end %>
20 | <%= erb :"shared/_map_panel", locals: { full_screen: false } %>
21 |
22 |
23 | <%= erb :"shared/_nodes_table", locals: { full_screen: false } %>
24 |
--------------------------------------------------------------------------------
/data/migrations/20250310_add_message_reply_and_emoji_columns.sql:
--------------------------------------------------------------------------------
1 | -- Copyright © 2025-26 l5yth & contributors
2 | --
3 | -- Licensed under the Apache License, Version 2.0 (the "License");
4 | -- you may not use this file except in compliance with the License.
5 | -- You may obtain a copy of the License at
6 | --
7 | -- http://www.apache.org/licenses/LICENSE-2.0
8 | --
9 | -- Unless required by applicable law or agreed to in writing, software
10 | -- distributed under the License is distributed on an "AS IS" BASIS,
11 | -- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 | -- See the License for the specific language governing permissions and
13 | -- limitations under the License.
14 |
15 | -- Extend the messages table to capture reply relationships and emoji reactions.
16 |
17 | BEGIN;
18 | ALTER TABLE messages ADD COLUMN reply_id INTEGER;
19 | ALTER TABLE messages ADD COLUMN emoji TEXT;
20 | CREATE INDEX IF NOT EXISTS idx_messages_reply_id ON messages(reply_id);
21 | COMMIT;
22 |
--------------------------------------------------------------------------------
/data/__init__.py:
--------------------------------------------------------------------------------
1 | # Copyright © 2025-26 l5yth & contributors
2 | #
3 | # Licensed under the Apache License, Version 2.0 (the "License");
4 | # you may not use this file except in compliance with the License.
5 | # You may obtain a copy of the License at
6 | #
7 | # http://www.apache.org/licenses/LICENSE-2.0
8 | #
9 | # Unless required by applicable law or agreed to in writing, software
10 | # distributed under the License is distributed on an "AS IS" BASIS,
11 | # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 | # See the License for the specific language governing permissions and
13 | # limitations under the License.
14 |
15 | """Data utilities for the Potato Mesh synchronisation daemon.
16 |
17 | The ``data.mesh`` module exposes helpers for reading Meshtastic node and
18 | message information before forwarding it to the accompanying web application.
19 | """
20 |
21 | VERSION = "0.5.9"
22 | """Semantic version identifier shared with the dashboard and front-end."""
23 |
24 | __version__ = VERSION
25 |
--------------------------------------------------------------------------------
/data/ingestors.sql:
--------------------------------------------------------------------------------
1 | -- Copyright © 2025-26 l5yth & contributors
2 | --
3 | -- Licensed under the Apache License, Version 2.0 (the "License");
4 | -- you may not use this file except in compliance with the License.
5 | -- You may obtain a copy of the License at
6 | --
7 | -- http://www.apache.org/licenses/LICENSE-2.0
8 | --
9 | -- Unless required by applicable law or agreed to in writing, software
10 | -- distributed under the License is distributed on an "AS IS" BASIS,
11 | -- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 | -- See the License for the specific language governing permissions and
13 | -- limitations under the License.
14 |
15 | PRAGMA journal_mode=WAL;
16 |
17 | CREATE TABLE IF NOT EXISTS ingestors (
18 | node_id TEXT PRIMARY KEY,
19 | start_time INTEGER NOT NULL,
20 | last_seen_time INTEGER NOT NULL,
21 | version TEXT,
22 | lora_freq INTEGER,
23 | modem_preset TEXT
24 | );
25 |
26 | CREATE INDEX IF NOT EXISTS idx_ingestors_last_seen ON ingestors(last_seen_time);
27 |
--------------------------------------------------------------------------------
/data/migrations/20250301_add_lora_columns.sql:
--------------------------------------------------------------------------------
1 | -- Copyright © 2025-26 l5yth & contributors
2 | --
3 | -- Licensed under the Apache License, Version 2.0 (the "License");
4 | -- you may not use this file except in compliance with the License.
5 | -- You may obtain a copy of the License at
6 | --
7 | -- http://www.apache.org/licenses/LICENSE-2.0
8 | --
9 | -- Unless required by applicable law or agreed to in writing, software
10 | -- distributed under the License is distributed on an "AS IS" BASIS,
11 | -- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 | -- See the License for the specific language governing permissions and
13 | -- limitations under the License.
14 |
15 | -- Extend the nodes and messages tables with LoRa metadata columns.
16 |
17 | BEGIN;
18 | ALTER TABLE nodes ADD COLUMN lora_freq INTEGER;
19 | ALTER TABLE nodes ADD COLUMN modem_preset TEXT;
20 | ALTER TABLE messages ADD COLUMN lora_freq INTEGER;
21 | ALTER TABLE messages ADD COLUMN modem_preset TEXT;
22 | ALTER TABLE messages ADD COLUMN channel_name TEXT;
23 | COMMIT;
24 |
--------------------------------------------------------------------------------
/web/views/chat.erb:
--------------------------------------------------------------------------------
1 |
16 | <% if private_mode %>
17 |
18 |
23 |
19 | <%= erb :"shared/_map_panel", locals: { full_screen: true } %>
20 |
21 | <%= erb :"shared/_instances_table" %>
22 | Network telemetry trends
19 |Aggregated telemetry snapshots from every node in the past week.
20 |
22 |
24 | Loading aggregated telemetry charts…
23 |" id="mapPanel">
19 |
20 |
44 |
45 |
--------------------------------------------------------------------------------
/app/ios/Runner/Info.plist:
--------------------------------------------------------------------------------
1 |
2 |
3 | 28 | <%= Rack::Utils.escape_html(short_display) %> 29 | <% if long_display %> 30 | <%= Rack::Utils.escape_html(long_display) %> 31 | <% end %> 32 | <% if identifier_display && !identifier_display.empty? %> 33 | [<%= Rack::Utils.escape_html(identifier_display) %>] 34 | <% end %> 35 |
36 |Loading node details…
38 | 41 |
17 |
18 |
19 |
34 |
35 |
--------------------------------------------------------------------------------
/web/spec/worker_pool_spec.rb:
--------------------------------------------------------------------------------
1 | # Copyright © 2025-26 l5yth & contributors
2 | #
3 | # Licensed under the Apache License, Version 2.0 (the "License");
4 | # you may not use this file except in compliance with the License.
5 | # You may obtain a copy of the License at
6 | #
7 | # http://www.apache.org/licenses/LICENSE-2.0
8 | #
9 | # Unless required by applicable law or agreed to in writing, software
10 | # distributed under the License is distributed on an "AS IS" BASIS,
11 | # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 | # See the License for the specific language governing permissions and
13 | # limitations under the License.
14 |
15 | # frozen_string_literal: true
16 |
17 | require "spec_helper"
18 | require "timeout"
19 |
20 | RSpec.describe PotatoMesh::App::WorkerPool do
21 | def with_pool(size: 2, queue: 2)
22 | pool = PotatoMesh::App::WorkerPool.new(size: size, max_queue: queue, name: "spec-pool")
23 | yield pool
24 | ensure
25 | pool&.shutdown(timeout: 0.5)
26 | end
27 |
28 | describe "#schedule" do
29 | it "executes jobs asynchronously and exposes their return values" do
30 | with_pool do |pool|
31 | task = pool.schedule { 21 + 21 }
32 | expect(task.wait(timeout: 1)).to eq(42)
33 | end
34 | end
35 |
36 | it "propagates exceptions raised by the job block" do
37 | with_pool do |pool|
38 | task = pool.schedule { raise ArgumentError, "boom" }
39 | expect { task.wait(timeout: 1) }.to raise_error(ArgumentError, "boom")
40 | end
41 | end
42 |
43 | it "raises an error when the queue is saturated" do
44 | with_pool(size: 1, queue: 1) do |pool|
45 | gate = Queue.new
46 | first_task = pool.schedule { gate.pop; :first }
47 |
48 | Timeout.timeout(1) do
49 | sleep 0.01 until gate.num_waiting.positive?
50 | end
51 |
52 | second_task = pool.schedule { gate.pop; :second }
53 |
54 | expect do
55 | pool.schedule { :third }
56 | end.to raise_error(described_class::QueueFullError)
57 |
58 | gate << nil
59 | gate << nil
60 | expect(first_task.wait(timeout: 1)).to eq(:first)
61 | expect(second_task.wait(timeout: 1)).to eq(:second)
62 | end
63 | end
64 | end
65 |
66 | describe "#shutdown" do
67 | it "prevents new work from being scheduled" do
68 | pool = described_class.new(size: 1, max_queue: 1, name: "spec-pool")
69 | pool.shutdown(timeout: 0.5)
70 |
71 | expect do
72 | pool.schedule { :after_shutdown }
73 | end.to raise_error(described_class::ShutdownError)
74 | ensure
75 | pool.shutdown(timeout: 0.5)
76 | end
77 | end
78 |
79 | describe PotatoMesh::App::WorkerPool::Task do
80 | it "raises a timeout when the job exceeds the provided deadline" do
81 | with_pool do |pool|
82 | task = pool.schedule { sleep 0.1; :done }
83 | expect do
84 | task.wait(timeout: 0.01)
85 | end.to raise_error(PotatoMesh::App::WorkerPool::TaskTimeoutError)
86 | expect(task.wait(timeout: 1)).to eq(:done)
87 | end
88 | end
89 |
90 | it "reports completion status" do
91 | with_pool do |pool|
92 | task = pool.schedule { :result }
93 | expect(task.complete?).to be(false)
94 | expect(task.wait(timeout: 1)).to eq(:result)
95 | expect(task.complete?).to be(true)
96 | end
97 | end
98 | end
99 | end
100 |
--------------------------------------------------------------------------------
/web/public/assets/js/app/__tests__/chat-log-highlights.test.js:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright © 2025-26 l5yth & contributors
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 |
17 | import test from 'node:test';
18 | import assert from 'node:assert/strict';
19 |
20 | import { formatPositionHighlights, formatTelemetryHighlights } from '../chat-log-highlights.js';
21 |
22 | test('formatTelemetryHighlights includes formatted numeric metrics', () => {
23 | const highlights = formatTelemetryHighlights({
24 | temperature: 21.44,
25 | relative_humidity: 54.27,
26 | });
27 |
28 | assert.deepEqual(highlights, [
29 | { label: 'Temperature', value: '21.4°C' },
30 | { label: 'Humidity', value: '54.3%' },
31 | ]);
32 | });
33 |
34 | test('formatTelemetryHighlights prefers nested telemetry when top-level values are stale', () => {
35 | const highlights = formatTelemetryHighlights({
36 | channel_utilization: 0,
37 | device_metrics: { channelUtilization: 0.561 },
38 | });
39 |
40 | assert.deepEqual(highlights, [
41 | { label: 'Channel Util', value: '0.561%' },
42 | ]);
43 | });
44 |
45 | test('formatPositionHighlights renders coordinate and movement data', () => {
46 | const highlights = formatPositionHighlights({
47 | latitude: 52.1234567,
48 | longitude: 13.7654321,
49 | altitude: 150.5,
50 | accuracy: 3.2,
51 | speed: 1.234,
52 | heading: 181.6,
53 | satellites: 7,
54 | });
55 |
56 | assert.deepEqual(highlights, [
57 | { label: 'Lat', value: '52.12346' },
58 | { label: 'Lon', value: '13.76543' },
59 | { label: 'Alt', value: '150.5m' },
60 | { label: 'Accuracy', value: '3.2m' },
61 | { label: 'Speed', value: '1.2 m/s' },
62 | { label: 'Heading', value: '182°' },
63 | { label: 'Sats', value: '7' },
64 | ]);
65 | });
66 |
67 | test('formatPositionHighlights normalises integer microdegree fields', () => {
68 | const highlights = formatPositionHighlights({
69 | position: {
70 | latitude_i: 52_123_456,
71 | longitude_i: 13_765_432,
72 | },
73 | });
74 |
75 | assert.deepEqual(highlights.slice(0, 2), [
76 | { label: 'Lat', value: '52.12346' },
77 | { label: 'Lon', value: '13.76543' },
78 | ]);
79 | });
80 |
81 | test('formatters return empty arrays when payloads are missing', () => {
82 | assert.deepEqual(formatTelemetryHighlights(null), []);
83 | assert.deepEqual(formatPositionHighlights(undefined), []);
84 | assert.deepEqual(formatPositionHighlights({}), []);
85 | });
86 |
87 | test('formatPositionHighlights omits zero-valued movement metrics while keeping coordinates', () => {
88 | const highlights = formatPositionHighlights({
89 | latitude: 0,
90 | longitude: 0,
91 | altitude: 0,
92 | speed: '0',
93 | accuracy: 0,
94 | });
95 |
96 | assert.deepEqual(highlights, [
97 | { label: 'Lat', value: '0.00000' },
98 | { label: 'Lon', value: '0.00000' },
99 | ]);
100 | });
101 |
--------------------------------------------------------------------------------
/web/Dockerfile:
--------------------------------------------------------------------------------
1 | # syntax=docker/dockerfile:1.6
2 | # Copyright © 2025-26 l5yth & contributors
3 | #
4 | # Licensed under the Apache License, Version 2.0 (the "License");
5 | # you may not use this file except in compliance with the License.
6 | # You may obtain a copy of the License at
7 | #
8 | # http://www.apache.org/licenses/LICENSE-2.0
9 | #
10 | # Unless required by applicable law or agreed to in writing, software
11 | # distributed under the License is distributed on an "AS IS" BASIS,
12 | # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | # See the License for the specific language governing permissions and
14 | # limitations under the License.
15 |
16 | # Main application builder stage
17 | FROM ruby:3.3-alpine AS builder
18 |
19 | # Ensure native extensions are built against musl libc rather than
20 | # using glibc precompiled binaries (which fail on Alpine).
21 | ENV BUNDLE_FORCE_RUBY_PLATFORM=true
22 |
23 | # Install build dependencies and SQLite3
24 | RUN apk add --no-cache \
25 | build-base \
26 | sqlite-dev \
27 | linux-headers \
28 | pkgconfig
29 |
30 | # Set working directory
31 | WORKDIR /app
32 |
33 | # Copy Gemfile and install dependencies
34 | COPY web/Gemfile web/Gemfile.lock* ./
35 |
36 | # Install gems with SQLite3 support
37 | RUN bundle config set --local force_ruby_platform true && \
38 | bundle config set --local without 'development test' && \
39 | bundle install --jobs=4 --retry=3
40 |
41 | # Production stage
42 | FROM ruby:3.3-alpine AS production
43 |
44 | # Install runtime dependencies
45 | RUN apk add --no-cache \
46 | sqlite \
47 | tzdata \
48 | curl
49 |
50 | # Create non-root user
51 | RUN addgroup -g 1000 -S potatomesh && \
52 | adduser -u 1000 -S potatomesh -G potatomesh
53 |
54 | # Set working directory
55 | WORKDIR /app
56 |
57 | # Copy installed gems from builder stage
58 | COPY --from=builder /usr/local/bundle /usr/local/bundle
59 |
60 | # Copy application code (excluding the Dockerfile which is not required at runtime)
61 | COPY --chown=potatomesh:potatomesh web/app.rb ./
62 | COPY --chown=potatomesh:potatomesh web/app.sh ./
63 | COPY --chown=potatomesh:potatomesh web/Gemfile ./
64 | COPY --chown=potatomesh:potatomesh web/Gemfile.lock* ./
65 | COPY --chown=potatomesh:potatomesh web/lib ./lib
66 | COPY --chown=potatomesh:potatomesh web/spec ./spec
67 | COPY --chown=potatomesh:potatomesh web/public ./public
68 | COPY --chown=potatomesh:potatomesh web/views ./views
69 | COPY --chown=potatomesh:potatomesh web/scripts ./scripts
70 |
71 | # Copy SQL schema files from data directory
72 | COPY --chown=potatomesh:potatomesh data/*.sql /data/
73 |
74 | # Create data and configuration directories with correct ownership
75 | RUN mkdir -p /app/.local/share/potato-mesh \
76 | && mkdir -p /app/.config/potato-mesh/well-known \
77 | && chown -R potatomesh:potatomesh /app/.local/share /app/.config
78 |
79 | # Switch to non-root user
80 | USER potatomesh
81 |
82 | # Expose port
83 | EXPOSE 41447
84 |
85 | # Default environment variables (can be overridden by host)
86 | ENV RACK_ENV=production \
87 | APP_ENV=production \
88 | XDG_DATA_HOME=/app/.local/share \
89 | XDG_CONFIG_HOME=/app/.config \
90 | SITE_NAME="PotatoMesh Demo" \
91 | CHANNEL="#LongFast" \
92 | FREQUENCY="915MHz" \
93 | MAP_CENTER="38.761944,-27.090833" \
94 | MAP_ZOOM="" \
95 | MAX_DISTANCE=42 \
96 | CONTACT_LINK="#potatomesh:dod.ngo" \
97 | DEBUG=0
98 |
99 | # Start the application
100 | CMD ["ruby", "app.rb", "-p", "41447", "-o", "0.0.0.0"]
101 |
--------------------------------------------------------------------------------
/app/ios/Runner/Base.lproj/LaunchScreen.storyboard:
--------------------------------------------------------------------------------
1 |
2 | | Name | 21 |Domain | 22 |Contact | 23 |Version | 24 |Channel | 25 |Frequency | 26 |Active Nodes (24h) | 27 |Latitude | 28 |Longitude | 29 |Last Update | 30 |
|---|