🌌 HeadsUp v1.0.0 — Reclaiming Presence in a World of Screens (Initial Release)
"The next time you see someone lost in their screen — that's the moment. And notice: it might be you."
HeadsUp is a local-first, privacy-respecting Android application built to map collective digital distraction and help us return to the immediate physical world.
✨ Features in this Release
- 🤫 Screenless Logging (No-Look Gesture): Intercept physical Volume Up/Down key presses in your pocket to log screen distraction. A subtle haptic tick confirms the log, acting as a prompt to breathe and re-center.
- 🗺️ Ambient Mapping (Geohash Grid): Renders a dark-themed map clustering observations inside 5km Geohash-5 zones using concentric brass-colored glows to protect user privacy.
- 🔋 Local-First Cache: Saves logs offline inside a Room SQLite database with a 3-second rate-limiter to ensure logs are conscious and deliberate.
- 📊 Serverless Sheets Sync: Dynamically synchronizes tap logs in real-time with a personal Google Sheet via a lightweight Apps Script Web App.
📲 How to Install & Configure
- Download
HeadsUp-release.apkfrom the assets below. - Tap the file on your device and allow installation from unknown sources if prompted.
- Open the app, navigate to settings, and link your Google Sheet URL (see
BACKEND_SETUP.mdfor steps).