Customization
The plugin offers extensive customization for buttons, timers, display preferences, and milestone tracking. All settings are in Settings > Postpartum Tracker.
Per-button configuration
Section titled “Per-button configuration”Each quick-action button can be individually configured with a visibility toggle, custom label, and custom icon.
Feeding buttons
Section titled “Feeding buttons”Open Settings > Postpartum Tracker > Feeding to configure:
| Button | Default label | Default icon | Configurable |
|---|---|---|---|
| Left breast | Breast L | L | Visible, label, icon |
| Right breast | Breast R | R | Visible, label, icon |
| Both breasts | Both | B | Visible, label, icon |
| Bottle | Bottle | 🍼 | Visible, label, icon |
Additional feeding toggles:
- Hold for details — when enabled, long-pressing a feeding button opens a form for notes and other fields before starting the timer.
- Show position field — adds a breastfeeding position selector (cradle, cross-cradle, football, side-lying, laid-back) to the details form.
Diaper buttons
Section titled “Diaper buttons”Open Settings > Postpartum Tracker > Diapers to configure:
| Button | Default label | Configurable |
|---|---|---|
| Wet | Wet | Visible, label, icon |
| Dirty | Dirty | Visible, label, icon |
| Both | Both | Visible, label, icon |
Toggle: Hold for details — long-press opens a form for stool color, description, and notes.
Medication buttons
Section titled “Medication buttons”Open Settings > Postpartum Tracker > Medication:
Toggle: Hold for details — long-press opens a form with notes field before logging the dose.
Hold-for-details
Section titled “Hold-for-details”Hold-for-details is a long-press gesture (~500ms) that opens a form with optional fields before logging an entry.
How it works:
- Quick tap — logs the entry immediately with default values. Fastest workflow.
- Long press (~500ms hold) — opens a form for notes, position, color, or other optional fields.
Buttons that support long-press show a subtle visual indicator.
Available on:
- Feeding buttons (notes, position)
- Diaper buttons (stool color, description, notes)
- Medication buttons (notes)
- Simple tracker buttons with optional fields (notes, select fields)
- Timer stop buttons (edit duration, side, notes on feeding stop)
Timer animation
Section titled “Timer animation”When a feeding timer is running, the active button animates to draw attention.
Animation styles
Section titled “Animation styles”Open Settings > Postpartum Tracker > Display > Timer button animation:
| Style | Description |
|---|---|
| Pulse (default) | Gentle scale + glow effect |
| Blink | Opacity flashing |
| Glow | Steady glow ring |
| Solid | Static highlight (no animation) |
| Flash | Rapid opacity flash |
| Bounce | Subtle vertical bounce |
Animation colors
Section titled “Animation colors”Open Settings > Postpartum Tracker > Display > Timer animation color:
| Preset | Color | Description |
|---|---|---|
| Accent (default) | Theme color | Uses your Obsidian theme’s accent color |
| Red alert | #ef4444 | Warm red for urgency |
| Green glow | #22c55e | Calming green |
| Blue pulse | #3b82f6 | Cool blue |
| Custom | Any hex | Opens a color picker |
The chosen color applies to all animation styles (pulse glow, blink flash, bounce shadow, etc.).
Section reordering
Section titled “Section reordering”Every collapsible section in the widget can be moved up or down:
- Arrow buttons — tap the ▲/▼ arrows in each section header.
- Drag handle — on desktop, drag the ⠇ handle to reorder.
Section order is saved per code block in the layout array. Different notes can have different layouts.
Display settings
Section titled “Display settings”| Setting | Options | Default | Description |
|---|---|---|---|
| Time format | 12h / 24h | 12h | How timestamps display |
| Haptic feedback | On / Off | On | Vibration on button press (mobile) |
| Show button labels | On / Off | On | Text labels under button icons |
| Button size | Compact / Normal / Large | Normal | Quick-action button dimensions |
| Button columns | Auto / 2-6 | Auto | Grid columns for buttons |
| Input mode | Modal / Inline | Modal | How edit forms are presented |
| Entry window | Hours (0 = today) | 24 | How far back entry lists show |
| Summary bar | On / Off | Off | Show daily summary dashboard |
| Summary position | Top / After buttons / Bottom | Top | Where the summary bar appears |
| Show event history | On / Off | On | Unified activity feed |
| Show quick entry | On / Off | Off | NLP text input (guide) |
| Status bar | Badge / Live / Off | Off | Obsidian status bar display |
Entry list ordering
Section titled “Entry list ordering”All entry lists display newest entries first with day-separator headers:
- Today — entries from today
- Yesterday — entries from yesterday
- Mon, Mar 3 — older entries show weekday, month, and day
This makes it easy to see the most recent entries at a glance without scrolling.
Logic packs
Section titled “Logic packs”Logic packs are rule sets that define “what’s normal” for your baby’s age. They evaluate your tracker data against medical guidelines and surface progress in the daily summary and health alerts.
Enabling logic packs
Section titled “Enabling logic packs”-
Open Settings > Postpartum Tracker > Logic packs.
-
Toggle on the packs relevant to your situation.
-
Milestones appear in the daily summary (as a progress card) and as health alerts when expectations are not met.
Built-in packs
Section titled “Built-in packs”First week newborn
Section titled “First week newborn”Based on AAP and lactation consultant guidelines. Evaluates day-by-day expectations for the first 7 days:
Day-by-day expectations
| Day | Wet diapers | Stools | Stool color | Feedings |
|---|---|---|---|---|
| 0-1 | 1+ | 1+ | Meconium | 8+ |
| 2 | 2+ | 2+ | — | 8+ |
| 3 | 3+ | 3+ | Transitional/yellow | 8-12 |
| 4 | 4+ | 3+ | Yellow-seedy | 8-12 |
| 5-7 | 6+ | 3-4+ | Yellow-seedy | 8-12 |
Recommended modules: Feeding, Diapers
Postpartum recovery
Section titled “Postpartum recovery”Recovery milestones for the mother across the first 6 weeks:
Recovery milestones
| Period | Milestone | Alert level |
|---|---|---|
| Day 0-3 | Log pain at least once daily | Info |
| Day 0-3 | Stay on medication schedule | Info |
| Day 1-3 | Walk at least once daily | Info |
| Day 0-3 | First bowel movement | Warning |
| Day 4-7 | Increase to 2+ walks daily | Info |
| Day 3-7 | Daily mood check-in (baby blues peak) | Info |
| Week 2-6 | Continue daily mood monitoring | Warning |
| Week 2-6 | Maintain regular walking | Info |
Recommended modules: Medication, Bowel movements, Walking, Pain, Mood
Breastfeeding establishment
Section titled “Breastfeeding establishment”Feeding frequency and duration targets for the first 8 weeks:
Weekly targets
| Period | Feedings/day | Avg duration | Notes |
|---|---|---|---|
| Week 1 | 8-12 | 10+ min | Establishing supply |
| Week 2-4 | 8-12 | 15+ min | Building supply |
| Week 5-8 | 7-10 | 15+ min | Efficiency improving |
Recommended modules: Feeding
How milestones work
Section titled “How milestones work”- Green (on track): The milestone’s expectation is met. A positive message displays in alerts.
- Yellow (warning): The expectation is not met. An alert appears with guidance.
- Red (urgent): A critical expectation is missed. An urgent alert fires through all notification channels.
The daily summary shows a milestone progress card (e.g., “3/5 milestones met”) when logic packs are active.