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.
