"Women's Health & Wellness Tracker"
🚀 Live Demo • Features • Installation • Tech Stack • Emotional Story • Contributing • License
"Some days just feel heavier than others…
Your energy dips, your body aches, and emotions run high — but the world keeps moving like nothing's changed."
That's the reality for so many women during their cycle. And sadly, it often goes unspoken.
MyCycleCare was born out of the need to feel understood. It's not just a tracker — it's your personal wellness companion. From logging painful cramps to celebrating better days, we're here to remind you: your feelings are valid, and your health matters.
With thoughtful features like mood journaling, symptom tracking, and personalized self-care tips, MyCycleCare empowers you to stay in tune with your body — gently, beautifully, and without judgment.
✨ Menstrual Cycle Tracker
⏳ Predict periods, log flow, pain, and more.
📝 Mood Journal
Track emotions and mental health with visual logs.
🌿 Wellness Assistant
Receive self-care tips and period-safe wellness advice.
❤️ Symptom Tracker
Log cramps, nausea, bloating, acne, and fatigue.
📊 Analytics Dashboard
Interactive graphs to uncover body patterns and rhythm.
🛡️ Private & Secure
Your data, your control — privacy is our priority.
- Node.js 18+ and npm
- MongoDB (local or MongoDB Atlas)
- Git
# 1. Clone the repository
git clone https://github.com/Jani-shiv/MyCycleCare.git
cd MyCycleCare
# 2. Install frontend dependencies
npm install --legacy-peer-deps
# 3. Install backend dependencies
cd server
npm install
cd ..Create server/.env file with the following:
# REQUIRED: JWT Secret for authentication tokens
JWT_SECRET=your-super-secret-jwt-key-change-this-in-production
# Database Connection (optional, uses in-memory if not provided)
MONGO_URI=mongodb://localhost:27017/mycyclecare
# Server Configuration
PORT=5000
NODE_ENV=development
⚠️ SECURITY WARNING: Never commit.envfiles to version control. Use strong, unique JWT secrets in production.
Create .env in project root if using external APIs:
# AI Services (Optional - for Wellness Assistant)
VITE_OPENAI_API_KEY=your-openai-key
VITE_ANTHROPIC_API_KEY=your-anthropic-key# Terminal 1: Start backend server
cd server
node index.js
# Terminal 2: Start frontend development server
npm run devThe application will be available at:
- Frontend: http://localhost:5173
- Backend API: http://localhost:5000
✅ Use the provided .env.example as a template
✅ Never hardcode secrets in source code
✅ Use strong passwords (8+ chars, upper/lower/number)
✅ JWT tokens expire after 1 hour for security
🔐 Use environment-specific secrets
🔐 Enable HTTPS/TLS encryption
🔐 Set NODE_ENV=production
🔐 Use secure database connections
🔐 Monitor rate limiting (5 auth requests per 15 minutes)
🔐 Review Helmet.js security headers
- React 18 with TypeScript
- Vite for blazing-fast development
- Zustand for state management
- React Router for navigation
- Framer Motion for animations
- Recharts for data visualization
- Node.js with Express
- MongoDB with Mongoose
- JWT for authentication
- bcryptjs for password hashing
- Helmet for security headers
- express-rate-limit for API protection
- 🔒 Helmet.js security headers
- 🚦 Rate limiting (100 req/15min, 5 auth req/15min)
- 🔑 JWT with 1-hour expiration
- ✅ Input validation with express-validator
- 🔐 Password requirements (8+ chars, upper/lower/number)
- 📏 Request body size limits (10MB)
MyCycleCare/
├── src/ # Frontend source code
│ ├── components/ # Reusable components
│ ├── pages/ # Page components
│ ├── services/ # API services
│ ├── store/ # Zustand state management
│ ├── types/ # TypeScript interfaces
│ └── utils/ # Utility functions
├── server/ # Backend source code
│ ├── models/ # MongoDB models
│ ├── routes/ # API routes
│ ├── middleware/ # Auth & validation
│ └── index.js # Server entry point
└── package.json # Dependencies
Manual testing guide available at: chrome_testing_guide.md in the brain artifacts directory.
✅ User registration with strong password
✅ User login/logout
✅ Cycle tracking (add/edit/delete)
✅ Mood journal entries
✅ Dashboard analytics
✅ Settings & preferences
✅ Authentication token expiration
We welcome contributions! Please follow these guidelines:
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Follow existing code style and TypeScript types
- Test your changes thoroughly
- Commit with clear messages (
git commit -m 'Add some AmazingFeature') - Push to your branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
Built with love to support women's health awareness and wellness. Thank you to all contributors and supporters of this project.
Made with 💜 for women's wellness