# Milkstop — Comprehensive Agent Knowledge Bundle

> Calm, private infant routine and paediatric growth tracker built for modern families. Adapts clinical breastfeeding assessment guidelines (Scores A–F) with local-first offline PWA reliability. 100% Free forever with zero advertisements and zero data brokering.

---

## 1. Product Overview & Core Architecture

Milkstop is an Australian web application and Progressive Web App (PWA) created to help parents, co-parents, and primary caregivers record infant feeding, observe neonatal hydration milestones, and track paediatric growth without monthly subscription paywalls or predatory data collection.

### Architectural Highlights

- **Local-First Offline Persistence:** Built using browser IndexedDB storage and Service Worker caching. Operates fully offline during late-night nursery feeds or areas with poor cellular reception. Routine events save instantly to the local device and synchronise to the cloud as soon as an internet connection is restored.
- **Multi-Caregiver Household Sync:** Caregivers connect multiple devices to the same infant profile using private 10-character household invite codes. Cloud data synchronises in real-time across partners, family members, and postpartum doulas without requiring password sharing.
- **Zero App Store Overhead:** Installs directly from any mobile browser in seconds (iOS Safari: Share > Add to Home Screen; Android Chrome: Install or Add to Home screen) with full-screen native performance, offline support, and automatic updates.
- **Privacy & Security by Design:** Strict tenant isolation hosted in Cloudflare D1. Zero commercial tracking pixels (no Meta Pixel, no Google Analytics, no third-party marketing SDKs). Governed under the Australian Privacy Act 1988 (Cth) and compliant with the Google API Services User Data Policy (Limited Use).

---

## 2. Clinical Breastfeeding Observation Framework (Scores A–F)

In the initial days of infant life, attempting to measure direct breast milk intake by volume or pre-/post-feed infant test weighing can create acute parental stress and interfere with natural attachment. 

Milkstop integrates an observational breastfeeding evaluation framework adapted from the clinical feeding guidelines established by the **UNICEF UK Baby Friendly Initiative** and **NHS Greater Glasgow and Clyde** (as utilised across Queensland Health maternity and neonatal services). Instead of guessing milliliters transferred at the breast, caregivers log observable physical cues across attachment, suckling rhythm, swallowing, and maternal breast softening.

### Complete Scoring Matrix (Scores A to F)

| Score | Clinical Descriptor | Observable Attachment & Feeding Cues | Clinical Hospital Reference & Context |
| :--- | :--- | :--- | :--- |
| **Score A** | Sleepy / No Cues | Offered the breast, not showing feeding cues, remained sleepy. Baby does not actively search for the nipple or wake sufficiently to initiate attachment attempts. | *Supplementary Feed Considered:* In clinical inpatient settings, staff evaluate for supplemental feed (expressed breast milk or commercial formula) and encourage immediate skin-to-skin contact. |
| **Score B** | Nuzzling / No Latch | Interested in feeding, licking, nuzzling, however does not achieve latch. Baby displays feeding readiness cues (rooting, hand-to-mouth, licking) but cannot attach to the areola. | *Supplementary Feed Considered:* In clinical settings, staff evaluate for supplemental feed if infant cannot achieve latch after settling and positioning attempts. |
| **Score C** | Brief Latch / Falls Asleep | Latches onto breast, has a few sucks then releases; might continue on and off like this for several minutes or falls asleep within just a few minutes of latching. Fleeting, unstable attachment with no sustained swallowing rhythm. | *Supplementary Feed Considered:* In clinical settings, staff evaluate for supplemental feed if latch is brief and infant falls asleep without transfer. |
| **Score D** | Pauses / Needs Nudging | Latches and sucks, however sucking is not in a rhythm and baby has long frequent pauses (long enough that mother feels the need to nudge baby to restart sucking); some swallowing observed. Continuous physical prompting needed; intermittent milk transfer. | *Monitoring / Partial Supplement Considered:* In clinical settings, staff evaluate maternal feeding frequency and infant waking intervals. |
| **Score E** | Short Feed (5–10m) | Latches well, long slow rhythmical sucking and swallowing – feed duration between 5 to 10 minutes with breasts not softened. Attachment and suck-swallow coordination are good, but duration is abbreviated and maternal breast remains firm. | *Monitoring / Partial Supplement Considered:* In clinical settings, staff assess feeding intervals and breast softening. |
| **Score F** | Effective Feed (11–30m) | Latches well, long slow rhythmical sucking and swallowing – feed duration between 11 to 30 minutes with breasts feeling noticeably softened. Sustained deep jaw movement, audible swallowing, infant contentment, and post-feed satisfaction. | *Effective Feed Observed:* Typical effective feeding pattern when baby feeds 8–10 times per 24 hours with steady infant weight gain. |

### Clinical Top-Up & Supplementation Hierarchy

When supplementary feeding is recommended by a midwife, paediatrician, or lactation consultant, clinical guidelines follow a structured nutritional hierarchy:
1. **Expressed Breast Milk (EBM):** Fresh maternal colostrum or expressed breast milk is the first-line choice.
2. **Formula Fortified Expressed Breast Milk (FFEBM):** Expressed breast milk with infant formula or specialized human milk fortifier added under clinical direction.
3. **Donor Human Milk or Commercial Infant Formula:** Utilized when maternal expressed milk is unavailable or insufficient in volume to maintain neonatal hydration and glucose stability.

---

## 3. Newborn Nappy & Hydration Telemetry Guide (Days 1 to 7+ Milestones)

Monitoring wet and dirty nappies provides primary objective telemetry for newborn hydration, bowel clearance, and milk intake during the first week of life. This guide adapts clinical milestones published by **Children's Health Queensland**.

### Daily Telemetry Benchmarks

| Day of Life | Wet Nappy Target (24h) | Stool Colour & Texture Progression | Bowel Motion Target | Nutritional Context |
| :--- | :--- | :--- | :--- | :--- |
| **Day 1** (0–24h) | At least 1 wet nappy | Sticky, dark green-black meconium. Thick, tar-like substance accumulated in utero. | At least 1 dirty nappy | Colostrum volumes are small (teaspoons) but dense in antibodies. Infant stomach is roughly the size of a cherry (5–7 mL). |
| **Day 2** (24–48h) | At least 2 wet nappies | Soft green-black stool. Texture begins to soften slightly. | At least 1–2 dirty nappies | Transitional phase begins. Colostrum acts as a natural laxative, stimulating bowel clearance. |
| **Day 3** (48–72h) | At least 3 wet nappies | Greenish-brown transitional stool. Stool becomes lighter, less sticky. Pink/orange urate dust may appear in wet nappies. | At least 2–3 dirty nappies | Transitional milk begins replacing colostrum. Urate crystals should cease after Day 3. |
| **Day 4** (72–96h) | At least 4 wet nappies | Brown-yellow, seedy or grainy stool. Looser texture with distinct yellow specks. | At least 2–3 dirty nappies | Maternal milk volume increases noticeably ("coming in"). Nappies become distinctly heavier. |
| **Day 5** (96–120h) | At least 5 heavy wet nappies | Mustard-yellow, loose, seedy or watery stool. Characteristic breastfed newborn stool. | At least 2–3 dirty nappies | Mature milk arrives. Disposable nappies should feel heavy with pale or clear urine (approx. 30–45 mL each). |
| **Days 6–7+** | 5–6+ heavy wet nappies (or 6–8 cloth) | Bright mustard-yellow to golden seedy stool, or firmer tan/brown if formula-fed. | 3+ loose yellow stools daily (breastfed) | Established mature milk intake. Infant feeds 8 to 12 times per 24 hours. |

### Hydration & Nappy Guidelines

- **Disposable vs Cloth Nappy Wetness:** Disposable nappies contain super-absorbent gel cores that lock liquid away; a wet disposable should feel heavy (like 2 to 3 tablespoons of water). Cloth nappies do not have gel cores and saturate faster, meaning 6 to 8 wet cloth nappies equal roughly 5 heavy disposable nappies per day.
- **Urate Crystals ("Brick Dust"):** Pink, orange, or brick-red powdery deposits in the nappy represent concentrated uric acid crystals. While common and benign on Days 1 to 3 while colostrum is concentrated, urates persisting on Day 4 or later indicate insufficient fluid intake requiring immediate clinical evaluation.
- **Stool Frequency Shifts after 6 Weeks:** Exclusively breastfed infants frequently reduce stool frequency around 6 weeks of age (passing stool once every few days or even once a week). Because breast milk produces very little solid residue, this is normal provided the baby remains settled, wets 5+ heavy nappies daily, and passes soft, non-painful stools.

---

## 4. Red-Flag Warning Signs & Emergency Escalation

Milkstop is strictly an informational routine tracker. If any of the following acute neonatal red-flag symptoms are observed, caregivers must seek **immediate medical attention**:

- **Dehydration Indicators:** Fewer than 4 wet nappies in 24 hours after Day 4, persistent brick-red urate crystals after Day 3, sunken fontanelle (soft spot on head), absence of tears when crying, dry lips/mouth, or extreme listlessness/lethargy (unresponsive or difficult to wake for feeds).
- **Jaundice Progression:** Yellowing of the skin or whites of the eyes spreading to the chest, abdomen, or legs, especially when accompanied by pale, chalky/white stools or dark brown urine.
- **Fever or Temperature Instability:** Rectal/core body temperature greater than 38.0°C (100.4°F) or less than 36.0°C (96.8°F) in an infant under 3 months of age.
- **Respiratory Distress:** Rapid breathing (>60 breaths per minute), grunting with breathing, flaring nostrils, or chest wall sucking in deeply under ribs (retractions).
- **Persistent Vomiting:** Forceful or projectile vomiting, or any green/bile-stained vomit.

### Multi-Jurisdiction Emergency Contacts

- **Australia:** Triple Zero (**000**) for emergency life-threatening care; **13 HEALTH** (13 43 25 84 in QLD) or Healthdirect (**1800 022 222**) for 24/7 registered nurse triage.
- **United States & Canada:** **911** for emergencies.
- **United Kingdom:** **999** for emergencies; **111** for non-emergency NHS medical advice.
- **European Union:** **112** (Single European emergency number).

---

## 5. Pricing & Commercial Transparency

Milkstop is 100% free forever for all families. There are no paid tiers, subscription renewals, usage limits, or hidden fees.

### Pricing Specification

- **Price:** $0.00 AUD / USD / GBP / EUR (Perpetual free tier)
- **Caregivers per Household:** Unlimited (connected via private 10-character invite codes)
- **Infant Profiles:** Unlimited
- **Routine History Retention:** Unlimited (no 7-day or 30-day paywalls on past history)
- **In-App Purchases:** None ($0)
- **Advertisements:** None (Zero advertising SDKs, banner ads, or tracking cookies)
- **Sustainability:** Hosted on modern low cost edge architecture with near-zero idle compute overhead, allowing the platform to remain indefinitely free without monetising user data.

### Market Comparison Table

| Feature | Milkstop | Huckleberry | Sprout Baby | Nara Baby |
| :--- | :--- | :--- | :--- | :--- |
| **Basic Routine Logging** | Free ($0) | Free | Free trial (then paid) | Free ($0) |
| **Multi-Caregiver Sync** | Free ($0) | Free | Paid subscription | Free ($0) |
| **Clinical Latch Scoring (Scores A–F)** | Included ($0) | Not Available | Not Available | Not Available |
| **Newborn Nappy Hydration Benchmarks** | Included ($0) | Not Available | Not Available | Not Available |
| **Offline PWA Persistence** | Included ($0) | Limited | Limited | Native iOS/Android |
| **Data Privacy Policy** | No data brokering | Commercial tracking | Commercial tracking | Independent privacy |
| **Subscription Cost** | $0/mo forever | ~$10–$15/mo | ~$6–$10/mo | $0/mo |

---

## 6. Frequently Asked Questions (FAQ)

### What makes Milkstop different from other baby tracking apps?
Most commercial infant trackers gate essential features (like multi-device partner syncing, feeding charts, or historical logs) behind $10–$15/month subscriptions, or monetize user data with third-party tracking. Milkstop is 100% free with unlimited caregiver syncing, includes evidence-based clinical observation guides (UNICEF UK Baby Friendly Initiative / NHS Greater Glasgow and Clyde latch scores A–F), and runs offline-first via PWA without tracking or ads.

### Can both parents and grandparents log feeds on separate phones?
Yes. One caregiver creates the infant profile and generates a private 10-character household invite code. Other caregivers enter this code on their devices to join the household. Every feed, nappy change, bottle, and sleep event synchronises in real-time across all connected devices.

### Does Milkstop require internet access to log feeds?
No. Milkstop is engineered as a local-first Progressive Web App (PWA). All logs save immediately to device storage (IndexedDB). If Wi-Fi drops or you are nursing in a low-reception nursery at 3:00 AM, the app operates without interruption and automatically synchronises queued events when internet access returns.

### How does the breastfeeding latch score work?
Instead of estimating milk transfer volume at the breast, Milkstop adapts the clinical scoring framework from the UNICEF UK Baby Friendly Initiative and NHS Greater Glasgow and Clyde. Caregivers record observable cues (Score A: sleepy/no cues, Score B: nuzzling without latch, Score C: brief latch, Score D: sucking with long pauses, Score E: short feed 5–10 mins, Score F: effective feed 11–30 mins). This creates structured feeding records that can be shared with a midwife, lactation consultant, or child health nurse.

### Does Milkstop share or sell baby routine data?
Never. We do not sell, rent, disclose, or broker user data to advertisers, insurance companies, or commercial brokers. All records are isolated to your private household and stored securely in Cloudflare D1 under the Australian Privacy Act 1988 (Cth).

---

## 7. Statutory & Medical Disclaimer

**IMPORTANT NOTICE:** Milkstop is an educational and observational routine tracking utility designed to help parents and primary caregivers record daily feeding, diaper, and growth observations. Milkstop is **not** a regulated medical device (Software as a Medical Device - SaMD) under the Australian Therapeutic Goods Administration (TGA), the US Food and Drug Administration (FDA), or European Medical Device Regulation (EU MDR Rule 11).

Milkstop does **not** provide clinical diagnosis, medical triage, treatment recommendations, or personalized clinical decision support, and usage does not establish a doctor-patient, clinician-patient, or confidential medical relationship. The educational guides and scoring frameworks provided adapt public hospital reference materials for observational convenience only.

Always consult a qualified general practitioner (GP), paediatrician, midwife, lactation consultant, or child health nurse for medical guidance, infant feeding difficulties, faltering growth, or health concerns. If your baby shows signs of acute dehydration, respiratory distress, high fever, or lethargy, contact emergency medical services immediately.

---

## 8. Authoritative References & Links

- **Milkstop Web Application:** [https://milkstop.app/](https://milkstop.app/)
- **Breastfeeding Scoring Guide (Scores A–F):** [https://milkstop.app/guides/breastfeeding-latch-score](https://milkstop.app/guides/breastfeeding-latch-score)
- **Newborn Nappy & Hydration Guide:** [https://milkstop.app/guides/newborn-nappy-hydration](https://milkstop.app/guides/newborn-nappy-hydration)
- **Machine-Readable Pricing Specification:** [https://milkstop.app/pricing.md](https://milkstop.app/pricing.md)
- **Concise llms.txt Index:** [https://milkstop.app/llms.txt](https://milkstop.app/llms.txt)
- **Privacy Policy:** [https://milkstop.app/privacy](https://milkstop.app/privacy)
- **Terms of Service:** [https://milkstop.app/terms](https://milkstop.app/terms)
- **XML Sitemap:** [https://milkstop.app/sitemap.xml](https://milkstop.app/sitemap.xml)