๐ŸŒฟ GutDiary Your Health Companion

0
Today
0
This Week
โ€“
Avg Type
0
Day Streak

Recent Entries

Bristol Stool Scale โ€” Type *
1
๐Ÿชจ
Separate Hard LumpsLike nuts, very hard to pass
Constipated
2
๐Ÿซ˜
Lumpy & Sausage-likeHard, can be painful
Hard
3
๐ŸŒญ
Sausage with CracksNormal, slightly dry
Normal
4
๐ŸŒ
Smooth & Soft SausageIdeal โ€” easy to pass
Ideal โœ“
5
๐Ÿซ
Soft Blobs, Clear EdgesLacking fibre
Soft
6
๐Ÿฆ
Fluffy, Mushy PiecesMild diarrhoea
Loose
7
๐Ÿ’ง
Entirely LiquidSevere diarrhoea โ€” no solids
Liquid
Colour
Brown
Dark Brown
Light Brown
Yellow
Green
Black
Red / Blood
Pale / Grey
5 โ€“ Moderate
๐Ÿ˜Œ ๐Ÿšจ
No urgencyCouldn't wait
0 โ€“ None
๐Ÿ™‚ ๐Ÿ˜–
No painSevere pain
Additional Symptoms
๐Ÿฉธ Blood
๐Ÿ’ง Mucus
๐Ÿ’จ Gas
๐Ÿซƒ Bloating
โšก Cramping
๐Ÿ”„ Incomplete
๐Ÿ’ช Straining
๐Ÿคข Nausea
Ease of Passing
๐Ÿ˜Š Very Easy
๐Ÿ™‚ Easy
๐Ÿ˜ Normal
๐Ÿ˜ฃ Difficult
๐Ÿ˜– Very Difficult
Date & Time
Notes (optional)
Photos (optional, stored on device only)
๐Ÿ“ท
Tap to add photos
Private โ€” never uploaded

๐Ÿ“Š Stats & Trends

Insights from your logged entries

๐Ÿ’ก Quick Insights
๐Ÿ“… Daily Movements (14 days)
๐ŸŒŠ Bristol Type Distribution
โšก Pain & Urgency Trends
๐ŸŽจ Colour Frequency

๐Ÿ“‹ Full History

All your logged entries

All Types
Type 1 ๐Ÿชจ
Type 2 ๐Ÿซ˜
Type 3 ๐ŸŒญ
Type 4 ๐ŸŒ
Type 5 ๐Ÿซ
Type 6 ๐Ÿฆ
Type 7 ๐Ÿ’ง

โš™๏ธ Export & Settings

Share data with your healthcare team

๐ŸŒ™
Dark ModeEasier on the eyes at night
๐Ÿ“ฑ
Add GutDiary to your Home Screen

On iPhone: tap Share โ†’ Add to Home Screen. On Android: tap the browser menu โ†’ Install App. Works offline!

โ„น๏ธ About GutDiary

GutDiary uses the clinically validated Bristol Stool Form Scale to help you track bowel health accurately. All data is stored locally on your device using localStorage โ€” nothing is ever transmitted externally. Export your CSV and share it directly with your gastroenterologist, GP or dietitian.

โš•๏ธ This app is a tracking tool only and does not provide medical advice. Always consult your healthcare provider about symptoms.

๐ŸŒฟ

How to use GutDiary

Everything you need to know about logging your gut health and sharing data with your doctor.

๐Ÿš€

Getting Started

โ–ผ
1

Tap the green โž• button at the bottom centre of the screen to open the logging form.

2

Choose your Bristol Stool Type (1โ€“7). This is the only required field โ€” everything else is optional but helpful.

3

Fill in as many details as you like โ€” colour, urgency, pain, symptoms, and notes. The more you log, the more useful your data is for your doctor.

4

Tap Save Entry. Your entry is stored privately on your phone โ€” nothing is sent anywhere.

5

Before a doctor's appointment, go to Export & Settings (โš™๏ธ) and tap Export as CSV to download a file you can share.

๐Ÿ“Š

The Bristol Stool Scale

โ–ผ

The Bristol Stool Form Scale is a medical diagnostic tool developed at the University of Bristol in 1997. It classifies stool into 7 types and is widely used by gastroenterologists and GPs to assess bowel health.

1
๐Ÿชจ
Separate Hard LumpsLike small stones โ€” very hard to pass
Constipated
2
๐Ÿซ˜
Lumpy SausageSausage-shaped but lumpy, hard
Hard
3
๐ŸŒญ
Sausage with CracksLike a sausage with surface cracks
Normal
4
๐ŸŒ
Smooth Soft SausageSmooth, soft โ€” the ideal type
Ideal โœ“
5
๐Ÿซ
Soft BlobsSoft blobs with clear-cut edges
Soft
6
๐Ÿฆ
Fluffy / MushyRagged edges, mushy consistency
Loose
7
๐Ÿ’ง
Entirely LiquidNo solid pieces โ€” watery
Liquid

Types 1โ€“2 suggest constipation. Types 3โ€“4 are considered healthy. Types 5โ€“7 suggest increasing diarrhoea. Persistent extremes should always be discussed with your doctor.

๐ŸŽจ

What Do the Colours Mean?

โ–ผ
BrownHealthy โ€” the normal colour
Dark BrownNormal, often after high-protein meals
Light BrownNormal variation, may indicate less bile
YellowCan indicate excess fat โ€” worth monitoring
GreenOften from leafy vegetables or fast transit
Blackโš ๏ธ May indicate upper GI bleeding โ€” seek advice
Red / Bloodโš ๏ธ Visible blood โ€” always discuss with your doctor
Pale / Greyโš ๏ธ May indicate a bile or liver issue โ€” seek advice
๐Ÿ“

Understanding the Other Fields

โ–ผ

๐Ÿšจ Urgency (1โ€“10)

How urgently did you need to go? 1 = no rush at all, 10 = you couldn't wait another second. High urgency is a common and significant symptom in IBD and IBS.

โšก Pain / Discomfort (0โ€“10)

Rate any pain during or after the movement. 0 = completely painless, 10 = severe pain. This helps your doctor see patterns of pain over time.

๐Ÿ˜– Ease of Passing

How easy was it? This combines Bristol type with effort required. Straining even for soft stools can be a useful symptom for your doctor to know about.

๐Ÿฉธ Symptoms

Tap any that apply. Blood or Mucus are particularly important to log โ€” your doctor will want to know the frequency of these. Incomplete Emptying (tenesmus) is a common IBD symptom.

๐Ÿ“ท Photos

Completely optional. Photos are stored only on your device and are never uploaded. They can help your doctor assess consistency or colour more accurately. Photos are not included in CSV exports.

๐Ÿ—บ๏ธ

Navigating the App

โ–ผ
๐Ÿ 

Home โ€” Your dashboard. Shows today's count, weekly total, average Bristol type, and your recent entries. Tap any entry to see its full details.

๐Ÿ“‹

History โ€” Browse all your entries. Use the filter bar at the top to show only specific Bristol types. Tap the ๐Ÿ—‘ icon to delete an individual entry.

โž•

Log โ€” The main logging form. Bristol type is required; everything else is optional. The date/time defaults to now but you can change it to backfill an entry.

๐Ÿ“Š

Stats โ€” Charts and trends including daily frequency, Bristol type distribution, pain & urgency over time, and colour breakdown. Quick insights highlight anything notable.

โš™๏ธ

Export & Settings โ€” Download a CSV for your doctor, back up all data as JSON, restore from a backup, or clear all data. Also has "Add to Home Screen" instructions.

๐Ÿ”’

Your Data & Privacy

โ–ผ
๐Ÿ›ก

All data is stored only on your device using your browser's built-in storage (localStorage). Nothing is sent to any server, cloud, or third party โ€” ever.

๐Ÿ’พ

Use Backup Data (JSON) regularly to save a copy of all your entries. If you clear your browser data, switch devices, or reinstall, you can restore from this backup.

๐Ÿ“Š

The CSV export contains all your text entries in a format your doctor can open in Excel or any spreadsheet tool. Photos are stored separately and are not included in the CSV.

โš ๏ธ

If you use Private / Incognito browsing, data will be lost when you close the browser window. Always use normal browsing mode for GutDiary.

๐Ÿ“ฑ

Installing on Your Phone

โ–ผ

GutDiary is a Progressive Web App (PWA). You can install it on your phone's home screen for instant access โ€” no app store needed, and it works offline.

๐ŸŽ

iPhone / iPad (Safari): Open the app in Safari โ†’ tap the Share button (square with arrow) โ†’ scroll down โ†’ tap Add to Home Screen โ†’ tap Add.

๐Ÿค–

Android (Chrome): Open the app in Chrome โ†’ tap the โ‹ฎ menu (top right) โ†’ tap Install App or Add to Home Screen โ†’ tap Install.

๐ŸŒ

Must use HTTPS: The app must be accessed via a secure https:// URL for PWA installation to work.

โ“

Frequently Asked Questions

โ–ผ
Will my data be lost if I clear my browser?
Yes โ€” clearing browser/site data will delete your entries. Always use the JSON backup feature (Export & Settings โ†’ Backup Data) to keep a safe copy. Restore it any time using Restore Backup.
Can I use this on multiple devices?
Not automatically โ€” data lives on each device separately. You can transfer by exporting a JSON backup on one device and importing it on another. Start with the device you use most often.
How do I share data with my doctor?
Go to Export & Settings โ†’ Export as CSV. This downloads a spreadsheet file you can email directly to your doctor, or print and bring to an appointment.
What if my storage is running low?
Photos use the most storage. If you notice issues, try limiting photos or removing older ones by editing entries. A JSON backup takes very little space compared to photos.
Does this replace medical advice?
No. GutDiary is a tracking tool to help you log symptoms and share data with your healthcare team. It does not diagnose conditions or replace professional medical advice. Always contact your doctor about concerning symptoms.
I found a bug or have a suggestion
Please use the contact button below to email the developer. Include your device type and browser, and describe what happened. Bug reports are genuinely appreciated!
โœ‰๏ธ

Questions or Bug Reports?

Found something that isn't working, or have an idea for a new feature? Drop an email โ€” all feedback is welcome and read personally.

โœ‰๏ธ dev@walker-jones.eu
โš•๏ธ

Medical Disclaimer: GutDiary is a personal symptom-tracking tool only. It does not provide medical advice, diagnosis, or treatment recommendations. Always consult a qualified healthcare professional โ€” especially if you notice blood, black stools, sudden changes, or severe pain.