Sukrara (alpha)

Sukrara shows live glucose from a FreeStyle Libre 3 on your Android phone (read straight from the sensor) and on the Mac menu bar of the people who look after you (or your own). It alerts you when glucose goes low or high or stops arriving, lets you log insulin and carbs in seconds, and shares readings end-to-end encrypted over public Nostr relays or Bluetooth nearby. There's no cloud account to create and no server to host. The name is Catalan-ish: sucre (sugar) + ara (now).

Not a medical device (see the disclaimer). Releases are GitHub prereleases until they've been tested on a real sensor.

What it does today

The full catalog, with every rule and number, is docs/FEATURES.md. In short:

Android (you wear the sensor)

• Reads the Libre 3 / 3 Plus directly: hold the phone to the sensor to start a new one or take over a running one (NFC), then Sukrara keeps it connected over Bluetooth by itself, with 24 h backfill and automatic reconnects. It uses your LibreView account's receiver ID (sign in once, only to get the ID), so a sensor can move between Sukrara and Abbott's app. Or read from Juggluco's local web server if Juggluco keeps the sensor.
• A guided new sensor screen: where the NFC antenna is, warm-up countdown, every failure handled on the same screen (ended sensor, Libre 1/2, another app holding the sensor, Bluetooth off).
• Settings › Sensor: the current sensor (status, serial, start, end and time left), the reading source (Libre 3 directly or Juggluco, saying first what changes), the LibreView account (email and receiver ID, sign in / out; the password is never stored) and Pair new sensor.
• Home screen, glucose first: the value, trend arrow and a 6 h chart you can scroll back, the sensor's end date, one banner at a time for what needs you (monitoring stopped, alerts may not ring, damaged saved data, finish setup), and the last 24 h of treatments with delete + undo. Never a bare "---": when there's no value it says why and what to do.
• A live notification that is also a Live Update chip next to the clock (Android 16 QPR2+), with the same freshness steps as the card: from 5 min the number is struck through, from 20 min it's gone. Tap → Add treatment.
• Alerts: very low, low, high, very high, rising / falling fast and no data; each on its own channel, "like an alarm" ones pass Do Not Disturb. Mute…, Remind less, Unmute and Change time on the notification, in the app and with TalkBack; Mute all with a visible strip to undo it. The no-data check runs from an exact alarm, independent of the monitoring service. A Sensor ends in 6 h warning before the sensor's end.
• Monitoring in one foreground service that comes back by itself (boot, update, a 15 min health check); before the first reading every surface says Not monitoring: no sensor yet and no no-data alarm is armed.
• Treatments: a quick dialog for rapid / long insulin, carbs and a note (from the notification, the Quick Settings tile Add treatment or home), with a short countdown when opened on the lock screen.
• Home-screen widgets (Glucose, Glucose graph, Glucose and graph) drawn by the same card renderer at the widget's real size; home offers Add widget until a graph widget is placed, and a tap opens Add treatment.
• Settings for daily use: alerts (thresholds you confirm, repeats, sounds, quiet rules), an alert reliability checklist with Fix buttons (notifications, alarms, full-screen, battery, Do Not Disturb, Bluetooth), ranges, graph basics, sensor, and About with an update check against this repo's releases.
• Sharing core: your sharing identity, restorable from its recovery code so existing followers keep following; readings and alerts go to approved followers over Nostr relays (protocol v2). If another device is publishing as the same identity, Sukrara stops and says so instead of fighting it.
• First-run setup in a calm, fixed order: role (confirmed) → what alerts need → sensor → confirm your alert thresholds → your followers (restore once this phone has your sensor, or start fresh) → home. Any step can wait; home's Finish setup banner brings it back.
• Sharing screens: invite one person (QR that springs in, link to send or copy, works once for 24 h), allow or deny their request after comparing a 4-digit code, see and remove followers (confirmed), and a clear screen when another device is sharing as you.
• English and Spanish (Spain) everywhere.

Mac (you follow someone, from the menu bar)

• The value, trend arrow and mute bell in the menu bar, struck through when old; click for the panel with the card and chart (drawn by the same renderer rules as Android, tested against the same fixtures).
• Follow a wearer with an invite link, a QR code image or nearby Bluetooth pairing; readings, alerts and treatments arrive end-to-end encrypted. A setup window walks Welcome → Follow → Alerts → Notifications → Open at login.
• Alerts with sound packs and the same rules and timeline scenarios as Android; mute and unmute from the menu.
• Treatments: add rapid / long / carbs / note, see the phone's entries, delete your own with undo.
• Settings: General (following, unit, open at login, update check) and Alerts (per alert, quiet times, sounds, ranges); it can mirror the wearer's alert settings.
• Desktop widgets (Glucose, Glucose graph, Glucose + graph) with the same card; they age by themselves (struck through at 5 min, the graph dimmed with the reading's time, no value at 20 min) and a tap opens Add treatment.
• VoiceOver reads the value as one sentence with the range in words.

Not included: the root status-bar icons and the LSPosed lock-screen widget, Dexcom / Aidex / SmartGuide (untested) sensors, Garmin via the local xDrip+ server, Nightscout / Tidepool / LibreView uploads, Health Connect and broadcasts, insulin pens, the full sensor reminders page and calendar event, the glucose report and CSV export, settings export / import, following on Android and Bluetooth sharing from the phone, and the Mac's Juggluco-over-Wi-Fi source.

Garmin watch: Sukrara has no watch server yet. A watch fed by Juggluco keeps working while Juggluco reads the sensor: pick Juggluco as Sukrara's source (Settings › Sensor › Juggluco).

Install

Downloads are on GitHub releases.

• Android (Android 16+, arm64): download Sukrara-<version>.apk on the phone and open it; allow installs from your browser when asked. Updates install over the old version and keep your data. With Obtainium, turn on Include prereleases.
• Mac (Apple Silicon, macOS 15+): download Sukrara-<version>.dmg and drag Sukrara onto Applications. The app isn't notarized yet: the first open is stopped; click Done, then System Settings → Privacy & Security → Open Anyway (Apple: open a Mac app from an unknown developer). Sukrara lives in the menu bar (no Dock icon). Homebrew (mauriciabad/tap) installs stable releases only.
• From this repo (the owner's devices): tools/install.sh phone|mac builds the release, verifies it and installs it in place. It refuses a dirty tree, unmerged work or failing checks. On the Mac it makes Sukrara the sukrara: link handler.

Repository layout

apps/
  android/       Sukrara for Android (Kotlin, Compose; Gradle root)               → apps/android/README.md
  macos/         Sukrara for Mac (Swift 6, SwiftPM; menu bar app + widget)         → apps/macos/README.md
contracts/       what every app agrees on: alert rules + scenarios, card fixtures, settings schema, protocol,
                 treatments, export, sensor traces (every app's tests read it)      → contracts/README.md
assets/brand/    app icons and brand art
docs/            FEATURES.md (behaviour catalog), ARCHITECTURE.md, DEVELOPMENT.md, QA.md, the investigation
                 reports (NN-*.md); also the sukrara.mauri.app site
tools/           check/ (CLAUDE.md as checks), hooks/, install.sh, release/, settings/gen.py
poc/             the frozen research PoC: spikes/ and spec/ (Open Glucose Stream); reference only
third_party/     local only (gitignored): Juggluco, the Libre 3 native core's source

Each app is a folder in apps/ with its own build and README; every app tests itself against the same contracts/ and the same tools/check rules, so a new app is one more folder.

Build and test

Setup (JDK 21, Android SDK, Xcode, the Juggluco checkout, signing) is in docs/DEVELOPMENT.md; the rules in CLAUDE.md; the design in docs/ARCHITECTURE.md.

What	Command
Repo rules (run before committing; the git hooks run it after tools/hooks/install.sh)	tools/check/run.sh
Android: one module's tests	cd apps/android && ./gradlew :core:alerts:test
Android: debug APK	cd apps/android && ./gradlew :app:assembleDebug
Android: everything CI runs	cd apps/android && ./gradlew check
Mac: build + tests	cd apps/macos && swift build && swift test
Mac: app bundle with the widget	cd apps/macos && Bundle/bundle.sh (--unsigned without the signing identity)
Settings code after a schema change	python3 tools/settings/gen.py
Release builds	tools/release/android-release.sh, tools/release/mac-release.sh

Manual checks per surface: docs/QA.md. Release history: CHANGELOG.md. The investigations, one report each: docs/NN-*.md.

Disclaimer

• Not a medical device. Values may be wrong, late or missing, and alerts may not ring. Don't make treatment decisions or rely on alarms from anything in this repo.
• FreeStyle Libre is a trademark of Abbott. This project is not affiliated with Abbott or with Juggluco.
• The sensor is read for interoperability with the author's own glucose data. Per-sensor pairing data is a secret and is never committed here.
• The direct-sensor code also compiles Juggluco's GPLv3 sources, which are fetched separately and not included in this repo.

License

GPL-3.0-or-later. Use it, change it, share it — but anything you build on it has to stay open source under the same terms, and if you distribute a binary you have to offer its source too.

Copyright (C) 2026 Maurici Abad

This program is free software: you can redistribute it and/or modify it under the terms of the
GNU General Public License as published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version. It is distributed WITHOUT ANY WARRANTY; without
even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.