# SugarPaws documentation --- --- > iOS app for owners of diabetic cats: log blood glucose readings and insulin doses, see them charted against the cat's target range with a typical insulin-activity curve, keep a profile per cat, get twice-daily reminders, and share a PDF log with the vet or a CSV backup — all stored on the device. Runs on iPhone and iPad. --- --- # What is SugarPaws? Source: https://docs.neuralconfig.com/sugarpaws/ **SugarPaws** is a logbook for a diabetic cat. You type in each blood glucose reading off the meter and each insulin dose you give; the app keeps them per cat, shows the last reading and dose at the top of the entry screen so you can answer "did I already give the morning dose?", charts them against the target range your vet set, and turns any date range into a PDF report to hand to the vet or a CSV file to keep as a backup. It runs on iPhone and iPad (iOS or iPadOS 18 or later), is installed from the App Store, and stores everything on the device — there is no account, no cloud sync and no server. :::caution SugarPaws is **not a medical device** and does not give dosing advice. It records what you enter and shows it back to you. It does not evaluate your cat's control, suggest a dose, or replace your veterinarian — and its insulin activity curve is a textbook estimate, not a measurement of your cat. Every treatment decision, including changes to insulin dose or timing, belongs to your vet. ::: ## What SugarPaws does — and deliberately doesn't It **does**: log glucose readings (in mg/dL or mmol/L) and insulin doses (in 0.5-unit steps) with a time and a note; warn you before saving a likely duplicate, an implausible reading or an unusually high dose; show your history by day; chart readings and doses over 24 hours to 90 days or a custom range; draw a *typical* insulin activity curve for the insulin you use; keep separate profiles for several cats; remind you at set times twice a day; and export a PDF report or a CSV backup you can import again later. It **does not**: connect to a glucose meter or continuous monitor, sync between devices, calculate variability or "time in range" metrics, grade your cat's readings, or recommend doses. The Charts tab shows only counts, an average and the share of readings inside the target range — plain arithmetic over what you logged, because the published thresholds for anything fancier come from continuous monitors sampling every few minutes and do not transfer to two spot checks a day. ## What the app is made of Four tabs: **Add** (the *Quick Entry* screen, with a Glucose and an Insulin segment), **History**, **Charts** and **Settings**. With more than one cat profile a cat switcher bar appears at the top of every tab, under the screen title. First launch shows a scrollable medical disclaimer you must read to the bottom, then a three-step setup (name and photo, glucose unit, target range and insulin) that you can skip and finish later in Settings. ## Explore the docs ### Using the app - [Get started](https://docs.neuralconfig.com/sugarpaws/app/getting-started/): Requirements, the disclaimer, the three-step first-run setup, the four tabs, and what the header strip and toasts are telling you. - [Log a glucose reading](https://docs.neuralconfig.com/sugarpaws/app/logging-glucose/): Typing a reading, the recordable range in each unit, backdating, notes, and the 'Check before saving' warnings for duplicates and implausible values. - [Log an insulin dose](https://docs.neuralconfig.com/sugarpaws/app/logging-insulin/): The 0.5-unit wheel and how it is prefilled, the insulin type stamped on each dose, and the warnings for a second dose within an hour or more than 15 units. - [History](https://docs.neuralconfig.com/sugarpaws/app/history/): The All / Glucose / Insulin lists grouped by day, what the colours and arrows mean, swipe to delete, and the 5-second Undo. - [Charts and summary figures](https://docs.neuralconfig.com/sugarpaws/app/charts/): The glucose and insulin charts, the time ranges, the four summary tiles and exactly how they are computed, and the full-screen pan-and-zoom view. - [The insulin activity curve](https://docs.neuralconfig.com/sugarpaws/app/insulin-activity-curve/): What the estimate is built from — onset, peak and duration per insulin type — how doses combine, why the axis says Low/Mid/Peak, and what it must not be used for. - [Cat profiles and multiple cats](https://docs.neuralconfig.com/sugarpaws/app/cat-profiles/): Name, photo and target range, the range the app will accept, adding and switching cats, and what deleting a profile removes. - [Reminders](https://docs.neuralconfig.com/sugarpaws/app/reminders/): The four daily reminders and their default times, what happens when notifications are denied, and how a logged dose silences the next insulin reminder. - [Settings reference](https://docs.neuralconfig.com/sugarpaws/app/settings/): Every setting with its default: units, insulin type, appearance, default chart range, Always Show Disclaimer, Delete All Data, and the About links including the User Guide. ### Data, backup and reports - [PDF report for your vet](https://docs.neuralconfig.com/sugarpaws/data/vet-report/): Where to make it, the date presets, what page 1 and page 2 contain — and the short list of factual summary lines that are all the report will ever say about the numbers. - [CSV export (backup)](https://docs.neuralconfig.com/sugarpaws/data/csv-export/): The ten columns, why Value is always mg/dL while DisplayValue is your unit, one cat or all cats, and how the file reaches you. - [CSV import](https://docs.neuralconfig.com/sugarpaws/data/csv-import/): Required and optional columns, how units, cats and duplicates are handled, the merge prompt, and every reason a row can be skipped. - [Privacy and where your data lives](https://docs.neuralconfig.com/sugarpaws/data/privacy/): On-device Core Data only, no account or sync, the two permissions the app can ask for, and what leaves the phone when you share a file. - [Limits and ranges](https://docs.neuralconfig.com/sugarpaws/data/limits/): Every numeric bound in one place: recordable readings and doses, target range, note length, import limits, reminder count, undo window. ### When something looks wrong - [Troubleshooting](https://docs.neuralconfig.com/sugarpaws/troubleshooting/): 'Your data couldn't be loaded', reminders that never arrive, a greyed-out Save, imports that skip rows, a report that won't share, and the missing cat switcher. Need help? Reach the [support team](https://support.neuralconfig.com/sugarpaws?from=docs). --- # Get started with SugarPaws Source: https://docs.neuralconfig.com/sugarpaws/app/getting-started/ SugarPaws is a native app for **iPhone and iPad running iOS or iPadOS 18 or later**, distributed through the App Store. There is no web, Android or Mac version, and no account to create: the app works entirely on the device it is installed on — and because there is no sync, an iPhone and an iPad each keep their own separate log. On first launch it shows a medical disclaimer you have to scroll through and agree to, then a three-step setup for your cat; after that you land on the **Add** tab ready to log your first reading. Everything set up here can be changed later in Settings. :::note SugarPaws is published by NeuralConfig LLC (bundle `com.neuralconfig.sugarpaws`, version 1.0). Install it from the App Store on your iPhone or iPad; if you cannot find it or it will not install, ask the [support team](https://support.neuralconfig.com/sugarpaws?from=docs). ::: ## What happens on first launch 1. **Splash screen.** The SugarPaws logo and *Version 1.0*, for about a second (with Reduce Motion on, a plain half-second pause). If it ever stays longer than about three seconds, the app forces its way through on its own. 2. **Important Disclaimer.** A scrolling page with five sections — *Medical Disclaimer*, *Veterinary Consultation Required*, *No Liability*, *Data Accuracy* and *Emergency Situations*. The button at the bottom reads **Scroll to Read Full Disclaimer** and stays grey until you have scrolled to the very end; it then turns blue and reads **I Agree - Continue to SugarPaws**. You see this once. (Settings › Advanced › **Always Show Disclaimer** brings it back on every launch; deleting all data does *not* withdraw your agreement.) 3. **Set up SugarPaws** — three steps, each pre-filled and each skippable with the **Skip Setup** button in the top corner. Each step is saved the moment you leave it with **Next** (or **Done** on the last step), so quitting halfway keeps what you had already entered. **Skip Setup** does not save the step you are on: a name, photo or range typed on that step is dropped (the glucose unit and insulin choices are the exception — they are stored the moment you pick them). | Step | What it asks | Pre-filled with | |---|---|---| | 1 of 3 — *What's your cat's name?* | A name, and optionally a photo from your library. Choosing a photo opens **Position Photo**: drag to move, pinch or use the slider to zoom, so the face sits inside the circle. | The placeholder name **Unnamed cat** (replace it — an empty name is never saved over the existing one) | | 2 of 3 — *Which glucose unit do you use?* | **mg/dL** or **mmol/L**, matching your meter and your vet. Below it a worked example: *A reading of 180 mg/dL shows as 10.0 mmol/L*. | Guessed from your device's region: mg/dL for the US, Japan, Israel, India, Brazil, Mexico, Argentina, Chile, Colombia, Peru, Venezuela, Ecuador, Egypt, Turkey, Taiwan, South Korea, Thailand, Indonesia, the Philippines and Vietnam (and when the device has no region set); mmol/L everywhere else | | 3 of 3 — *Target range and insulin* | A minimum and maximum, in the unit you just chose (the range must sit inside 20–999 mg/dL / 1.1–55.5 mmol/L and the maximum must be higher than the minimum — **Done** is disabled until it does), and the insulin you use from a list of six | **80–180 mg/dL** (4.4–10.0 mmol/L) and **Lantus (Glargine)** | The target range is your vet's number, not the app's: SugarPaws only uses it to draw the dashed lines on the charts, colour readings in History and the last-reading strip, count *Readings in Range*, and fill the *vs target* column and colour key on the PDF report. Until it reflects your vet's guidance those figures are measuring against a placeholder. 4. **The app**, on the **Add** tab. ## The four tabs | Tab | Screen title | What it holds | Docs | |---|---|---|---| | **Add** | Quick Entry | A **Glucose** / **Insulin** segment switch above one entry form at a time; the cat header strip; the save toast | [Log a glucose reading](https://docs.neuralconfig.com/sugarpaws/app/logging-glucose/), [Log an insulin dose](https://docs.neuralconfig.com/sugarpaws/app/logging-insulin/) | | **History** | History | Every entry for the active cat, newest first, grouped by day, filterable to **All / Glucose / Insulin**; a share icon that opens Import/Export | [History](https://docs.neuralconfig.com/sugarpaws/app/history/) | | **Charts** | Charts | Glucose line chart, insulin bar chart, the insulin activity curve, four summary tiles; a **Report** button | [Charts](https://docs.neuralconfig.com/sugarpaws/app/charts/), [Insulin activity curve](https://docs.neuralconfig.com/sugarpaws/app/insulin-activity-curve/) | | **Settings** | Settings | Cat profile, units, insulin type, reminders, appearance, chart default, Export & Backup, Advanced, About | [Settings reference](https://docs.neuralconfig.com/sugarpaws/app/settings/) | At the top of every tab, just under the screen title, **only when you have more than one cat profile**, a **cat switcher bar** shows the active cat's photo and name with a chevron; tap it to pick another cat or **Manage Cats**. With a single cat there is no bar — see [Cat profiles](https://docs.neuralconfig.com/sugarpaws/app/cat-profiles/). ## The header strip on the Add tab Both entry forms start with the active cat's photo and name, and under the name a one-line **last reading · last dose** strip: for example *✓ 142 mg/dL 6 hours ago · 💉 2.0 u 6 hours ago*. The symbol before the reading is its position against the cat's target range (down arrow = below target, tick = in range, up arrow = above target); anything logged less than a minute ago reads *just now*. Before the first entries it says **No readings yet** and **No doses yet**. The strip refreshes when the app comes back to the foreground, so "12 hours ago" does not sit stale overnight. This strip is the app's answer to "did I already give the morning dose?" — you no longer need to open History to check. ## Save toasts, undo banners and error alerts - Saving shows a toast at the **top** of the Add tab — **Glucose reading saved** or **Insulin dose saved** — for two seconds, with a haptic tap as you press Save and a success buzz once it is written. There is no OK button to dismiss. - Deleting from History shows a black **Undo** banner at the bottom of the screen (just above the tab bar on iPhone) for five seconds — see [History](https://docs.neuralconfig.com/sugarpaws/app/history/). - If a save, delete or profile change fails at the database level, an alert titled for the action (*Couldn't Save Changes*, *Couldn't Delete Profile*, *Couldn't Create Profile*, *Couldn't Load Cats*, *Couldn't Delete Data*) says *Something went wrong: …* and nothing is written. If the database itself cannot be opened, the app shows **Your data couldn't be loaded** instead of the tabs — see [Troubleshooting](https://docs.neuralconfig.com/sugarpaws/troubleshooting/). ## Next steps - [Log a glucose reading](https://docs.neuralconfig.com/sugarpaws/app/logging-glucose/): Type the number off the meter, add a note, save. - [Log an insulin dose](https://docs.neuralconfig.com/sugarpaws/app/logging-insulin/): Pick the units on the wheel and save; the type is stamped from Settings. - [Reminders](https://docs.neuralconfig.com/sugarpaws/app/reminders/): Turn on the twice-daily glucose and insulin reminders. - [Cat profiles](https://docs.neuralconfig.com/sugarpaws/app/cat-profiles/): Fix the name, photo or target range, or add a second cat. --- # Log a glucose reading Source: https://docs.neuralconfig.com/sugarpaws/app/logging-glucose/ To log a reading, open the **Add** tab, leave the segment on **Glucose**, tap the big **Tap to enter** field, type the number your meter shows in the unit shown beside it, and tap **Save Glucose Reading**. The field is empty every time you come to it — SugarPaws never pre-fills a reading, so a stray tap on Save cannot record a plausible number you never measured. The reading is saved the instant you tap (before the toast animates), timestamped *now* unless you changed the time, and the last-reading strip at the top updates. ## The reading field | | mg/dL | mmol/L | |---|---|---| | Keyboard | Decimal pad | Decimal pad | | Recorded to | The whole number (105.6 → 106) | One decimal place (5.55 → 5.6) | | Lowest recordable | **20** | **1.1** | | Highest recordable | **999** | **55.5** | The ceiling is deliberately high: pet meters read up to about 750 mg/dL and a severely uncontrolled cat can exceed 600. A comma works as the decimal separator (`5,5`), because that is what the keypad inserts in many regions. **Save Glucose Reading** is grey and disabled while the field is empty. Once there is text it stays tappable even when the text is not a valid reading, so that tapping it can *tell you why* under the field instead of doing nothing. It still **looks** grey until the text is a recordable reading (it turns green then) — a grey button with text in the field is tappable, not broken: | Message under the field | Cause | |---|---| | **Enter a number in mg/dL.** (or mmol/L) | Not a number — letters, or a value with both `,` and `.` in it, which is locale-ambiguous and rejected rather than guessed at | | **Readings below 20 mg/dL can't be recorded.** (*1.1 mmol/L*) | Below the floor | | **Readings above 999 mg/dL can't be recorded.** (*55.5 mmol/L*) | Above the ceiling | Out-of-range input is **rejected, never clamped** — a mistyped 1500 does not quietly become 999. The message clears as soon as you start editing. :::tip If you switch the unit in Settings while a half-typed reading is on screen, the number is converted rather than wiped: 212 typed as mg/dL becomes 11.8 when you change to mmol/L. ::: ## Time and notes - **Time** is a compact date-and-time picker pre-set to now. Leave it alone and the reading is stamped at the moment you tap Save (not the moment you opened the screen); change it and your chosen time is used instead. You cannot pick a time in the future. It resets to *now* after every save. - **Notes (Optional)** is a free-text field, up to **500 characters** (anything longer is cut off as you type). Notes appear under the reading in History, in the CSV `Notes` column, and — truncated with an ellipsis to fit one line — in the PDF report. Tap **Done** on the keyboard bar, or drag the form, to dismiss the keyboard. Switching to the Insulin segment and back keeps whatever you had typed. ## "Check before saving" warnings Before writing, SugarPaws checks the reading and, if anything is unusual, shows one dialog titled **Check before saving** listing *every* applicable warning, ending *Double-check before saving.* — with **Save Anyway** and **Cancel**. Two conditions can trigger it: | Warning | When | |---|---| | **You logged this same reading *N* minutes ago.** | The most recent reading for this cat has the *same value* and its time is within **10 minutes** of this one. A genuinely repeated measurement will differ by at least a point, so this catches a double-tap. | | ***Value* *unit* is outside the range a cat's meter usually reads.** | The reading is below **40 mg/dL** or above **500 mg/dL**. The check runs on the stored mg/dL value, so in mmol/L it fires at **2.2 or lower** and **27.8 or higher** (2.2 × 18 = 39.6; 27.8 × 18 = 500.4). It is still recordable — the app is asking you to look twice, not refusing. | Both can appear together. Confirming one does not skip the other: a 700 mg/dL double-tap gets both lines in the same dialog. ## What the saved reading looks like elsewhere The value is stored in mg/dL whatever unit you type in (mmol/L × 18) and converted back for display, so changing the unit later re-labels every reading without altering it. In History the value is coloured and marked by its position against the cat's target range; the charts plot it as a red point; the CSV carries it in both `Value` (mg/dL) and `DisplayValue` (your unit). ## Next steps - [Log an insulin dose](https://docs.neuralconfig.com/sugarpaws/app/logging-insulin/): The other segment of the Add tab: the 0.5-unit wheel and its own warnings. - [History](https://docs.neuralconfig.com/sugarpaws/app/history/): Find, check and delete what you just logged. - [Cat profiles](https://docs.neuralconfig.com/sugarpaws/app/cat-profiles/): Set the target range that decides whether a reading shows as in range. - [Limits and ranges](https://docs.neuralconfig.com/sugarpaws/data/limits/): Every numeric bound in the app on one page. --- # Log an insulin dose Source: https://docs.neuralconfig.com/sugarpaws/app/logging-insulin/ To log a dose, open the **Add** tab, switch the segment to **Insulin**, spin the wheel to the number of units you gave, and tap **Save Insulin Dose**. The dose is written immediately, stamped *now* unless you changed the time, tagged with the insulin type currently selected in Settings, and the last-dose strip at the top updates. Logging a dose also silences a daily insulin reminder due within the next hour — see [Reminders](https://docs.neuralconfig.com/sugarpaws/app/reminders/). ## The dose wheel | | | |---|---| | Range | **0.5** to **99.0** units | | Step | **0.5** units | | Prefill | Your **last dose for this cat**, rounded *down* to the nearest half unit and kept inside 0.5–99; **1.0** if there is none. Set when the Add tab opens; after each save the wheel goes back to **1.0** | | Display | Always one decimal (*2.0 units*) | A wheel rather than a keypad because a dose is one of a small set of values, and a wheel cannot produce a number you did not see. The prefill rounds down, never to nearest — an imported 2.3-unit dose prefills as 2.0, not 2.5 — because over-dosing is the dangerous direction; you can always spin it up. What is saved is exactly what the wheel shows. The prefill is taken when the Add tab appears, not after every save: once you save a dose the wheel returns to **1.0**, and it picks up the new last dose the next time you come back to the tab. Two edge cases come from the 0.5–99 limits of the wheel — an imported 0.25-unit dose prefills as **0.5** (the one case that rounds up), and an imported dose above 99 units prefills as **99**. Doses off the half-unit grid (0.25 u, 2.3 u) can only enter the app through [CSV import](https://docs.neuralconfig.com/sugarpaws/data/csv-import/); they display with two decimals where needed and export as such. ## Insulin type The dose is stamped with the **Insulin Type** shown below the wheel — the one selected in Settings › Insulin Settings (default **Lantus (Glargine)**), or your custom name if you chose *Custom*. You cannot change it here; the row is read-only with an **ⓘ** button beside it that opens the **Insulin Profile** sheet for the type selected in Settings (onset, peak and duration in hours, and a key to the activity chart). With *Custom* selected the sheet is titled **Custom** and shows the generic Custom profile, not your custom name. If you switch insulins, change the setting first, then log. The recorded type matters later: the [insulin activity curve](https://docs.neuralconfig.com/sugarpaws/app/insulin-activity-curve/) models each dose with the insulin *it was recorded under*, so past doses keep their shape when you change the setting. ## Time and notes Same as for readings: the **Time** picker is pre-set to now and only used if you change it (no future times; resets after each save), and **Notes (Optional)** takes up to **500 characters**. Switching to the Glucose segment and back keeps your selection. ## "Check before saving" warnings Before writing, SugarPaws shows one **Check before saving** dialog listing every applicable warning, ending *Double-check before saving.*, with **Save Anyway** and **Cancel**. Two conditions trigger it: | Warning | When | |---|---| | **You logged an insulin dose *N* minutes ago. Giving insulin twice can cause dangerously low blood sugar.** | The most recent dose for this cat is within **60 minutes** of this one's time (either side — a backdated entry counts too). *Less than a minute ago* when under a minute. | | ***N* units is an unusually high dose for a cat.** | More than **15 units**. Typical feline doses are 1–6 units. | Both can appear in the same dialog. Confirming one never skips the other. ## Next steps - [The insulin activity curve](https://docs.neuralconfig.com/sugarpaws/app/insulin-activity-curve/): What the chart on the Charts tab does with the doses you log. - [Reminders](https://docs.neuralconfig.com/sugarpaws/app/reminders/): Daily insulin reminders, and how logging a dose suppresses the next one. - [Settings reference](https://docs.neuralconfig.com/sugarpaws/app/settings/): Change the insulin type or give a custom insulin a name. - [Log a glucose reading](https://docs.neuralconfig.com/sugarpaws/app/logging-glucose/): The other segment of the Add tab. --- # History Source: https://docs.neuralconfig.com/sugarpaws/app/history/ The **History** tab lists every glucose reading and insulin dose for the **active cat only**, newest first, in sections headed **Today**, **Yesterday** and then the weekday and date (*Monday, Aug 10*). The headers carry **no year**, so an entry from the same date last year (imported from an old backup, say) has an identical header — check the PDF report or CSV export, which include the year, when it matters. The segment control at the top switches between **All**, **Glucose** and **Insulin**. Swipe a row left to delete it; a five-second **Undo** banner lets you take that back. Nothing here edits an entry — to correct one, delete it and log it again. ## What a row shows | Row | Left | Right | |---|---|---| | Glucose | The value in your unit, coloured and marked by its position against the cat's target range, then the note (one line) | The time | | Insulin | The units (one decimal, or two when the dose is not a whole tenth — 2.3 shows *2.3*, 0.25 shows *0.25*), the word *units*, **• the insulin type**, then the note | The time | Range colours and symbols on a glucose row — never colour alone, so they read in greyscale and with VoiceOver: | Position | Colour | Symbol | |---|---|---| | Below the cat's target minimum | Blue | ↓ in a circle | | Inside the target range | Green | ✓ in a circle | | Above the target maximum | Orange | ↑ in a circle | The target range comes from the cat's profile ([Cat profiles](https://docs.neuralconfig.com/sugarpaws/app/cat-profiles/)); change it and every row recolours. With no entries the list reads **No Entries Yet — Log your first glucose reading or insulin dose from the Add tab.** With several cats, the list shows only the cat selected in the switcher bar; other cats' entries never appear mixed in. ## Deleting and undoing Swipe a row fully left (or swipe and tap **Delete**). The row disappears at once and a black banner appears at the bottom of the screen (just above the tab bar on iPhone) — **Glucose reading deleted** or **Insulin dose deleted** — with an **Undo** button. The banner stays for **5 seconds**; tap Undo within that time and the entry is restored exactly (same id, value, time, note). After five seconds the delete is final. Only the *most recent* delete can be undone: deleting a second entry replaces the first's Undo. The banner belongs to the whole app, so if you delete in History and switch tabs inside those five seconds you can still Undo from the Add or Charts tab. ## The share icon The square-and-arrow icon in the top right opens the **Import/Export** screen — the same one as Settings › **Export & Backup** — for the [PDF report](https://docs.neuralconfig.com/sugarpaws/data/vet-report/), [CSV export](https://docs.neuralconfig.com/sugarpaws/data/csv-export/) and [CSV import](https://docs.neuralconfig.com/sugarpaws/data/csv-import/). It does not share the list itself. ## Next steps - [Charts and summary figures](https://docs.neuralconfig.com/sugarpaws/app/charts/): The same entries plotted over 24 hours to 90 days. - [PDF report for your vet](https://docs.neuralconfig.com/sugarpaws/data/vet-report/): Turn a date range of this history into a document. - [Cat profiles](https://docs.neuralconfig.com/sugarpaws/app/cat-profiles/): Change the target range that decides the colours. --- # Charts and summary figures Source: https://docs.neuralconfig.com/sugarpaws/app/charts/ The **Charts** tab plots the active cat's readings and doses over a chosen time range: a **Glucose Levels** line chart with the target range as dashed lines, an **Insulin Doses** bar chart, the **Expected Insulin Activity** estimate (its own page: [the insulin activity curve](https://docs.neuralconfig.com/sugarpaws/app/insulin-activity-curve/)), and a **Summary** of four plain figures. Tap either chart to open it full screen and pan or zoom. The **Report** button in the top right opens the **Report Range** picker for the [PDF report](https://docs.neuralconfig.com/sugarpaws/data/vet-report/), starting from the range on screen; the report is built when you confirm there. Everything redraws as soon as you save an entry. There is no combined glucose-plus-insulin overlay: the two series are always separate charts, one above the other. ## Choosing the time range The segment control at the top offers **24h**, **7 days**, **30 days**, **90 days** and **Custom**. Each ends *now* and reaches back that far. The one selected when you open the tab is the **Default Time Range** from Settings › Chart Settings (**7 days** unless you changed it); picking a different one here lasts for the session. **Custom** opens a **Custom Date Range** sheet with a start and end date (dates only — the range covers whole days from the start of the first to the end of the last). **Apply** draws it; **Cancel** drops back to 7 days. While Custom is selected the chosen dates and a **Change** button sit under the segment control. If the range holds nothing at all the tab shows **No Data Available — Start tracking glucose and insulin to see charts**, and that replaces *everything* below it, including the insulin activity curve — so at **24h** with the last dose 30 hours ago there is no curve either, even though the curve looks back 24 hours on its own. Widen the range to see it. If the range holds one series but not the other, the empty chart says *No glucose data available* or *No insulin data available* in its place. ## The Glucose Levels chart A red line joining red points, one per reading, in your glucose unit. Two dashed horizontal lines mark the cat's target range: **green** at the target minimum and **orange** at the target maximum. Readings between them fell inside the range. The chart plots only what you entered — it does not estimate values between readings, and it draws no trend line. Tick spacing follows the range (every 4 hours at 24h, daily at 7 days, every 5 days at 30, fortnightly at 90). ## The Insulin Doses chart One blue bar per dose; bar height is the units. The vertical axis scales to your largest dose (never lower than 5 units), so ordinary 1–6-unit cat doses fill the chart. A gap means nothing was recorded then, which is not the same as a dose being missed. ## The four summary tiles Every figure is arithmetic over the entries inside the selected range and nothing more — no variability index, no trend, no score. Each tile has an ⓘ button explaining exactly this. | Tile | Value | Shows **—** when | |---|---|---| | **Average Glucose** | The plain mean of every reading in the range, in your unit. Readings at different times of day weigh the same. | No readings in the range | | **Readings in Range** | Readings inside the cat's target range ÷ all readings in the range, as a percentage. It **counts readings, not time** — a spot check says what the value was at that moment, nothing about the hours between. | No readings, or the profile has no usable target range | | **Total Readings** | How many glucose readings the range holds | — | | **Insulin Doses** | How many doses the range holds | — | *Readings in Range* was named on purpose: a "time in range" figure needs a continuous monitor. Two spot checks a day cannot support one, and the app does not pretend otherwise. On the largest accessibility text sizes the tiles stack one per row. ## The ⓘ explanations Both charts and every tile carry an ⓘ button. For a chart it opens a sheet with two parts — **What is this?** (what is plotted) and **Reading the chart** (what each colour is; e.g. *Red dots and line — readings you recorded · Green dashed line — target minimum · Orange dashed line — target maximum*). For a tile it opens the one-paragraph description in the table above, with the actual target range spelled out (*…inside Mochi's target range of 80–180 mg/dL*). ## Full-screen view Tap the glucose or insulin chart (or, with VoiceOver, activate it) to open it full screen — the same data as the tab's selected range, larger, with a **Close** button, a caption such as **Showing 7 days**, and a slider-icon menu. It works in landscape too. - **Drag** left and right to pan through time; a flick keeps moving and coasts to a stop (with Reduce Motion on, it stops where you let go). **Pinch** to zoom; the zoom is centred on the middle of the chart, not on your fingers, so pan to what you want to see first. - Full screen holds only the entries in the range selected on the tab — to see further back, pick a longer range (or Custom) on the tab first. The window can be as short as **6 hours**; panning is kept over those entries, and when the window is wider than they span, the first pan re-centres the view on the middle of your entries. - The menu offers **Reset View**, **Zoom In (Less Time)** (halves the window), **Zoom Out (More Time)** (doubles it), **6 Hours**, **1 Day**, **3 Days**, **1 Week** and **All Data** (the span of the entries in the tab's selected range, not your whole history). - **Go to Latest** appears whenever you have panned away from the newest entries; it snaps back. - Panning to a stretch with nothing in it shows **No Data in Time Range — Try zooming out or panning to see more data**. The view opens on the same span you had selected on the tab (24h → 1 day, 7 days → 1 week, 30 and 90 days likewise; a **Custom** range opens as 1 week), positioned at the newest data. That opening window is not trimmed to your data: a 90-day range holding ten days of entries opens 90 days wide. ## Next steps - [The insulin activity curve](https://docs.neuralconfig.com/sugarpaws/app/insulin-activity-curve/): The estimate drawn below the two charts, and what it is not. - [PDF report for your vet](https://docs.neuralconfig.com/sugarpaws/data/vet-report/): What the Report button in the corner produces. - [Cat profiles](https://docs.neuralconfig.com/sugarpaws/app/cat-profiles/): Set the target range the dashed lines and Readings in Range use. - [Settings reference](https://docs.neuralconfig.com/sugarpaws/app/settings/): Change the default time range or the glucose unit. --- # The insulin activity curve Source: https://docs.neuralconfig.com/sugarpaws/app/insulin-activity-curve/ Below the glucose and insulin charts, the Charts tab draws **Expected Insulin Activity (estimate)**: a blue curve of *relative* insulin activity over the last **12, 24 or 48 hours**, with a dashed green line at each injection and an orange dot at the estimated peak. It is a **textbook estimate** — the published typical onset, peak and duration for the insulin type each dose was recorded under, shaped into a curve and added up — not a measurement or prediction of your cat's response. The app says so under the ⓘ button, on the disclaimer you agreed to, and here: **do not use it for dosing decisions.** :::caution The curve does not read your cat. It knows only the doses you logged and a generic profile for each insulin type. Individual cats differ widely; the orange "peak" is when the *model* peaks. Your veterinarian's guidance about when to check and how to dose overrides anything drawn here. ::: ## How to read it | Element | Meaning | |---|---| | **Blue area and line** | Relative activity, sampled every 15 minutes, drawn with a smooth curve | | **Vertical axis: Low / Mid / Peak** | The curve is scaled so its highest point *in the visible window* is "Peak". The axis is deliberately not a percentage of anything measurable — labelling it 0–100 % invited reading it as a measurement of the cat | | **Green dashed lines with *2.0u* and a syringe** | Injections inside the window, labelled with their units | | **Orange dot, *Peak ~7:42 AM*** | Where the combined curve is highest | | **Current: Lantus (Glargine)** (under the title) | The insulin type currently selected in Settings | | **This window includes Vetsulin/Caninsulin and ProZinc (PZI) doses.** | Shown when the doses the chart considers — those in the window *plus* the 24-hour look-back before it — were recorded under more than one type, even if one of them has already run out before the window starts. The curve reflects each dose's own type, not the *Current* one | :::note The ⓘ sheet's colour key still describes the blue area as *scaled so the highest point in view is 100%*. The axis was relabelled Low / Mid / Peak on purpose and the sheet has not caught up; read "100%" there as "Peak" — it is the top of this window's curve, not a measurement. ::: Under the chart, two **From the typical curve** cards: - **Expected peak** — the clock time of the orange dot. It reads **N/A** only when there is no modelled activity anywhere in the window. A flat long-acting plateau still gets a time — the first point at the plateau's height — which means little, since that profile has no real peak. - **Doses still in window** — how many logged doses have not yet run past their type's duration as of *now* (a Lantus dose counts for 24 hours, an NPH dose for 7). The segment control offers **12h**, **24h** and **48h**, each ending now. Doses given *before* the window still contribute the tail of their curve inside it — the app looks back a full 24 hours (the longest duration of any type) before the window start. ## What the curve is built from Each dose contributes its type's shape, multiplied by its units; the contributions are summed and the total is divided by its own maximum, so the result is always 0–1 and only *relative* height means anything. | Insulin type (as listed in Settings) | Onset | Peak | Duration | Shape family | |---|---|---|---|---| | **Lantus (Glargine)** | 1.5 h | 5.0 h | 24 h | Long-acting: ramps up over an hour to a **flat plateau at a quarter of a peaked insulin's height** for the whole duration, tapering over the last two hours — no distinct peak, so the 5.0 h *Peak* figure is shown in Settings but not used to draw it. With only long-acting doses in view, the scaling lifts that plateau to the top of the axis | | **Levemir (Detemir)** | 1.5 h | 5.0 h | 24 h | Long-acting, same flat profile | | **ProZinc (PZI)** | 0.75 h | 6.0 h | 16 h | Intermediate: smooth (quadratic) rise to a clear peak, then exponential decline that stops abruptly at the duration, from about 22 % of the peak | | **Vetsulin/Caninsulin** | 0.5 h | 3.5 h | 10 h | Short-acting: quick (sine) rise to a sharp peak, then a faster decline that stops abruptly at the duration, from about 14 % of the peak | | **NPH** | 1.0 h | 4.0 h | 7 h | Short-acting, same shape | | **Custom** | 1.0 h | 4.0 h | 12 h | Intermediate shape with default numbers | These are the same three numbers shown under the type in Settings › Insulin Settings and in the **Insulin Profile** ⓘ sheet (which also carries the disclaimer *This chart is an informational estimate based on published typical insulin curves…*). **Which type a dose uses.** Every dose is stored with the type name it was logged under, and the curve models it with *that* type. If you change insulins in Settings, old doses keep their old shape and new doses get the new one — that is what the mixed-types caption is for. Names are matched loosely, ignoring case: a recorded name *containing* lantus or glargine, levemir or detemir, prozinc or pzi, vetsulin or caninsulin, or nph uses that type's profile — so a custom name such as *Compounded PZI* is drawn as ProZinc. A dose whose recorded name matches none of them (a custom insulin, or a hand-edited CSV row) uses the **Custom** profile; a dose with no recorded type at all (rows from very early versions) uses whatever is selected now. ## Empty and error states - **No Insulin Data — Add insulin doses to see activity curve**: no dose inside the window *and* no modelled activity from earlier doses reaching into it. A dose can sit in the 24-hour look-back and still produce this — an NPH dose 20 hours ago has run out (7-hour duration) before a 12h window begins. - **Couldn't Load Insulin Doses — Your data is still saved. Pull the Charts tab away and back, or reopen SugarPaws, to try again.**: the read failed; this is deliberately distinct from "you have none". ## Next steps - [Log an insulin dose](https://docs.neuralconfig.com/sugarpaws/app/logging-insulin/): Where the doses on this chart come from, and how each gets its type. - [Settings reference](https://docs.neuralconfig.com/sugarpaws/app/settings/): Choose the insulin type, or name a custom one. - [Charts and summary figures](https://docs.neuralconfig.com/sugarpaws/app/charts/): The rest of the Charts tab. --- # Cat profiles and multiple cats Source: https://docs.neuralconfig.com/sugarpaws/app/cat-profiles/ Every reading and dose in SugarPaws belongs to one **cat profile**: a name, an optional photo, and a **target glucose range** (defaults **80–180 mg/dL**, i.e. 4.4–10.0 mmol/L). Edit the active cat's profile from Settings › **Cat Profile** (the row with the photo, *Tap to edit profile*). Add, switch and delete cats from **Manage Cats** — reached from that same Settings section or from the cat switcher bar. There is always at least one cat; you cannot delete the last one. ## Editing a profile **Cat Profile** is a sheet with **Cancel** and **Save**: | Field | Rules | |---|---| | **Cat Name** | Required — Save is disabled while it is empty. Appears in the header strip, the switcher, the CSV `Cat` column and on the PDF report. | | **Cat Photo** — *Add Photo* / *Change Photo* | Optional. Picking one opens **Position Photo** (*Drag to reposition, pinch or use the slider to zoom*); the circle you frame is saved as a small square image inside the app's own database, not as a link to your photo library. Every avatar in the app is that circle. | | **Target Glucose Range (mg/dL or mmol/L)** — *Min* – *Max* | Shown and typed in your current unit, stored in mg/dL. Must satisfy the rules below. | **Save** is enabled only while the input is valid (it may already be enabled when the sheet opens, before you change anything — saving unchanged values is harmless). The range rules, with the message shown under the fields: | Rule | Message (mg/dL / mmol/L) | |---|---| | Both fields hold a number | *Enter a number for both the minimum and the maximum.* | | Minimum ≥ **20 mg/dL** | *The minimum must be at least 20 mg/dL.* / *…1.1 mmol/L.* | | Maximum ≤ **999 mg/dL** | *The maximum can't be above 999 mg/dL.* / *…55.5 mmol/L.* | | Maximum > minimum | *The maximum must be higher than the minimum.* | Those bounds are simply the values the app can record a reading in — a target you could never log against is not useful. They make **no clinical claim**; the range itself is whatever your vet gave you. :::note A profile saved by an early version with a range outside these bounds is repaired when you open the sheet (pulled inside 20–999 mg/dL, or reset to 80–180 if that leaves nothing sensible) and **Save** is enabled so you can commit the repair. Nothing is changed until you tap Save. ::: The footer under the range explains what it is for: *The target glucose range helps visualize when readings are within the desired range in charts.* It drives the dashed lines on the [charts](https://docs.neuralconfig.com/sugarpaws/app/charts/), the colours and arrows in [History](https://docs.neuralconfig.com/sugarpaws/app/history/), the **Readings in Range** tile, and the *vs target* column and colour key on the [PDF report](https://docs.neuralconfig.com/sugarpaws/data/vet-report/). ## Adding a cat Manage Cats › **Add New Cat** opens a form: **Cat's Name** (required), *Add Photo*, and a **Target Glucose Range** with **Minimum** and **Maximum** fields already filled in with the defaults in your unit (80 and 180 mg/dL, or 4.4 and 10.0 mmol/L). Edit them to your vet's range, or leave them. A field you clear is not filled back in: it shows *Enter a number for both the minimum and the maximum.* and Save stays disabled until you type a number. **Save** creates the profile and makes it the active cat. If a save fails the sheet stays open with an alert (*Couldn't Create Profile*), so nothing half-made is left behind. ## Switching cats As soon as you have **two or more** profiles, a **cat switcher bar** appears at the top of every tab, just under the screen title (*Quick Entry*, *History*, *Charts*, *Settings*): the active cat's photo (or a blue cat icon), its name and a chevron. Tap it for a menu listing every cat with a tick on the active one, and a **Manage Cats** entry. Picking a cat makes it active everywhere at once — Add, History, Charts and Settings all follow — and the choice is remembered across launches. With one profile the bar is absent. **Manage Cats** (title *Manage Cats*, **Done** to close) lists each cat with its photo, name and *Target: 80-180 mg/dL*, with a blue tick on the active one; tapping another cat switches to it and closes the sheet. ## What is per-cat and what is shared | Per cat | Shared by all cats | |---|---| | Name, photo, target range | Glucose unit | | Every glucose reading and insulin dose | Insulin type (and custom name) — the type stamped on a dose is whatever is selected when you log it, for any cat | | The last-reading / last-dose strip, History, Charts, the PDF report | Reminders and their times — there is one schedule, not one per cat | | The CSV export when *This cat* is selected | Appearance, default chart range, disclaimer setting | If two cats are on different insulins, change Settings › **Insulin Type** before logging each one; the recorded type is what the [activity curve](https://docs.neuralconfig.com/sugarpaws/app/insulin-activity-curve/) uses. ## Deleting a cat In Manage Cats, swipe a cat's row left and tap **Delete** — the action is offered only while you have more than one profile (with one, the footer reads *You need at least one cat profile*). An alert confirms: **Delete Cat? This will permanently delete *Name* and all associated glucose and insulin data.** Deleting is immediate and **has no Undo**: the profile and every reading and dose attached to it are removed. If you delete the active cat, the app switches to another. Export a CSV first if you might want the data back. ## Next steps - [Get started](https://docs.neuralconfig.com/sugarpaws/app/getting-started/): The first-run setup that creates the first profile. - [CSV export (backup)](https://docs.neuralconfig.com/sugarpaws/data/csv-export/): Back up one cat or every cat before deleting anything. - [Settings reference](https://docs.neuralconfig.com/sugarpaws/app/settings/): The shared settings — unit, insulin type, reminders. --- # Reminders Source: https://docs.neuralconfig.com/sugarpaws/app/reminders/ Reminders are **off until you turn them on**. Settings › Reminders › **Enable Reminders** asks iOS for notification permission and, if you allow it, schedules **four repeating daily notifications**: a glucose check and an insulin dose in the morning, and the same pair in the evening. The default times are **8:00** and **8:05**, **20:00** and **20:05**; **Configure Times** changes each one. Logging an insulin dose quietly cancels an insulin reminder that was about to fire, so you are not nagged for the dose you just gave. ## Turning reminders on 1. Open **Settings › Reminders** and switch on **Enable Reminders**. 2. iOS asks whether SugarPaws may send notifications (alerts, sounds and badges). **Allow** — the four reminders are scheduled at once. **Don't Allow** — the toggle snaps back off and a hint appears under it: **Notifications are turned off for SugarPaws, so reminders can't be delivered.** with an **Open Settings** button that takes you to the app's page in the iOS Settings app, where notifications can be re-enabled. 3. Tap **Configure Times** (it appears once the toggle is on) to adjust the schedule, then **Save**. Switching the toggle off cancels every scheduled reminder. If you later revoke notifications in iOS Settings, the toggle turns itself off the next time you open Settings and the same hint appears. ## The four reminders | Reminder | Default time | Notification title | Body | |---|---|---|---| | Morning glucose check | 8:00 | **Glucose Check Reminder** | *Time to check your cat's blood glucose level* | | Morning insulin dose | 8:05 | **Insulin Reminder** | *Time for your cat's insulin dose* | | Evening glucose check | 20:00 | **Glucose Check Reminder** | *Time to check your cat's blood glucose level* | | Evening insulin dose | 20:05 | **Insulin Reminder** | *Time for your cat's insulin dose* | Each repeats every day at that hour and minute with the default sound. There is one schedule for the whole app — reminders are **not per cat**. Tapping a notification opens SugarPaws; it does not pre-select anything. **Reminder Times** (the Configure Times sheet) has a **Morning Reminder** section with *Glucose Check* and *Insulin Dose* time pickers and an **Evening Reminder** section with the same two. **Save** stores the four times and reschedules everything; **Cancel** discards your edits. (Save can already be tappable when the sheet opens, before you have changed anything — tapping it then simply re-saves the same times.) Only the hour and minute matter. ## How a logged dose silences the insulin reminder Two mechanisms, covering the two ways a notification can arrive: - **App in the foreground.** When an insulin reminder fires while SugarPaws is open, the app checks whether the *active cat* has a dose logged within the **last hour**. If so, the notification is not shown at all. Glucose reminders are always shown. - **App in the background.** The moment you save an insulin dose, any insulin reminder due within the **next 60 minutes** is replaced by a one-off at the same time *tomorrow*, so tonight's does not fire. The regular daily schedule is put back the next time the app launches (it re-registers all four reminders on every launch while the toggle is on and permission is granted), which also clears those one-offs. Nothing suppresses a glucose reminder — logging a reading does not cancel the next check. ## Next steps - [Log an insulin dose](https://docs.neuralconfig.com/sugarpaws/app/logging-insulin/): The save that silences the next insulin reminder. - [Troubleshooting](https://docs.neuralconfig.com/sugarpaws/troubleshooting/): Reminders that never arrive. - [Settings reference](https://docs.neuralconfig.com/sugarpaws/app/settings/): Every other setting. --- # Settings reference Source: https://docs.neuralconfig.com/sugarpaws/app/settings/ The **Settings** tab is one scrolling form with nine sections. Most rows apply immediately; the sheets (Cat Profile, Reminder Times, Advanced Settings, Import/Export) have their own Save or Done. Settings other than the cat profile are **shared by every cat** — see [Cat profiles](https://docs.neuralconfig.com/sugarpaws/app/cat-profiles/) for what is per-cat. ## The sections | Section | Rows | Options and default | |---|---|---| | **Cat Profile** | The active cat (photo, name, *Tap to edit profile*) → **Cat Profile** sheet; **Manage Cats** | See [Cat profiles](https://docs.neuralconfig.com/sugarpaws/app/cat-profiles/) | | **Units** | **Glucose Unit** | **mg/dL** or **mmol/L**. First-launch default is guessed from your device's region (mg/dL for the US and a handful of others, mmol/L elsewhere) and confirmed in setup. Changing it re-labels every stored reading (1 mmol/L = 18 mg/dL); nothing is altered. | | **Insulin Settings** | **Insulin Type**; **Custom Insulin Name** (only when *Custom* is chosen); Onset / Peak / Duration read-out | Six choices: **Lantus (Glargine)** *(default)*, **Levemir (Detemir)**, **ProZinc (PZI)**, **Vetsulin/Caninsulin**, **NPH**, **Custom**. The three numbers under it are the selected type's typical profile — see [the insulin activity curve](https://docs.neuralconfig.com/sugarpaws/app/insulin-activity-curve/). The name here is stamped on every dose you log from now on. | | **Reminders** | **Enable Reminders**; **Configure Times** (when on); a *Notifications are turned off…* hint with **Open Settings** when iOS permission is denied | Off by default. See [Reminders](https://docs.neuralconfig.com/sugarpaws/app/reminders/). | | **Appearance** | **Theme** | **System** *(default)*, **Light**, **Dark** | | **Chart Settings** | **Default Time Range** | **24 hours**, **7 days** *(default)*, **30 days**, **90 days** — the range the Charts tab opens on; changing it applies at once | | **Data** | **Export & Backup** — *Share a PDF report with your vet, export a CSV backup, or import a previous export.* | Opens the **Import/Export** screen: [PDF report](https://docs.neuralconfig.com/sugarpaws/data/vet-report/), [CSV export](https://docs.neuralconfig.com/sugarpaws/data/csv-export/), [CSV import](https://docs.neuralconfig.com/sugarpaws/data/csv-import/) | | **Advanced** | **Advanced Settings** | See below | | **About** | **Version** (*1.0 (3)*), **User Guide**, **Support**, **Privacy Policy**, **Terms of Service** | The four links open in the browser — see [the About links](#the-about-links) | ## Advanced Settings A sheet with two sections and a **Done** button. **Disclaimer Settings › Always Show Disclaimer** (off by default). *When enabled, the disclaimer will be shown every time the app starts, even if previously accepted.* Turning it on shows the disclaimer immediately, too. It never brings the first-run setup back. **Data Management › Danger Zone › Delete All Data.** The footer warns: *This action cannot be undone* and lists what goes — all glucose readings, all insulin dose records, cat profile information, app settings and preferences. Tapping the red button opens a **Confirm Deletion** sheet (*This action cannot be undone. All glucose readings, insulin doses, and profile data for ALL cats will be permanently deleted.*) where you must type **DELETE** in capitals before **Delete All** becomes tappable; **Cancel** backs out. Then, in one step: | Removed | Reset to default | Kept | |---|---|---| | Every glucose reading and insulin dose, for every cat | Glucose unit → **mg/dL** (not re-guessed from your region — pick mmol/L again in Units if that is what you use) | Your agreement to the disclaimer — it is not shown again | | Every cat profile, including photos; a fresh profile named **Unnamed cat** with an 80–180 mg/dL range is created | Enable Reminders → off; reminder times → 8:00 / 8:05 / 20:00 / 20:05 | The first-run setup does not reappear | | | Insulin type → Lantus (Glargine); custom name cleared | | | | Default Time Range → 7 days; Theme → System; Always Show Disclaimer → off | | There is **no undo and no recovery**. If you might want the data, export a CSV with **All *N* cats** selected first (with a single cat, the export already covers everything) — see [CSV export](https://docs.neuralconfig.com/sugarpaws/data/csv-export/). Deleting a single cat instead is done from Manage Cats. ## The About links The last section of Settings opens four web pages in your browser. Nothing about your cat is sent with them. | Row | Opens | |---|---| | **User Guide** | These docs — `https://docs.neuralconfig.com/sugarpaws/` | | **Support** | The NeuralConfig support site with SugarPaws pre-selected — `https://support.neuralconfig.com/?product=sugarpaws` | | **Privacy Policy** | The SugarPaws privacy addendum — `https://neuralconfig.com/privacy/sugarpaws/` | | **Terms of Service** | `https://neuralconfig.com/terms` | ## Next steps - [Reminders](https://docs.neuralconfig.com/sugarpaws/app/reminders/): What Enable Reminders and Configure Times schedule. - [Cat profiles](https://docs.neuralconfig.com/sugarpaws/app/cat-profiles/): The one part of Settings that is per cat. - [Privacy and where your data lives](https://docs.neuralconfig.com/sugarpaws/data/privacy/): What Delete All Data actually erases, and where the data was. --- # PDF report for your vet Source: https://docs.neuralconfig.com/sugarpaws/data/vet-report/ The report is a PDF titled **SugarPaws Glucose & Insulin Log** covering one cat over a date range you choose: a first page with the glucose and insulin charts, then a summary of the counts, average and readings-in-range, a colour key, and full tables of every reading and dose in the range. It contains **no clinical interpretation** — the summary is a fixed list of up to six factual lines (four when the range has no readings) and nothing else can appear there — and it says so on the page. Build it from the **Report** button on the Charts tab or from **PDF Report for Your Vet** on the Import/Export screen; it comes out through the iOS share sheet (Mail, Messages, AirDrop, Files, print…). ## Building it 1. Open the range picker: **Charts › Report** (top right) or **Settings › Export & Backup › PDF Report for Your Vet** (also reachable from the History share icon; opens on **Last 30 Days**; reopened without leaving the Import/Export screen, it starts from the range you last used, snapped to a preset the same way — after a *Last 3 Months* report it can show **Last Year**). From Charts the picker starts from the chart's range but **snaps it to the nearest preset** — check the dates before you tap Export: | Chart range | Report Range opens on | |---|---| | 24h or 7 days | **Last 7 Days** | | 30 days | **Last 30 Days** | | 90 days | **Last 3 Months** (calendar months, so 89–92 days) | | Custom, up to 7 days | **Last 7 Days** — *your custom dates are replaced* | | Custom, 8–30 days | Your custom dates, but labelled **Last 30 Days** with the date pickers greyed out — pick **Custom Range** to edit them | | Custom, 31–90 days | **Last 3 Months** — *replaced* | | Custom, 91–365 days | **Last Year** — *replaced* | | Custom, over a year | **Custom Range** with your dates | To report on an exact custom span, choose **Custom Range** on this sheet and set the dates there. 2. On the **Report Range** sheet choose a **Preset** — **Last 7 Days**, **Last 30 Days**, **Last 3 Months**, **Last Year** or **Custom Range** — or pick **Custom Range** and set **Start Date** and **End Date** (the two pickers are greyed out for the presets). The **Export Range** box repeats the dates and *Duration: N days*. 3. Tap **Export**. A spinner replaces the button while the report is built (a multi-thousand-row report is not instant); the sheet then closes and the share sheet opens with the PDF. Ranges are whole days: from midnight at the start of the first day to the end of the last, so a reading at 23:50 on the end date is included. The report is always for the **active cat**; with several cats, switch first (Import/Export says so under the button when *All cats* is selected for CSV). ## What is in it **File name:** `SugarPaws_Report_2026-08-16_09-15-02.pdf` (the moment it was built), US Letter pages. **Share-sheet subject:** *SugarPaws log for Mochi, Jul 17 – Aug 16, 2026*. **Page 1 — charts.** A rendered page with the title, the cat's name, the date range and *Glucose in mg/dL* (or mmol/L), and *Generated* date. Then **Glucose readings** — red points on a line, with a green target-minimum line and an orange target-maximum line, and a legend that spells out the values (*target minimum (80 mg/dL)*) — and **Insulin doses**, blue bars with the legend *recorded doses*. An empty series says *No glucose readings recorded in this period.* / *No insulin doses recorded in this period.* The footer: *Recorded in SugarPaws by the cat's owner. This page shows recorded observations only and contains no clinical interpretation.* **Page 2 onwards — text.** *Cat:* name, *Report generated:* timestamp, *Data range:*, then **Summary**, which is exactly these lines and no others: | Summary line | Example | |---|---| | Date range, with the day count | *Date range: Jul 17, 2026 – Aug 16, 2026 (31 days)* | | Glucose readings | *Glucose readings: 62* | | Insulin doses | *Insulin doses: 60* | | Average glucose (only if there are readings) | *Average glucose: 214 mg/dL* | | Readings within the configured target range (only if there are readings) | *Readings within the configured target range: 18 of 62 (29%)* | | The target range | *Target glucose range (as configured in the app): 80 – 180 mg/dL* | Below it, a **colour key** in small print: *readings are coloured by position relative to the configured target range: below target (blue), within target (green), above target (orange). The "vs target" column states the same thing in text. This report lists observations recorded by the cat's owner. It contains no clinical interpretation.* Then **Glucose Readings (N total)**, newest first — date and time, the value in your unit (coloured), a *vs target* word (*below target* / *in target* / *above target*), and the note cut to one line with an ellipsis — and **Insulin Doses (N total)** — date and time, units, the insulin type, the note. Long tables run over as many pages as needed with the section title repeated. Nothing on any page grades, scores or advises. Variability indices, "time in range", trend lines and dosing suggestions were removed from the app so they could not reach a document a veterinarian reads. ## Errors | Alert | Meaning | |---|---| | **Report Failed** — *SugarPaws couldn't find this cat's profile.* | The active cat could not be loaded; switch cats or relaunch | | **Report Failed** — *SugarPaws couldn't draw the charts for the report.* | Page 1 could not be rendered; try again | | **Report Failed** — *SugarPaws couldn't write the report file. Check that your device has free storage.* | The PDF could not be written to temporary storage | | **Couldn't Open Share Sheet** — *SugarPaws built the report but couldn't open the share sheet. Please try again.* (from Charts) or *SugarPaws built the file but couldn't open the share sheet. Please try again.* (from Import/Export) | The system share sheet failed to present; tap Export again | ## Next steps - [CSV export (backup)](https://docs.neuralconfig.com/sugarpaws/data/csv-export/): The other file on the Import/Export screen — a spreadsheet and a backup. - [Charts and summary figures](https://docs.neuralconfig.com/sugarpaws/app/charts/): The same charts and figures on screen. - [Cat profiles](https://docs.neuralconfig.com/sugarpaws/app/cat-profiles/): The target range printed on the report. --- # CSV export (backup) Source: https://docs.neuralconfig.com/sugarpaws/data/csv-export/ **Export to CSV (backup)** on the Import/Export screen (Settings › **Export & Backup**, or the share icon on History) writes every glucose reading and insulin dose — for the active cat, or for **all cats** if you choose that — to one CSV file and hands it to the iOS share sheet. It is the app's **only backup**: SugarPaws has no cloud sync, so a CSV kept somewhere safe is what you would [import](https://docs.neuralconfig.com/sugarpaws/data/csv-import/) after a lost phone or a *Delete All Data*. It also opens cleanly in Excel, Numbers or Sheets for a vet who wants the raw numbers. ## Making one The screen shows **Current Data for *Name*** with the counts of glucose readings and insulin doses. With more than one profile a **CSV backup covers** switch offers **This cat** / **All N cats**. Tap **Export to CSV (backup)** — the button reads *Exporting...* while the file is written on a background thread — and the share sheet opens with the file. The share subject is *SugarPaws data backup for Mochi* (or *for all cats*). If the write fails: **Export Failed** — *SugarPaws couldn't write the export file. Make sure your device has free storage and try again.* If the data cannot be read: *SugarPaws couldn't read your data to export it: …*. If the share sheet cannot present: **Couldn't Open Share Sheet**. ## The file **Name:** `SugarPaws_Export_2026-08-16_09-15-02.csv` (time of export). UTF-8, RFC 4180 (fields containing commas, quotes or line breaks are quoted; quotes are doubled). It starts with comment lines, each beginning `#`, which the importer skips: ```text # SugarPaws Data Export # Export Date: 2026-08-16T13:15:02Z # Total Glucose Readings: 62 # Total Insulin Doses: 60 # Canonical glucose unit (Value column): mg/dL # Owner's display unit (DisplayValue column): mmol/L # App version: 1.0 (3) # Format: Type,Date,Time,Value,Unit,InsulinType,Notes,Cat,DisplayValue,DisplayUnit # Type,Date,Time,Value,Unit,InsulinType,Notes,Cat,DisplayValue,DisplayUnit Glucose,2026-08-16,07:30,268.0,mg/dL,,Pre-shot,Mochi,14.9,mmol/L Insulin,2026-08-16,07:40,2.00,units,Lantus (Glargine),Morning dose,Mochi,2.00,units ``` All glucose rows come first, oldest to newest, then all insulin rows, oldest to newest. | Column | Glucose row | Insulin row | |---|---|---| | `Type` | `Glucose` | `Insulin` | | `Date` | `yyyy-MM-dd`, in the device's local time zone | same | | `Time` | `HH:mm`, 24-hour, local — seconds are not written | same | | `Value` | **Always mg/dL**, one decimal (`268.0`) — whatever unit you use in the app | Units, two decimals (`2.00`, `0.25`) | | `Unit` | `mg/dL` | `units` | | `InsulinType` | empty | The type recorded on the dose, e.g. `Lantus (Glargine)` or your custom name | | `Notes` | The note, or empty | The note, or empty | | `Cat` | The cat's name | same | | `DisplayValue` | The same reading in **your display unit**: identical to `Value` for mg/dL users, one decimal in mmol/L (`14.9`) | Same as `Value` | | `DisplayUnit` | `mg/dL` or `mmol/L` | `units` | **Why `Value` is not converted.** The file is both the vet artefact and the backup. mmol/L displays to one decimal, so 100 mg/dL would export as 5.6 and re-import as 100.8 — and because import recognises a duplicate by its value, re-importing your own backup would then *double* an mmol/L user's whole history instead of being recognised as already present. So `Value` stays canonical and `DisplayValue` carries the number you actually see; a vet reads whichever pair suits them. **Time zone.** No offset is stored. Move the file to a device in another zone and each entry keeps its wall-clock time — intended for a personal single- device log. **Precision.** Glucose to one decimal, insulin to two: an imported 0.25-unit dose must not become 0.3, a 20 % error, in a file a vet reads. **Spreadsheet safety.** A note beginning with `=`, `+`, `-`, `@`, a tab or a carriage return is written with a leading apostrophe (`'=…`), the standard "literal text" marker, so a hostile or accidental note cannot run as a formula when the file is opened in Excel or Sheets. Import strips it again, so your own round trip is lossless. ## Next steps - [CSV import](https://docs.neuralconfig.com/sugarpaws/data/csv-import/): Bring the file back — into the same app or a new phone — without duplicating anything. - [PDF report for your vet](https://docs.neuralconfig.com/sugarpaws/data/vet-report/): The readable version, for a vet who does not want a spreadsheet. - [Privacy and where your data lives](https://docs.neuralconfig.com/sugarpaws/data/privacy/): Why the CSV is the only backup. --- # CSV import Source: https://docs.neuralconfig.com/sugarpaws/data/csv-import/ **Import from CSV** on the Import/Export screen reads a SugarPaws export — or any CSV with at least `Type`, `Date`, `Time` and `Value` columns — and adds its glucose and insulin rows to the app. It is built for the round trip: importing your own backup **skips rows already present** rather than doubling them, creates cat profiles named in the file that do not exist yet, and asks before merging into an existing cat other than the active one. The whole import is **all-or-nothing**: rows are parsed and written in one transaction, so a failure imports nothing. ## Importing Tap **Import from CSV**, then **Select CSV File** (`.csv` or plain text) in the file picker. The screen lists the columns above the button. While the file is read a **Importing...** overlay shows. The result appears in place: - **Import Successful** with a green tick, and lines such as *✓ 62 glucose readings*, *✓ 60 insulin doses*, *↩︎ 12 duplicates skipped*, and *Everything in this file was already imported.* when only duplicates were found. - **Imported with Warnings** with an orange triangle if any row was dropped, plus the reason — e.g. *3 rows couldn't be read and were not imported (2 unreadable dates, 1 out-of-range value). First: data row 14.* — and *Check those rows in the file and import again if they matter.* Row numbers count data rows (comment lines and quoted line breaks are not counted). - *⚠️ Data merged for: Whiskers* when rows went into an existing cat other than the active one. Charts, History and the entry prefills refresh straight away. ## Columns | Column | Required? | How it is read | |---|---|---| | `Type` | **Yes** | `Glucose` or `Insulin` (any case). Anything else: row skipped as *unrecognised row type* | | `Date` | **Yes** | `yyyy-MM-dd` | | `Time` | **Yes** | `HH:mm` (24-hour). Date and time are read as **local wall-clock time** | | `Value` | **Yes** | A number; a comma decimal separator (`6,5`) is accepted. A value with both `,` and `.` is ambiguous and skipped | | `Unit` | No | For glucose rows only — see *Units* below. Ignored on insulin rows | | `InsulinType` | No | Stored on the dose as its type. If the `InsulinType` cell is **empty** — or the column is absent, as in the very early export format — and `Notes` is not, the first word of the note is taken as the type and the rest as the note. So an insulin row with an empty type and the note *after breakfast* imports as type *after*, note *breakfast*: fill in `InsulinType` on hand-made rows | | `Notes` | No | Free text | | `Cat` | No | Which cat the row belongs to — see *Cats* below. Empty or absent means the **active cat** | | `DisplayValue`, `DisplayUnit` | No | **Ignored** — they are for people, not for import | Extra columns are ignored; column order does not matter, only the header names. Header spellings are exact and case-sensitive (`Type`, not `type`). Lines beginning `#` are skipped, an Excel UTF-8 byte-order mark is tolerated, and UTF-8 and UTF-16 files are read. **Save as CSV UTF-8.** A file in a Windows ("ANSI" / Windows-1252) encoding that contains an accented or special character is **usually** misread as UTF-16: every line and comma is lost, so the import stops with *The CSV file is empty or cannot be read* even though the file is full. Whether a given file is misread depends on where its special characters fall, so one Windows-1252 file may import correctly and the next fail. Plain-ASCII files read fine whatever they are labelled. ### Units and ranges | Glucose `Unit` cell | Treated as | |---|---| | `mmol/L`, `mmol`, `mmoll` (case- and space-insensitive) | mmol/L — multiplied by 18 and stored as mg/dL | | `mg/dL`, `mgdl`, `mg` | mg/dL | | Anything else, or no `Unit` column | Read as mg/dL — but only if the value is **≥ 19**; smaller values are skipped as *row with an unrecognised glucose unit*, because 5.5 mmol/L read as 5.5 mg/dL is silent corruption, not a rounding error | Glucose values must be **> 0 and ≤ 2000 mg/dL** after conversion, insulin doses **> 0 and ≤ 200 units**; anything else is skipped as an *out-of-range value*. Doses need not sit on the app's 0.5-unit grid. ### Cats For each row with a non-empty `Cat`, the name is matched to an existing profile **case-insensitively**. A match is used; no match creates a new profile with that name and the default 80–180 mg/dL range. Rows without a `Cat` go to the active cat. Before anything is written, a dry run checks whether the file names an *existing* cat other than the active one. If it does, an alert **Cat Profile Conflicts** — *The following cats in the import file match existing profiles: Whiskers. Their data will be merged with existing profiles. Cancel Import to abort without changing anything.* — offers **Merge Data** or **Cancel Import**. Cancelling genuinely cancels; nothing has been saved yet. ### Duplicates A row is a duplicate — counted, not imported — when the app already holds an entry for the **same cat**, in the **same minute**, with the **same value** (to three decimals) and, for insulin, the **same type**. Timestamps are compared to the minute because exports carry no seconds. Duplicate rows *within* the file collapse the same way. This is what lets you re-import a backup, or import an export you already imported last month, without doubling anything. ## Skip reasons and errors Rows dropped from an otherwise successful import are reported by reason: *incomplete row(s)*, *unreadable value(s)*, *unreadable date(s)*, *out-of-range value(s)*, *unrecognised row type(s)*, *row(s) with an unrecognised glucose unit*. Whole-file errors appear as an **Import Error** alert: | Message | Cause | |---|---| | *The CSV file is empty or cannot be read* | No rows beyond a header — or, for a file that plainly has rows, a Windows-1252 ("ANSI") file misread as UTF-16 (see above); re-save as CSV UTF-8 | | *The CSV file format is invalid. Expected headers: Type, Date, Time, Value* | One of the four required headers is missing | | *None of the rows in this file could be imported. N rows couldn't be read… (reasons)* | Every data row was skipped; the reasons name what to fix | | *Unable to read the CSV file. Please ensure it's saved as UTF-8 text* | The bytes are in none of the supported encodings (rare — a Windows-1252 file usually gets the *empty or cannot be read* message instead) | ## Next steps - [CSV export (backup)](https://docs.neuralconfig.com/sugarpaws/data/csv-export/): The file this importer is designed around, column by column. - [Cat profiles](https://docs.neuralconfig.com/sugarpaws/app/cat-profiles/): Where profiles created by an import turn up, and how to fix their target range. - [Troubleshooting](https://docs.neuralconfig.com/sugarpaws/troubleshooting/): Imports that skip rows or refuse a file. --- # Privacy and where your data lives Source: https://docs.neuralconfig.com/sugarpaws/data/privacy/ Everything SugarPaws knows — cat profiles and photos, every reading and dose, your settings — is stored in a database **inside the app on your device**. The app has no account, no sign-in, no server of its own, no cloud sync between devices, and no analytics or crash-reporting library; it makes no network requests of its own. Data leaves the phone only when *you* share a [PDF report](https://docs.neuralconfig.com/sugarpaws/data/vet-report/) or [CSV export](https://docs.neuralconfig.com/sugarpaws/data/csv-export/) through the iOS share sheet, and then only to wherever you send it. ## What is stored, and where | Data | Where | |---|---| | Cat profiles (name, target range, created date), glucose readings, insulin doses | A Core Data (SQLite) database in the app's private container | | Cat photos | In that same database, as the small square JPEG the **Position Photo** cropper produced — not a reference to your photo library, so deleting the original photo changes nothing in the app | | Settings (unit, insulin type, reminder times, appearance, disclaimer agreement, active cat) | The app's preferences store on the device | | Exported PDF and CSV files | Written to the app's temporary folder for the share sheet; a new CSV export clears the previous CSV, and a new PDF report clears the previous PDF | Because it lives in the app's container, the data is included in your device's ordinary iOS backup like any app's data — but the app itself has **no restore feature**. The [CSV export](https://docs.neuralconfig.com/sugarpaws/data/csv-export/) is the backup you control, and [CSV import](https://docs.neuralconfig.com/sugarpaws/data/csv-import/) is how it comes back. There is one copy of the data, on one device. Two devices do not share it — including an iPhone and an iPad — even when they are signed in to the same Apple ID. ## Permissions | Permission | When it is asked | What for | |---|---|---| | **Notifications** (alerts, sounds, badges) | Only when you switch on Settings › Reminders › **Enable Reminders** | The four daily reminders — see [Reminders](https://docs.neuralconfig.com/sugarpaws/app/reminders/). Decline and the toggle stays off | | Photos | Never as a blanket permission — the app uses the system photo picker, which hands over only the single image you choose | The cat's profile photo | The app does not ask for location, camera, contacts, health data, Bluetooth or anything else, and it does not read a glucose meter. ## What leaves the phone - **Sharing a PDF or CSV** sends that file — cat name, every reading and dose in the range, notes, target range — to the destination you pick in the share sheet (Mail, Messages, AirDrop, Files, a print queue). SugarPaws does not keep a copy anywhere else and does not know where it went. - The **User Guide**, **Support**, **Privacy Policy** and **Terms of Service** rows in Settings › About open web pages in your browser — these docs, support.neuralconfig.com, and the privacy and terms pages on neuralconfig.com ([the About links](https://docs.neuralconfig.com/sugarpaws/app/settings/#the-about-links)). Opening one sends nothing about your cat. Nothing else. Reminders are scheduled locally by iOS; no notification server is involved. ## Deleting data | To delete | Do this | Recoverable? | |---|---|---| | One reading or dose | Swipe it left in [History](https://docs.neuralconfig.com/sugarpaws/app/history/) | **Undo** for 5 seconds, then no | | One cat and everything logged for it | Manage Cats › swipe › **Delete** ([Cat profiles](https://docs.neuralconfig.com/sugarpaws/app/cat-profiles/)) | No | | Everything, for every cat | Settings › Advanced › **Advanced Settings** › **Delete All Data**, type `DELETE`, tap **Delete All** ([Settings](https://docs.neuralconfig.com/sugarpaws/app/settings/)). This also resets every setting to its default (reminders off, unit mg/dL) and leaves one empty profile named *Unnamed cat* | No | | The app and all its data | Delete the app from the home screen | No (unless you kept a CSV) | ## Next steps - [CSV export (backup)](https://docs.neuralconfig.com/sugarpaws/data/csv-export/): The one backup you control. - [Reminders](https://docs.neuralconfig.com/sugarpaws/app/reminders/): The only permission the app asks for. - [Troubleshooting](https://docs.neuralconfig.com/sugarpaws/troubleshooting/): 'Your data couldn't be loaded' and what it means for the database. --- # Limits and ranges Source: https://docs.neuralconfig.com/sugarpaws/data/limits/ This page collects the numbers. Each is stated once here and explained on the page it belongs to. ## Entry | Limit | Value | |---|---| | Recordable glucose reading | **20–999 mg/dL**, whole numbers; **1.1–55.5 mmol/L**, one decimal. Outside → rejected with a message, never clamped | | "Outside the range a cat's meter usually reads" warning | Below **40 mg/dL** (2.2 mmol/L) or above **500 mg/dL** (27.8 mmol/L) — still saveable | | Same-reading duplicate warning | Identical value within **10 minutes** of the last reading | | Insulin dose wheel | **0.5–99.0 units** in **0.5-unit** steps; prefill = last dose rounded **down** to the grid, else 1.0 | | Second-dose warning | Any dose within **60 minutes** of the last | | High-dose warning | More than **15 units** | | Note length | **500 characters** (glucose and insulin) | | Entry time | Any time up to now; no future times | | Undo after a delete | **5 seconds**, most recent delete only | | Save confirmation toast | **2 seconds** | ## Profiles | Limit | Value | |---|---| | Target range | Minimum ≥ **20 mg/dL**, maximum ≤ **999 mg/dL** (55.5 mmol/L), maximum > minimum. In mmol/L the lowest minimum that saves is **1.2** — 1.1 is 19.8 mg/dL, under the floor, and is refused with *The minimum must be at least 1.1 mmol/L.* | | Default target range | **80–180 mg/dL** (4.4–10.0 mmol/L) | | Number of cats | No upper limit; **at least one** — the last profile cannot be deleted; the switcher bar appears from **two** | | Photo | Cropped to a **300 pt square** JPEG | | Unit conversion | 1 mmol/L = **18** mg/dL | ## Insulin types | Type | Onset | Peak | Duration | |---|---|---|---| | Lantus (Glargine), Levemir (Detemir) | 1.5 h | 5.0 h | 24 h | | ProZinc (PZI) | 0.75 h | 6.0 h | 16 h | | Vetsulin/Caninsulin | 0.5 h | 3.5 h | 10 h | | NPH | 1.0 h | 4.0 h | 7 h | | Custom | 1.0 h | 4.0 h | 12 h | Activity curve windows: **12 h / 24 h / 48 h**, sampled every **15 minutes**; doses up to **24 h** before the window still contribute. ## Charts and reports | Limit | Value | |---|---| | Chart ranges | 24 h, 7, 30, 90 days, or a custom whole-day range; default 7 days | | Full-screen window | **6 hours** minimum, all data maximum; menu presets 6 h / 1 d / 3 d / 1 week / all | | Insulin chart axis | Scales to the largest dose ×1.1, never below **5 units** | | Report presets | Last 7 Days, Last 30 Days, Last 3 Months, Last Year, Custom Range — whole days, one cat per report | | Report page size | US Letter | ## Reminders | Limit | Value | |---|---| | Reminders | **4** daily (morning/evening × glucose/insulin), one schedule for all cats; default **8:00, 8:05, 20:00, 20:05** | | Foreground suppression | Insulin reminder hidden if the active cat has a dose in the **last hour** | | Post-dose suppression | An insulin reminder due in the **next 60 minutes** is pushed to tomorrow | ## CSV | Limit | Value | |---|---| | Glucose on import | > 0 and ≤ **2000 mg/dL** after unit conversion; unit-less values must be ≥ **19** | | Insulin on import | > 0 and ≤ **200 units** | | Duplicate match | Same cat, same **minute**, same value to **3 decimals**, same insulin type | | Export precision | Glucose **1** decimal (mg/dL), insulin **2** decimals | | Skipped-row list | Reasons for every skipped row; the first **20** row numbers are kept, the first one shown | | Encodings | UTF-8 (with or without BOM) and UTF-16. Windows-1252 files with non-ASCII characters are usually misread and refused as *The CSV file is empty or cannot be read* (depends on where those characters fall) — save as CSV UTF-8 | ## What SugarPaws does not do - Connect to a glucose meter, continuous glucose monitor or any device. - Sync between devices, back up to a cloud, or restore anything but a CSV. - Compute glucose variability, coefficient of variation, "time in range" as a duration, trend lines, consistency scores or any derived metric — only counts, an average and the share of readings inside the target range. - Suggest, adjust or grade an insulin dose, or predict a reading. - Edit an entry in place (delete and re-log instead). - Keep separate reminder schedules or insulin types per cat. - Run on the web, Android or Mac. ## Next steps - [Log a glucose reading](https://docs.neuralconfig.com/sugarpaws/app/logging-glucose/): Where the reading bounds and warnings come from. - [CSV import](https://docs.neuralconfig.com/sugarpaws/data/csv-import/): The import limits, explained. - [The insulin activity curve](https://docs.neuralconfig.com/sugarpaws/app/insulin-activity-curve/): What the onset, peak and duration numbers build. --- # Troubleshooting Source: https://docs.neuralconfig.com/sugarpaws/troubleshooting/ Most of what looks like a fault in SugarPaws is the app declining to guess: it refuses a reading it cannot record, warns before a likely double entry, shows a dash rather than a misleading 0 %, and reports rows it could not import instead of dropping them silently. This page goes symptom by symptom. For anything not here, contact the [support team](https://support.neuralconfig.com/sugarpaws?from=docs). ## "Your data couldn't be loaded" The app opened to a full-screen message — *SugarPaws couldn't open its database. Try restarting your device and freeing up storage space. If the problem continues, reinstalling the app will reset its data.* — instead of the tabs. The database file could not be opened (corruption, a failed migration or a full disk). Restart the device and make sure it has free space, then reopen. If it persists, reinstalling clears the app's data — so if you have a CSV backup, that is what you will import afterwards; if you do not, contact support before reinstalling. ## Reminders never arrive Check, in order: 1. **Enable Reminders** is on in Settings › Reminders — it is **off by default** and schedules nothing until you turn it on. 2. iOS permission was granted. If you see *Notifications are turned off for SugarPaws, so reminders can't be delivered* under the toggle, tap **Open Settings** and allow notifications; the toggle turns itself off whenever iOS permission is denied. 3. The times in **Configure Times** are what you expect (defaults 8:00, 8:05, 20:00, 20:05). 4. You are not seeing suppression working as designed: an **insulin** reminder is hidden while the app is open if the active cat had a dose in the last hour, and is moved to tomorrow if you log a dose within the hour before it. Glucose reminders are never suppressed. 5. A Focus mode or Do Not Disturb on the phone is not silencing the app. See [Reminders](https://docs.neuralconfig.com/sugarpaws/app/reminders/). ## The Save button is grey, or the reading won't save - **Save Glucose Reading** is *disabled* only while the field is empty. It *looks* grey whenever the text is not yet a recordable reading — while you are still typing, or if the value is outside the recordable 20–999 mg/dL (1.1–55.5 mmol/L) range — and turns green once it is. - With text present the grey button is still tappable, so tapping it explains why, under the field: *Enter a number in mg/dL.*, *Readings below 20 mg/dL can't be recorded.* or *Readings above 999 mg/dL can't be recorded.* (1.1 / 55.5 for mmol/L). A number with both a comma and a full stop is rejected as ambiguous. Fix the text; the message clears as you type. Nothing is ever clamped into range for you. - **Save Insulin Dose** is grey only while a save is in progress. ## A "Check before saving" dialog appeared Not an error — the app noticed something worth a second look and lists every reason at once: the same reading within 10 minutes, a reading outside 40–500 mg/dL, a dose within 60 minutes of the last, or a dose over 15 units. **Save Anyway** records it as typed; **Cancel** returns to the form. See [Log a glucose reading](https://docs.neuralconfig.com/sugarpaws/app/logging-glucose/) and [Log an insulin dose](https://docs.neuralconfig.com/sugarpaws/app/logging-insulin/). ## The last-dose strip or wheel shows a different dose than I gave The wheel prefills with the last dose **rounded down** to the nearest half unit (2.3 → 2.0), because over-dosing is the dangerous direction; spin it up. The strip shows the exact recorded value. A dose off the half-unit grid can only have come in through CSV import. ## "Readings in Range" shows — instead of a number Either the range on the Charts tab holds no readings, or the active cat's profile has no usable target range. Set one in Settings › Cat Profile. The tile shows a dash rather than 0 % so that "no target set" is never confused with "nothing in range". See [Charts](https://docs.neuralconfig.com/sugarpaws/app/charts/). ## The Charts tab says "No Data Available" The selected range (24h, 7, 30, 90 days or the custom dates) holds no entries for the **active cat**. Widen the range, check the cat switcher, and — for a custom range — the *From/To* dates under the segment control. A range with readings but no doses shows the glucose chart and *No insulin data available* in the other's place, not this message. ## The insulin activity chart says "Couldn't Load Insulin Doses" *Your data is still saved. Pull the Charts tab away and back, or reopen SugarPaws, to try again.* — the doses could not be read on that attempt. This is deliberately a different message from *No Insulin Data*, which means there are none. ## Values look about 18 times too big or too small Glucose is stored in mg/dL and shown in the unit under Settings › Units; 1 mmol/L = 18 mg/dL. Check that setting first. If the problem is only in imported rows, the file's `Unit` column was probably missing or unrecognised: unit-less values are read as mg/dL (values under 19 are skipped rather than guessed at). Add a `Unit` column reading `mmol/L` and import again — the wrongly imported rows will need deleting from History, since duplicates are matched on the *stored* value. See [CSV import](https://docs.neuralconfig.com/sugarpaws/data/csv-import/). ## After "Delete All Data" the app is back in mg/dL Expected: the reset restores every setting's factory default, and the unit's factory default is mg/dL (the region guess only runs on a brand-new install). Choose mmol/L again in Settings › Units. See [Settings](https://docs.neuralconfig.com/sugarpaws/app/settings/). ## Import skipped rows, or refused the file - **Imported with Warnings** followed by *N rows couldn't be read and were not imported (…)* names the reasons — incomplete rows, unreadable values or dates, out-of-range values (glucose over 2000 mg/dL, doses over 200 units or ≤ 0), unrecognised row types, unrecognised glucose units — and the first affected data row. Fix those rows and import again; rows already imported are recognised as duplicates and skipped. - **Import Error — The CSV file format is invalid. Expected headers: Type, Date, Time, Value**: one of the four required column headers is missing or misspelled (they are case-sensitive). - **The CSV file is empty or cannot be read**: nothing below the header. If the file clearly has rows, it was probably saved in a Windows ("ANSI" / Windows-1252) encoding and misread — re-save it as **CSV UTF-8** and import again. - **None of the rows in this file could be imported…**: every row was skipped; the reasons follow. - **Unable to read the CSV file. Please ensure it's saved as UTF-8 text**: the file is in an encoding the app cannot read. Re-save it as **CSV UTF-8** and import again. (A Windows-1252 file usually shows *empty or cannot be read* above instead.) - **Cat Profile Conflicts** is a question, not an error: the file names an existing cat other than the active one. **Merge Data** or **Cancel Import** (nothing has been written yet). ## The report or export won't share - **Report Failed** — *couldn't find this cat's profile* / *couldn't draw the charts* / *couldn't write the report file. Check that your device has free storage.*: relaunch, switch cats and back, or free storage, then try again. - **Export Failed** — *SugarPaws couldn't write the export file. Make sure your device has free storage and try again.*: free storage. - **Export Failed** — *SugarPaws couldn't read your data to export it: …*: the database read failed, not the disk. Close and reopen SugarPaws, then try again; if it persists, contact support with the text after the colon. - **Couldn't Open Share Sheet** — *SugarPaws built the report/file but couldn't open the share sheet. Please try again.*: the iOS share sheet failed to present; tap the button once more. ## There is no cat switcher bar It appears only when you have **two or more** cat profiles. Add one from Settings › Cat Profile › **Manage Cats › Add New Cat**. See [Cat profiles](https://docs.neuralconfig.com/sugarpaws/app/cat-profiles/). ## The disclaimer keeps appearing Settings › Advanced › **Always Show Disclaimer** is on. Turn it off; the disclaimer then shows only once per install. ## An entry I deleted is gone for good Undo is offered for **5 seconds** in the black banner at the bottom of the screen (above the tab bar on iPhone); after that the delete is final and there is no trash. Log it again from the Add tab, setting the **Time** picker to when it happened. ## Next steps - [Get started](https://docs.neuralconfig.com/sugarpaws/app/getting-started/): First launch and the four tabs. - [Limits and ranges](https://docs.neuralconfig.com/sugarpaws/data/limits/): Every bound the messages above refer to. - [Privacy and where your data lives](https://docs.neuralconfig.com/sugarpaws/data/privacy/): Why a reinstall resets the data, and what the backup is.