🌸 Femora - For Every Stage of Her Life

Femora is an AI-powered menstrual cycle tracking application designed to support women through every stage of their reproductive health journey - from adolescence to menopause.

✨ Features

📅 Interactive Calendar

• Visual Cycle Tracking: Beautiful calendar interface with color-coded cycle phases
• Period Logging: Track period start and end dates with flow intensity
• Symptom Tracking: Log daily symptoms, mood, energy levels, and more
• Sexual Activity Logging: Record sexual activity with contraceptive information
• Pill/Contraceptive Reminders: Track contraceptive usage

🔮 Cycle Predictions

• Ovulation Prediction: Automatically calculates ovulation dates based on period history
• Fertile Window: Identifies the best time to get pregnant
• Safe Days: Shows safe days for natural family planning
• Cycle Phases: Displays current phase (Menstrual, Follicular, Ovulatory, Luteal)
• Next Period Forecast: Predicts upcoming period dates

🤖 AI-Powered Insights

• Personalized health insights based on cycle phase and symptoms
• Diet recommendations tailored to your cycle
• Hormonal pattern analysis
• Symptom correlation detection

🥗 AI-Driven Diet Plan

• Phase-specific nutrition recommendations
• Local food suggestions (Kenyan cuisine)
• Hydration tracking
• Shopping list generation

💊 Contraceptive Management

• Track different contraceptive methods
• Reminder system for pills and appointments
• Side effects monitoring
• Pregnancy risk assessment

🌡️ Menopause Companion

• Track perimenopause and menopause symptoms
• Hot flash monitoring
• Sleep and mood tracking
• Physical symptom logging

📊 Lifetime Health Record

• Complete reproductive health history
• Period history visualization
• Pregnancy tracking
• Hormonal pattern analysis

🎨 Design

• Beautiful Purple Theme: Inspired by the Femora logo colors (#6d347b, #93478c, #bb86b4)
• Animated Landing Page: Logo blossoms with petals bursting and woman emerging from flower
• Modern UI/UX: Clean, intuitive interface with smooth animations
• Responsive Design: Works seamlessly on desktop, tablet, and mobile devices

🚀 Getting Started

Prerequisites

• A modern web browser (Chrome, Firefox, Safari, Edge)
• No additional dependencies required - runs entirely in the browser

Installation

1. Clone the repository:

git clone https://github.com/LABOSO123/Femora.git
cd Femora

2. Open index.html in your web browser:

# On macOS/Linux
open index.html

# On Windows
start index.html

# Or simply double-click the file

3. That's it! The app runs entirely client-side with no server required.

📁 Project Structure

Femora/
├── index.html              # Main HTML file
├── css/
│   ├── style.css          # Main stylesheet
│   └── components.css     # Component-specific styles
├── js/
│   ├── main.js           # Main application controller
│   ├── cycle-tracker.js  # Cycle tracking logic
│   ├── calendar.js       # Calendar component and predictions
│   ├── diet-planner.js   # Diet planning functionality
│   ├── contraceptive-tracker.js # Contraceptive tracking
│   ├── menopause-tracker.js     # Menopause tracking
│   └── health-record.js   # Health record management
├── Femora logo.png        # Application logo
├── package.json          # Project metadata
└── README.md            # This file

💾 Data Storage

All data is stored locally in your browser using localStorage. Your information never leaves your device, ensuring complete privacy.

🎯 Usage

1. First Time: You'll see a beautiful animated landing page
2. Log Your Period: Click "Quick Log" → "Log Period" to start tracking
3. View Predictions: The calendar automatically calculates ovulation, fertile window, and safe days
4. Track Symptoms: Log daily symptoms, mood, and energy levels
5. Get Insights: Receive AI-powered health insights based on your data

🔒 Privacy

• All data is stored locally on your device
• No data is sent to external servers
• No account creation required
• Complete privacy and security

🛠️ Technologies Used

• HTML5: Structure and semantics
• CSS3: Styling with animations and gradients
• Vanilla JavaScript: No frameworks required
• LocalStorage API: Client-side data persistence

📝 License

This project is open source and available for personal and educational use.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📧 Contact

For questions or support, please open an issue on GitHub.

🙏 Acknowledgments

• Designed with women's health and wellness in mind
• Inspired by the need for accessible, private health tracking tools
• Built with care for every stage of her life

---

Femora - Empowering women through every stage of their reproductive health journey. 🌸