Astra — Local Network Device Discovery

Project Overview

Astra is a cross-platform local network device discovery and classification system. A Go desktop agent, React Native mobile client, and Node.js/Express backend work together to scan your LAN and classify connected devices — routers, TVs, printers, cameras, IoT — using multiple discovery strategies: passive ARP table parsing, TCP port probing, mDNS/Bonjour (Zeroconf), and SSDP advertisement capture.

How It Works

Strategy profiles (label_core, fast, medium, full) combine discovery techniques with different runtime and accuracy tradeoffs. A pluggable strategy registry enables data-driven selection. Device classification uses an OUI vendor lookup table, hostname pattern matching, and service advertisement fingerprinting to generate typed device labels with confidence scores and enumerated reasoning.

Key Features

• Multi-strategy pluggable discovery: passive ARP, mDNS/Zeroconf, SSDP, TCP port probing
• Rule-based device classification with OUI vendor lookup and explainable confidence scoring
• Cross-platform passive ARP parsing (Windows, macOS, Linux) — no elevated privileges required for passive mode
• Monorepo architecture sharing TypeScript schemas across Go agent, React Native mobile, and Node.js backend
• Strategy evaluation framework with benchmark data for runtime/coverage tradeoff optimization

Technical Architecture

Mobile App

The Expo React Native client communicates with the Go agent over HTTP on port 7777, advertised via mDNS for zero-configuration discovery. TanStack React Query drives live scan polling. Zustand manages client-side device state. React Native BLE PLX extends discovery to nearby Bluetooth devices.