aprs.me/docs/README.md

aprs.me Documentation

APRS packet visualization and tracking platform built with Phoenix LiveView + PostGIS.

Architecture

• Architecture Overview — System components, data flow, and design decisions
• Ingestion Pipeline — APRS-IS → GenStage → Postgres → PubSub broadcast

Domain Contexts

• Accounts — User registration, authentication, session management
• Packets — Packet storage, querying, replay, weather, and spatial search
• Devices — APRS device identification and registry

Web Layer

• LiveView Map — MapLive architecture, real-time streaming, components
• LiveView Pages — Packet streams, weather, status, info, auth pages
• REST API — API v1 endpoints (callsign lookup, weather nearby)
• Mobile WebSocket — MobileChannel protocol for iOS/Android apps

Infrastructure

• Deployment — Kubernetes (ArgoCD), Fly.io, Docker, Nix dev shell
• Observability — PromEx metrics, error tracking, telemetry

Development

• Setup Guide — Local dev environment, required services, tooling

Features & Plans

• Tracked Callsign Behavior
• Trail Line Visualization
• Plans — Design documents and implementation plans
• Improvement Todos

API

• Mobile API Reference — WebSocket message format for mobile clients