Developers and research
Esta página aún no está disponible en tu idioma.
Sukrara is built in the open. Every feature starts as an investigation: a standalone proof of concept with a written
report of what was tried, what worked and what was measured. Then it’s built anew in the apps, which are tested against
the same shared contracts: alert rules and timeline scenarios, the glucose card’s layout, the settings schema and the
sharing protocol. These pages are the repository’s own docs/ folder, published as they are.
Behaviour catalogEvery behaviour of every app, with its rules and numbers.
ArchitectureHow the apps are built and what they share.
DevelopmentSetup, devices, signing, releases, everyday commands.
Manual QAWhat automated checks can't see, surface by surface.
The code, the shared contracts and the issues are on GitHub (GPL-3.0). The sharing protocol is becoming an open standard: the Open Glucose Stream.
Investigations
Section titled “Investigations”| # | Report | Goal | Updated |
|---|---|---|---|
| 01 | Getting live Libre 3 glucose onto a Mac, without the cloud | Replace the current setup — an xbar plugin polling LibreLinkUp over the internet — with a macOS menubar item showing the glucose number and a precise trend… | 27 oct 2026 |
| 02 | The phone app reads the sensor itself (no Juggluco) | In PoC 1 the phone companion (GlucoBridge) got its data from Juggluco's local web server. That means two apps, an HTTP server on loopback, and a dependency… | 27 oct 2026 |
| 03 | Nostr as the backbone of a no-hosting Nightscout alternative | Bluetooth (PoC 1/2) covers "nearby, no network". The bigger idea: a Nightscout alternative that needs no self-hosting and no technical knowledge — install… | 27 oct 2026 |
| 04 | Insulin, carbs and glucose to LibreView, from the phone and the Mac | The doctor reads LibreView, so whatever replaces Juggluco must keep feeding it: glucose, and the insulin / carbs / notes the user logs. Juggluco does this… | 18 nov 2026 |
| 05 | Glucose in the Android status bar | Show the glucose number and trend permanently in the phone's status bar, like the Mac menubar item. Three candidate approaches were given (Live Update chip,… | 27 oct 2026 |
| 06 | Sharing, follower apps and key management without lock-in | 03 proved Nostr carries the data. It left the user-facing parts open, and the user asked for them: | 27 oct 2026 |
| 07 | Bluetooth followers | Owner phone = peripheral / GATT server (advertises the service UUID in the advertising packet and no scan response: the phone's Bluetooth name, often its… | 10 nov 2026 |
| 08 | Glucose on a Garmin watch without Juggluco | Feed the Garmin Connect IQ glucose apps the user already runs with our own phone app and no other CGM app (no Juggluco, xDrip+ or GlucoDataHandler). The… | 27 oct 2026 |
| 09 | A name, an icon and a basic style for the showcase app | The next step bundles every proven feature (menubar, BLE bridge, direct sensor, LibreView, Nostr, status bar, Garmin) into one showcase app that the user… | 14 nov 2026 |
| 10 | Sukrara: the showcase app | Put every feature proven in investigations 01–09 into one Android app that the user runs for a few days, to judge whether it's useful, what's buggy and how… | 18 nov 2026 |
| 12 | Android home-screen widgets | Glucose on the home screen with native-feeling widgets: current value (number, continuous trend arrow, age, colour by range, stale state), graph (last… | 11 nov 2026 |
| 13 | macOS widgets (desktop + Notification Center) | WidgetKit widgets for the Mac (desktop and Notification Center) that show glucose: | 27 oct 2026 |
| 14 | Nostr identity: profiles, short invites, logging in with Nostr | The user asked for: | 27 oct 2026 |
| 15 | Glucose alerts, sound packs and haptics | Alerts when glucose leaves your range, in every Sukrara app (Android wearer, Android follower, Mac), with: | 12 nov 2026 |
| 16 | One glucose graph everywhere: time in range, freshness, rings | One improved picture for every place Sukrara shows glucose (app, home-screen widgets, the notification, the Mac menubar and Mac widgets), from the user's draft: | 11 nov 2026 |
| 17 | Glucose and quick treatments on the lock screen | The lower part of the Pixel's lock screen is empty: below the notifications, around the fingerprint icon, above the flashlight/camera shortcuts. The user… | 11 nov 2026 |
| 18 | The doctor's report in the app: time in ranges, average, GMI, variability | LibreView's report for the doctor (the AGP page) sums up a period in a few numbers with goals next to them. The user wants the same numbers in Sukrara, in… | 17 oct 2026 |
| 19 | Notification templates: can the glucose card use the space under the icon? | The user showed Google Maps' navigation notification on their Android 17 phone: title and text beside the app icon, then a progress bar and an Exit… | 27 oct 2026 |
| 20 | Publishing Sukrara: Homebrew, notarized Mac builds, Google Play, F-Droid and the Garmin store | Sukrara ships today as GitHub Release files: an APK signed with the debug keystore (app.mauri.sukrara.poc) and a Mac dmg/zip signed with a free Apple… | 17 nov 2026 |
| 21 | Starting a new sensor: one guided flow from home to the first reading | The user: "Make a better UI and UX for starting a new sensor. The current settings page doesn't look like it is waiting for it to be scanned with NFC. And… | 18 oct 2026 |
| 22 | Sukrara in the diabetes-tech ecosystem: outputs and gaps | The user wants Sukrara to be "more connectable to the diabetes techie scene" and to be able to replace Juggluco. Questions: | 10 nov 2026 |
| 23 | More sensors, more brands: what Sukrara can read besides the Libre 3 | The user: "Eventually I want to support as many sensors as possible from any brand, starting with Dexcom. If some of the sensors Juggluco supports are… | 10 nov 2026 |
| 24 | An open standard for CGM sharing over Nostr and Bluetooth | The user wants Sukrara's sharing protocols "standardized so other apps could attach to it — making a proper standard would be cool". The biggest privacy… | 15 nov 2026 |
| 24b | Open Glucose Stream draft 3: a clean-sheet standard | The user, 2026-10-19: "Do a draft 3 that defines the spec without being biased to what Sukrara had implemented. It is fine if it includes breaking changes… | 18 nov 2026 |
| 24c | Independent review of Open Glucose Stream draft 3 | The reviewer approached draft 3 as a skeptical expert in applied cryptography, Nostr, BLE and health-data interoperability, and wasn't involved in writing… | 15 nov 2026 |
| 25 | Nightscout upload: glucose and treatments to the user's own Nightscout | 22 ranked Nightscout upload as Sukrara's biggest gap: iPhone followers (LoopFollow, nightguard, Trio's "Nightscout as CGM"), Nightscout reports and Home… | 10 nov 2026 |
| 26 | The full AGP report: percentile profile, daily profiles, a page for the doctor | 18 put the AGP report's numbers into Sukrara: time in ranges, average, GMI, CV, with the consensus goals, on a home card and in the Mac's Glucose Report… | 27 oct 2026 |
| 27 | Tidepool upload | docs/22 listed Tidepool upload as gap #7 (deferred). The user asked for it: Sukrara uploads the wearer's readings and treatments to the user's Tidepool… | 10 nov 2026 |
| 28 | Choosing an insulin pump: Tandem Mobi, t:slim X2 or MiniMed 780G | The user's endocrinology team at Hospital Universitari Doctor Josep Trueta (ICS, Girona) offered a pump: Tandem Mobi, Tandem t:slim X2 or MiniMed 780G. The… | 15 nov 2026 |
| 29 | NovoPen Echo Plus: tap the pen, the insulin is logged | The user has a NovoPen Echo Plus (NFC, 0.5u steps, ~800 doses in memory, its own clock) and has typed every dose by hand for a long time. They want to hold… | 10 nov 2026 |
| 30 | Before the first unlock: what Sukrara can do after a restart (Direct Boot) | An overnight OS update, a crash, or Android's own restart of a phone left locked for days puts the phone in Before First Unlock (BFU): it boots, but the… | 11 nov 2026 |
| 31 | Encrypting the database: SQLCipher or not | What sukrara.db holds: readings (time, source, mg/dL, rate), treatments (insulin, carbs, notes, pen data, their authors), the follower ledger (gift-wrap… | 10 nov 2026 |
| 32 | Waking for the sensor: CompanionDeviceManager presence (Android) | A Libre 3 wearer's phone keeps one Bluetooth link to the sensor, held by Sukrara's connectedDevice foreground service. When Android kills that process… | 10 nov 2026 |
| 33 | Night compression lows: notice them, never silence them | 3 a.m. The phone rings Low glucose · 58 ↓↓. Either the glucose really is low and the person must eat now, or they have been lying on the arm with the… | 10 nov 2026 |
| 34 | The trend from the readings: which math | The arrow beside the value answers "where is it going?", the question behind most decisions about food and insulin. Today it comes from the sensor's own… | 14 nov 2026 |
| 35 | Settings organisation: what belongs where, on both apps | The settings grew one section at a time and some sit where they don't belong. The owner (2026-11-14): the new trend-arrow setting (#204) isn't a Graph… | 14 nov 2026 |
| 36 | One glucose notification: can it also ring the alerts? | The owner, 2026-11-14, about the Pixel 10 Pro (Android 17, rooted, release 5e669eb5): | 16 nov 2026 |
| 37 | The treatment list: design | Home's Last 24 hours is checked in a hurry: "did I already bolus for this?", "how much did I eat at lunch?", "why did I go high after that?". The answer… | 14 nov 2026 |
| 38 | A setting the app sets, that a place can change | Some settings have one value for the app, the notification and the widgets (Mac: the menu bar panel and the widgets), and a place may differ. The owner:… | 14 nov 2026 |
| 39 | Metrics beside the value (once "Rings") | The owner: Settings › Rings "needs a complete redesign … there isnt any hierarchy or grouping … if ring is disabled think how the group should be … maybe …… | 15 nov 2026 |
| 40 | Feature checks, sharing permissions, *Can add treatments* | The owner, 2026-11-15: Settings › Sharing › Over Bluetooth nearby said in red that a permission was missing, and nothing outside that page did. Can add… | 15 nov 2026 |
| 41 | Libre 2 glucose to LibreView, read through Juggluco | The owner's LibreView had no glucose after 2 Nov 18:59. Their Libre 3 Plus ended then, and since 3 Nov they've worn a Libre 2 read through Juggluco. Sukrara… | 18 nov 2026 |
| 42 | Watch faces: what it takes to design a good one | The owner wants Sukrara watch faces, the first for their Garmin Descent Mk3i, later more designed by other agents. The brief, in their words: a face that… | 16 nov 2026 |
| 43 | Getting readings to Sukrara Aura on a Garmin | Sukrara Aura (contracts/watchface/aura) must show what the phone's Sukrara shows, a new reading within seconds when the watch is in reach (SPEC §13), right… | 17 nov 2026 |
| 44 | External sources: glucose from the official apps and online accounts | The owner's words (the issue and its three comments), condensed: | 18 nov 2026 |
| 45 | Two uploaders on one LibreView account | 44 decision 4 sends nothing to LibreView while the official app uploads, treatments neither, because "LibreView takes uploads from only one app per… | 18 nov 2026 |