Wifi Scan

open source
Wifi Scan preview
Mar 2026 - Mar 2026
TypeScriptPythonReactReact NativeFastAPIPostgreSQLScapyExpoTailwind CSS

Privacy-first occupancy tracking via ARP scanning with a React dashboard, React Native app, and FastAPI backend

Full-stack presence-sensing platform that turns any local Wi-Fi network into an occupancy engine with no extra hardware required. The Python backend performs ARP sweeps every 30 s with Scapy (nmap fallback), records devices in PostgreSQL, and exposes a FastAPI REST API consumed by both a React + Vite admin dashboard (deployed to GitHub Pages) and a React Native + Expo mobile app with background geofencing.

Privacy-first occupancy tracker powered entirely by existing Wi-Fi infrastructure. • Backend: FastAPI + Uvicorn; SQLAlchemy ORM against PostgreSQL; background ARP scanner using Scapy with nmap fallback. • Detection: devices not seen in 5 minutes are marked offline; round-trip variance (pseudo-CSI) estimates physical movement. • Admin Dashboard: React + Vite + Tailwind deployed to GitHub Pages; 7-day heatmap, muster report, energy recommendations. • Mobile App: React Native via Expo with Tailwind/NativeWind; background geofencing task sends heartbeat within 100 m radius. • Features: Ghost Mode, guest alerts, real-time headcount, 7-day day×hour occupancy heatmap. • CI/CD: GitHub Actions builds and deploys admin dashboard to GitHub Pages on every push to main.