Period & Cycle Hub

The Cycle Hub is a self-hosted, privacy-first suite designed to track, calculate, and analyze menstrual health, fertility, and pregnancy. This document outlines how to utilize the period and cycle features.

1. Onboarding & Settings

To configure your cycle preferences, navigate to Settings -> Cycle & Pregnancy. Here you can set:

  • Current Mode: Select between Standard (Period Tracking), TTC (Trying to Conceive), Pregnancy, Postpartum, or Menopause.
  • Cycle & Period Length: Input your average cycle length (e.g. 28 days) and average period duration (e.g. 5 days) as fallbacks.
  • Birth Control Method: Select your contraceptive method (e.g. pill, IUD, none) to calibrate the prediction engine.
  • Discreet Mode: Toggle this option to replace all cycle hub headers, sidebar navigation labels, and icons with a neutral "Wellness" label and generic wellness icon.

2. Daily Log & Cycle Features

Click "Today's Log" on the dashboard to record daily metrics:

  • Flow Tracking (4 Levels): Log flow intensity across four levels (Spotting, Light, Medium, Heavy) to record period start/end dates.
  • BBT Logging & Biphasic Detection: Record your waking temperature to the hundredths decimal place (e.g. 36.55 °C) to assist ovulation detection.
  • Ovulation & Fertile Window: View estimated fertile days and ovulation timing calculated from logs and historical statistics.
  • 40+ Symptoms, Moods, Meds, Sex Log:
    • Symptoms: Log from 43 physical and emotional symptoms (Cramps, Headache, Fatigue, Insomnia, Acne, etc.).
    • Moods: Log emotional states (Happy, Calm, Sensitive, Irritable, Anxious, Sad).
    • Meds: Track daily pills or custom medications with check-in compliance logs.
    • Sex Log: Record intercourse sessions, with toggles for protected or unprotected status.
  • Sleep, Water, Weight, Energy: Track hydration, nightly sleep duration, body weight, and daily energy levels. The Daily Log panel displays a read-only glance header showing today's totals for Water (ml), Sleep (hrs), and Weight (kg).

3. Calendar & Projections

Navigate to the Calendar tab to view your history and projections:

  • Cycle Calendar & Predictions: Month-grid calendar displaying period history, predicted period dates, and fertile window/ovulation days.
  • Paint Period Timelines: Click the Edit Periods (pencil icon) to tap calendar blocks and instantly log or erase period intervals in bulk.
  • Cycle History & Regularity: View historical cycles with horizontal track timelines, manage excluded outliers, or manually add older cycle logs.

4. Notifications & Reminders

  • Period & Ovulation Reminders: Planned Roadmap (This feature is currently deferred to the active backlog as it requires app-wide background worker and notification dispatching infrastructure).
Table of Contents