Skip to content

acar-ipek/menstrual-cycle-tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌙 MyCycle

MyCycle is a holistic menstrual health application designed to bridge the gap between physical health and spiritual well-being. Built with a modern Android architecture, it empowers users to not only track their cycles but also align their lifestyle, movement, and rituals with their biological phases.

✨ Key Features

  • 4-Phase Biological Syncing: Detailed insights into the Menstrual, Follicular, Ovulatory, and Luteal phases, offering science-backed tips for nutrition, exercise, and mental health.
  • Intelligent Predictions: Real-time countdowns to your next period that react instantly to your personal health data and manual configurations.
  • Data-Driven Privacy: Local-first storage using Room database, ensuring your most sensitive health data stays on your device.
  • Astrology Lovers: Automated daily horoscopes integrated via web scraping to provide a complete view of your day, from biological hormones to astrological alignment.
  • Lunar Phases: Interactive tracking of the 8 moon phases with deep-dives into spiritual themes, practices, and "syncing tips" to harmonize your inner cycle with the lunar rhythm.

🛠️ Technical Excellence

This project serves as a showcase for modern Android development practices:

  • Language: Kotlin 2.0 (featuring the latest Compose Compiler)
  • UI: 100% Jetpack Compose with Material 3 design patterns.
  • SDK: Optimized for Android 15 (API 35).
  • Architecture: Clean Architecture with ViewModel, StateFlow, and Repository patterns.
  • Persistence: Room Database for robust, offline-first data management.
  • Networking/Scraping: Jsoup for dynamic real-time data extraction.

🎯 The Goal

The goal of MyCycle is to transform period tracking from a chore into a ritual. By combining modern engineering with ancient wisdom, it helps users build profound self-awareness and a sense of connection to natural rhythms.


🚀 Quick Start

Prerequisites

  • Android Studio Ladybug (2024.2.1) or newer.
  • Android SDK 35.

Installation

  1. Clone the repository:
    git clone https://github.com/yourusername/MyCycle.git
  2. Open the project in Android Studio.
  3. Sync project with Gradle files.
  4. Run on an emulator or physical device (API 24+).

📸 Screenshots

COMING SOON


🤝 Contributing

Contributions are welcome! Whether it's adding new spiritual rituals, optimizing biological insights, or improving the UI, feel free to open an issue or submit a pull request.


⚖️ License

This project is licensed under the MIT License.

About

MyCycle is a private menstrual cycle tracker that helps you align your nutrition, exercise, and work with your body's natural phases

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages