Add tvOS app: TCP mesh map with Bonjour discovery

Meshtastic TV/App/ConnectView.swift

@@ -0,0 +1,122 @@
+//
+//  ConnectView.swift
+//  Meshtastic TV
+//
+//  Copyright(c) Garth Vander Houwen 7/24/26.
+//
+//  Bonjour-discovered nodes (tap to connect) plus manual host / port entry,
+//  under a Meshtastic logo hero.
+//
+
+import SwiftUI
+
+struct ConnectView: View {
+	@Bindable var client: MeshClient
+	@StateObject private var discovery = NodeDiscovery()
+
+	@AppStorage("tv.lastHost") private var host: String = ""
+	@AppStorage("tv.lastPort") private var portText: String = "4403"
+
+	var body: some View {
+		NavigationStack {
+			HStack(alignment: .top, spacing: 60) {
+				hero
+					.frame(maxWidth: 640)
+
+				Form {
+					discoveredSection
+
+					Section("Manual Connection") {
+						TextField("IP address or hostname", text: $host)
+							.keyboardType(.URL)
+							.textContentType(.URL)
+							.autocorrectionDisabled()
+						TextField("Port", text: $portText)
+							.keyboardType(.numberPad)
+						Button {
+							client.connect(host: trimmedHost, port: port)
+						} label: {
+							Label("Connect", systemImage: "network")
+						}
+						.disabled(trimmedHost.isEmpty)
+					}
+
+					if case .failed(let message) = client.state {
+						Section {
+							Label(message, systemImage: "exclamationmark.triangle.fill")
+								.foregroundStyle(.red)
+						}
+					}
+
+					Section {
+						NavigationLink {
+							SettingsView()
+						} label: {
+							Label("Settings", systemImage: "gearshape")
+						}
+					}
+				}
+			}
+			.padding(.top, 40)
+		}
+	}
+
+	private var hero: some View {
+		VStack(alignment: .leading, spacing: 28) {
+			Image("meshtastic-wordmark-white")
+				.resizable()
+				.scaledToFit()
+				.frame(width: 620)
+			Text("Connect to a Meshtastic node on your network and watch the mesh live on the big screen.")
+				.font(.title3)
+				.foregroundStyle(.secondary)
+				.fixedSize(horizontal: false, vertical: true)
+			Label("Radios advertising TCP appear automatically", systemImage: "bonjour")
+				.font(.callout)
+				.foregroundStyle(Color("LightIndigo"))
+		}
+		.frame(maxHeight: .infinity, alignment: .top)
+	}
+
+	@ViewBuilder
+	private var discoveredSection: some View {
+		Section {
+			if discovery.discovered.isEmpty {
+				HStack(spacing: 16) {
+					ProgressView()
+					Text("Searching the local network…")
+						.foregroundStyle(.secondary)
+				}
+			} else {
+				ForEach(discovery.discovered) { node in
+					Button {
+						client.connect(host: node.host, port: node.port)
+					} label: {
+						HStack(spacing: 16) {
+							Image(systemName: "antenna.radiowaves.left.and.right")
+								.foregroundStyle(Color("LightIndigo"))
+							VStack(alignment: .leading, spacing: 4) {
+								Text(node.name)
+								Text(verbatim: "\(node.host):\(String(node.port))")
+									.font(.caption)
+									.foregroundStyle(.secondary)
+							}
+						}
+					}
+				}
+			}
+		} header: {
+			Text("Discovered Nodes")
+		}
+		.onAppear { discovery.start() }
+		.onDisappear { discovery.stop() }
+	}
+
+	private var trimmedHost: String {
+		host.trimmingCharacters(in: .whitespacesAndNewlines)
+	}
+
+	private var port: Int {
+		Int(portText.trimmingCharacters(in: .whitespaces)) ?? 4403
+	}
+}

Meshtastic TV/App/MapScreen.swift

@@ -0,0 +1,172 @@
+//
+//  MapScreen.swift
+//  Meshtastic TV
+//
+//  Copyright(c) Garth Vander Houwen 7/24/26.
+//
+//  Live mesh map with a focusable node side-list for Siri Remote operation.
+//  The list is the primary, reliable selection path on tvOS; clicking a pin on
+//  the map (focus engine) selects too and keeps the list in sync. Rows carry the
+//  same node-color circle badges as the map pins (CircleText, shared with iOS).
+//
+
+import SwiftUI
+import SwiftData
+
+struct MapScreen: View {
+	@Bindable var client: MeshClient
+	@State private var selectedNodeNum: UInt32?
+	@State private var recenterToken = 0
+	// Row focus is the browse signal on tvOS: List(selection:) does not follow
+	// focus for NavigationLink rows, so track it explicitly and mirror it into
+	// the map selection (debounced map-side).
+	@FocusState private var focusedNodeNum: UInt32?
+	@State private var navPath: [UInt32] = []
+
+	/// The persisted node store — the map and list read from here, not the client.
+	@Query private var allNodes: [MeshNode]
+
+	/// All nodes for the side list: located first, then alphabetically.
+	private var sortedNodes: [MeshNode] {
+		allNodes.sorted {
+			if $0.hasLocation != $1.hasLocation { return $0.hasLocation }
+			return $0.displayName.localizedCaseInsensitiveCompare($1.displayName) == .orderedAscending
+		}
+	}
+
+	/// Located nodes, most-recently-heard first — the map's data source.
+	private var locatedNodes: [MeshNode] {
+		allNodes.filter(\.hasLocation)
+			.sorted { ($0.lastHeard ?? .distantPast) > ($1.lastHeard ?? .distantPast) }
+	}
+
+	var body: some View {
+		HStack(spacing: 0) {
+			nodeList
+				.frame(width: 520)
+
+			MeshTVMapView(
+				nodes: locatedNodes,
+				selectedNodeNum: $selectedNodeNum,
+				recenterToken: recenterToken,
+				onMenuExit: escapeMap
+			)
+			.ignoresSafeArea()
+		}
+	}
+
+	/// Menu pressed while the map held focus: pop any open node detail and hand
+	/// focus back to the node list — without this, MKMapView is a focus trap.
+	private func escapeMap() {
+		navPath = []
+		focusedNodeNum = selectedNodeNum ?? sortedNodes.first?.num
+	}
+
+	private var nodeList: some View {
+		NavigationStack(path: $navPath) {
+			List {
+				// Map controls live in the list column — the overlay buttons were
+				// unreachable by remote once the map started capturing focus.
+				Section {
+					Button {
+						selectedNodeNum = nil
+						recenterToken += 1
+					} label: {
+						Label("Re-center Map", systemImage: "scope")
+					}
+					NavigationLink {
+						SettingsView()
+					} label: {
+						Label("Settings", systemImage: "gearshape")
+					}
+					Button(role: .destructive) {
+						client.disconnect()
+					} label: {
+						Label("Disconnect", systemImage: "xmark.circle.fill")
+					}
+				}
+
+				Section {
+					ForEach(sortedNodes) { node in
+						NavigationLink(value: node.num) {
+							NodeRow(node: node)
+						}
+						.focused($focusedNodeNum, equals: node.num)
+					}
+				} header: {
+					Text("\(allNodes.count) nodes · \(locatedNodes.count) on map")
+				}
+			}
+			.onChange(of: focusedNodeNum) { _, newValue in
+				if let newValue { selectedNodeNum = newValue }
+			}
+			.navigationDestination(for: UInt32.self) { num in
+				if let node = allNodes.first(where: { $0.num == num }) {
+					NodeDetailView(node: node)
+				}
+			}
+			.safeAreaInset(edge: .top) {
+				header
+			}
+		}
+	}
+
+	private var header: some View {
+		HStack(spacing: 20) {
+			VStack(alignment: .leading, spacing: 6) {
+				Image("meshtastic-wordmark-white")
+					.resizable()
+					.scaledToFit()
+					.frame(height: 30)
+				Text(client.host)
+					.font(.caption)
+					.foregroundStyle(.secondary)
+			}
+			Spacer()
+		}
+		.padding(.horizontal, 32)
+		.padding(.vertical, 16)
+	}
+
+	private var disconnectButton: some View {
+		Button(role: .destructive) {
+			client.disconnect()
+		} label: {
+			Label("Disconnect", systemImage: "xmark.circle.fill")
+		}
+		.buttonStyle(.bordered)
+	}
+}
+
+private struct NodeRow: View {
+	let node: MeshNode
+
+	var body: some View {
+		HStack(spacing: 16) {
+			// Same circle badge as the map pin (node color + short name).
+			CircleText(
+				text: node.shortName.isEmpty ? "?" : node.shortName,
+				color: Color(UIColor(hex: node.num)),
+				circleSize: 52
+			)
+			.opacity(node.hasLocation ? 1 : 0.45)
+
+			VStack(alignment: .leading, spacing: 4) {
+				Text(node.displayName)
+					.lineLimit(1)
+				HStack(spacing: 12) {
+					if let battery = node.batteryLevel {
+						Label("\(battery)%", systemImage: battery > 20 ? "battery.75percent" : "battery.25percent")
+							.foregroundStyle(Color("LightIndigo"))
+					}
+					if !node.hasLocation {
+						Label("No position", systemImage: "location.slash")
+							.foregroundStyle(.secondary)
+					}
+				}
+				.font(.caption)
+			}
+			Spacer()
+		}
+	}
+}

Meshtastic TV/App/MeshtasticTVApp.swift

@@ -0,0 +1,33 @@
+//
+//  MeshtasticTVApp.swift
+//  Meshtastic TV
+//
+//  Copyright(c) Garth Vander Houwen 7/24/26.
+//
+//  Apple TV client: connect to a Meshtastic node over TCP and show a live mesh map
+//  operable with the Siri Remote.
+//
+
+import SwiftUI
+import SwiftData
+
+@main
+struct MeshtasticTVApp: App {
+	private let container: ModelContainer
+	@State private var client: MeshClient
+
+	init() {
+		// Slim tvOS-local store — just `MeshNode` (see MeshNode.swift). Persists the
+		// node database so the map is populated on relaunch before the radio re-dumps.
+		let container = try! ModelContainer(for: MeshNode.self)
+		self.container = container
+		_client = State(initialValue: MeshClient(context: container.mainContext))
+	}
+
+	var body: some Scene {
+		WindowGroup {
+			RootView(client: client)
+		}
+		.modelContainer(container)
+	}
+}

Meshtastic TV/App/RootView.swift

@@ -0,0 +1,58 @@
+//
+//  RootView.swift
+//  Meshtastic TV
+//
+//  Copyright(c) Garth Vander Houwen 7/24/26.
+//
+
+import SwiftUI
+import UIKit
+
+struct RootView: View {
+	@Bindable var client: MeshClient
+	@Environment(\.scenePhase) private var scenePhase
+
+	var body: some View {
+		Group {
+			switch client.state {
+			case .connected:
+				MapScreen(client: client)
+			case .connecting:
+				ConnectingView(host: client.host) { client.disconnect() }
+			case .disconnected, .failed:
+				ConnectView(client: client)
+			}
+		}
+		// Meshtastic brand green (the Live Activity / widget tint).
+		.tint(Color("LightIndigo"))
+		// This app is a live wall display: keep the big screen awake so the tvOS
+		// screensaver never interrupts the mesh map while the app is foregrounded.
+		// Re-asserted on every active transition because the system can reset the
+		// flag when the app returns to the foreground.
+		.onAppear { UIApplication.shared.isIdleTimerDisabled = true }
+		.onChange(of: scenePhase) { _, phase in
+			UIApplication.shared.isIdleTimerDisabled = (phase == .active)
+		}
+	}
+}
+
+private struct ConnectingView: View {
+	let host: String
+	let onCancel: () -> Void
+
+	var body: some View {
+		VStack(spacing: 48) {
+			Image("m-logo-white")
+				.resizable()
+				.scaledToFit()
+				.frame(width: 280)
+			ProgressView()
+				.scaleEffect(1.6)
+				.tint(Color("LightIndigo"))
+			Text("Connecting to \(host)…")
+				.font(.title2)
+				.foregroundStyle(.secondary)
+			Button("Cancel", action: onCancel)
+		}
+	}
+}