Menstrual Cycle Tracker (iOS)

Rhythm is an open-source iOS application built to help users log and understand their menstrual cycles. It provides concise, evidence-based insights on hormonal phases, fertility windows, and self-care strategies. We welcome community contributions and collaboration to enhance its features and reach.

---

Key Features

• Cycle Logging
  Record period start/end dates, flow levels, and cycle lengths.

• Symptom & Mood Tracking
  Keep track of daily symptoms (e.g., cramps, bloating) and emotional changes.

• Phase Insights
  Automatic detection of Menstrual, Follicular, Ovulatory, and Luteal phases, along with related tips, pregnancy probabilities, and mood expectations.

• Privacy & Security
  Your data remains private, stored locally or synced securely (depending on your preferences).

---

Menstrual Phases (Quick Overview)

1. Menstrual (Days ~1–5)

   • Biology: Low estrogen/progesterone trigger shedding of uterine lining.
   • Pregnancy Probability: Very low (but not zero).
   • Common Symptoms: Cramping, fatigue, irritability.
   • Tips: Light exercise, warm compresses, nutrient-rich foods.

2. Follicular (Days ~1–13, overlaps with Menstrual)

   • Biology: Rising estrogen, follicles in the ovary mature, endometrium rebuilds.
   • Pregnancy Probability: Moderate, increasing as ovulation nears.
   • Common Symptoms: Improved mood, rising energy, possible boost in libido.
   • Tips: Higher-intensity workouts, tracking cervical mucus/ovulation kits.

3. Ovulatory (Around Day ~14 in a 28-day cycle)

   • Biology: LH surge releases the egg; highest chance of conception.
   • Pregnancy Probability: Peak fertility window.
   • Common Symptoms: Elevated libido, mild pelvic twinges (Mittelschmerz).
   • Tips: Ideal time for conception; stay hydrated and pay attention to bodily cues.

4. Luteal (Days ~15–28)

   • Biology: Progesterone rises, preparing uterus for potential implantation.
   • Pregnancy Probability: Higher early on if fertilization occurs; declines otherwise.
   • Common Symptoms: Possible PMS (mood swings, bloating, breast tenderness).
   • Tips: Nutrient-dense diet, moderate exercise, stress management.

---

Getting Started

1. Clone:

   git clone https://github.com/wolfrayet0855/Rhythm.git
   cd Rhythm
   

2. Open & Install:

• Open the project in Xcode (14.0+ recommended).
• Install any dependencies (e.g., Swift Package Manager).

3. Run:

• Select a simulator or device in Xcode.
• Build and run.

---

Contributions:

We believe in the power of open-source collaboration. Feel free to:

1. Fork this repository.
2. Create a branch for new features or bug fixes.
3. Commit and push your changes.
4. Open a Pull Request describing your work and its benefits. We encourage adding new features, translations, UI improvements, and more.

Happy coding 🚀!