Repository navigation
v1.2.0
A big release. Pillbox now covers many more long-term conditions and life stages, works by your body rather than a gender field, and is easier to use for everyone, including neurodivergent people. It also adds sign-ups, terms and privacy pages, and a lot of new options for medicines.
Pillbox helps you keep a record. It isn't medical advice: always follow your prescriber's instructions, and in an emergency call 999.
New Care categories
Switch the ones you need on in Account → Health profile. Each has a printable one-page summary for your GP or clinic.
- Pregnancy
- Due date and how far along you are (weeks and days).
- The NHS antenatal timeline: appointments, scans, vaccines, MatEx, MATB1, birth plan and hospital bag, with Book and Done buttons and space for results.
- A log of each check-up: blood pressure, urine, bump, heartbeat and position.
- Folic acid and vitamin D added to Meds in one tap.
- A "Something not right?" panel with your maternity unit's number.
- Pregnancy options and aftercare (private): continuing, adoption and abortion set out without recommending any of them; steps, medicine times, bleeding and symptoms, and a follow-up test. Encrypted, with its own PIN, never shared, and deleted in one go.
- Menopause
- Stage, months since your last period, and a daily symptom diary with triggers.
- The Greene Climacteric Scale.
- One-tap HRT set-ups.
- Contraception and bleeding guidance, and work notes.
- Premenstrual symptoms (PMS, PMDD, PME), in Periods and contraception:
- Daily DRSP ratings, or a 30-second check-in.
- A chart of cycles stacked by day, and the week before each bleed compared with the week after.
- A heads-up before harder days, medicines taken only in the 2 weeks before a period, and gentle links to support.
- Thyroid
- Levothyroxine timing, and spacing checks against calcium, iron, antacids and minerals.
- TSH charts with dose changes marked, and when the next test is due.
- A weekly symptom check, and MedEx renewal.
- Diabetes
- Time in range and patterns by time of day, with CGM data via Nightscout.
- Ketone guidance and an insulin and carbs log.
- A one-tap hypo guide with a 15-minute timer, sick-day mode, and the DVLA "five to drive" check.
- Your annual care checks as a done/due list.
- Migraine and headaches
- A headache diary with monthly headache, migraine and painkiller days.
- Medication overuse warnings, and menstrual migraine patterns.
- Preventive treatment reviews, and the evidence used for CGRP medicines.
- Safety warnings for topiramate, and for combined contraception with aura.
- Blood pressure
- Guided home monitoring the NICE way (2 readings a minute apart, morning and evening, day 1 left out of the average), against your target.
- Medicine changes marked on the chart, side effects, and safety advice for very high or low readings.
- Monitor CSV import.
- ADHD and autism (no diagnosis needed)
- Waiting lists, including Right to Choose, and assessment prep notes.
- A communication passport to show, print or copy into your medical ID, and a Reasonable Adjustment Flag reminder.
- Optional energy and sensory notes.
- Gender-affirming care (private)
- GIC waiting list, prescriber and shared care.
- Fertility, a changes journal with your own fields, and encrypted progress photos.
Your body, not a gender field
- An optional, private body inventory:
- It decides which screening reminders you get (cervical, breast, bowel, AAA) and which pages appear.
- The Screening page points out invitations that may not arrive because of the sex on your GP record.
- Pronouns and an optional gender identity in your profile. "Women's health" is now Periods and contraception.
Medicines
- Schedules:
- Morning, Afternoon and Evening quick times, with "Take all" for each part of the day on Today.
- Doses every few days or weeks, for injections.
- Doses only in the 2 weeks before a period.
- Short courses and one-off doses that stop by themselves.
- Supplements with one-tap common ones, and medicines marked as private prescriptions or bought, with prices kept out of PPC sums.
- Running low? Mark it Ordered, then Collected. Controlled drugs show when to ask for the next prescription and a "collect by" date (28 days).
- How it's working: a log of when a dose was taken, kicked in and wore off, side effects, and a table comparing each dose.
- Injections and brands:
- Injection-site rotation, which suggests the next site.
- The brand recorded with each collection.
- Hormone set-ups for HRT, gender-affirming hormones, PMDD treatments and thyroid medicines.
- Private medicines: reminders and emails just say "Reminder", and they're hidden from people you share with.
Blood tests
- Results and trends: 30 tests in UK units, with charts, the lab's range, your own target range, the time since your last dose, and medicine changes marked.
- A full set of ready-made blood test reminders.
Easier for everyone
- Account → Display and reminders:
- Larger text, more spacing, an easy-read font, and no animations.
- Hide streaks.
- A "did you take it?" follow-up notification.
- Today:
- A Now / Next view and a timeline of the day.
- Log a dose with the time you took it.
- Running-low notices show the steps (order, collect, log stock).
- "Not logged" instead of "Missed".
- A visual timer.
- Privacy: hide the screen when switching apps, and a disguised home-screen name and icon ("Planner" or "Notes").
Accounts and site
- Sign-ups: people can create their own accounts with a password or single sign-on. Admins can require approval and get an email about each new sign-up.
- Terms of use and a privacy policy, generated from what Pillbox does. They're linked in the footer and agreed to when signing up.
- A new tablet logo in your theme's colours.
- Pillbox is now licensed under the GNU GPL v3.0.
Upgrading from v1.1.0
- Update from the Admin page, with git pull, or by uploading the new files.
config/config.phpandstorage/are kept. - Open Pillbox once. The database updates itself, with many new tables and columns.
- Make sure
storage/is writable: private progress photos are stored there, encrypted. - Keep the scheduled tasks running every 5 minutes. They send the new prescription, follow-up and cycle notifications, and sync Nightscout.
- Admin → Site settings:
- Under Terms and privacy, fill in who runs your Pillbox and a contact (have the text checked: it's a starting point, not legal advice).
- Under Sign-ups, choose whether people can sign up.
- Optional settings in
config/config.php(seeconfig.example.php):'signup','legal', and'nightscout' => ['allow_private' => true]if everyone using your Pillbox is trusted and your Nightscout is on a private network.
Good to know
- Encryption: the private pages (Pregnancy options and aftercare, and Gender-affirming care) are encrypted with the key in
storage/app.key. Keep that file safe and backed up: without it they can't be read. - Not included yet:
- Bluetooth blood pressure monitors.
- Weather data for migraine.
- Repeating monthly HRT cycles.
- Buttons inside notifications.