A smart, compassionate period tracking mobile app built with React Native (Expo) that helps women track their menstrual health, manage menstrual cup alerts, and get personalized AI-powered health advice.
Akanksha Bursu
Install directly on your Android phone — no Play Store needed! Enable "Install from unknown sources" in your phone settings before installing.
Many women struggle to track their menstrual cycle accurately, manage menstrual cup usage safely, and get reliable health advice — all in one place. Generic period apps lack personalized AI support, real-time cup fill alerts, and emotional health tracking together.
Nyssa solves this by combining period tracking, menstrual cup reminders, calendar visualization, and an AI health assistant into a single, easy-to-use mobile app.
- Period Data Logging — Log your period start date, pain level (Smile → Cramping), frequency, and notes
- Menstrual Cup Alerts — Get smart reminders when it's time to empty your cup
- Calendar View — Visual calendar showing past period dates (red) and predicted upcoming dates (blue)
- AI Assistant (Nyssa) — Chat with an AI health advisor powered by Gemini 2.0 Flash for period and health questions
- Alert History — Track your alert history day by day
- Local Storage — All your data stays on your device, private and secure
When you open the app, you'll see:
- A circular progress ring showing your menstrual cup fill level
- Quick Action buttons for the 4 main features
Tap "Add Period Data" to log a new entry:
- Select the start date using the date picker
- Choose how often your period flows (Once / Twice / Three times / Four times / As needed)
- Select how you're feeling using emoji-based mood icons:
- 😊 Smile — No discomfort
- 😟 Moderate — Mild discomfort
- 😭 Painful — Significant pain
- 😵 Fatigued — Low energy
- 😫 Cramping — Severe cramps
- Enable or disable cup full reminders
- Add any notes or abnormalities you observed
- Tap "Add Data" to save
Tap "Calendar View" to see:
- Your past period dates highlighted in red
- Predicted next period dates highlighted in blue
- Navigate between months using the arrow buttons
- Tap any date to see logged data for that day
Tap "Cup Alerts" to view:
- A log of all your menstrual cup alert notifications
- Which alerts were acknowledged and when
Tap "AI Assistant" to chat with Nyssa:
- Ask questions about your period, symptoms, or health
- Get personalized advice based on your logged data
- Nyssa knows your recent period history and predicted dates
- Only answers period and health-related questions
- Example questions:
- "When is my next period expected?"
- "I have severe cramps — what can I do?"
- "Is it normal to have spotting between periods?"
- React Native with Expo (cross-platform iOS & Android)
- Expo Router — File-based navigation
- AsyncStorage — Local data persistence
- Expo Notifications — Menstrual cup fill alerts
- Gemini 2.0 Flash API — AI health assistant
- React Native SVG — Circular progress ring
- Linear Gradient — UI styling
-
Clone the repository:
git clone https://github.com/sweetylearner-max/Nyssa.git cd Nyssa -
Install dependencies:
yarn install
-
Add your Gemini API key in a
.envfile:GEMINI_API_KEY=your_api_key_here -
Start the app:
npx expo start
-
Scan the QR code with Expo Go app on your phone, or run on an emulator.
Nyssa/
├── app/
│ ├── home.tsx # Home screen with quick actions & cup progress
│ ├── aichat/ # Nyssa AI assistant chat screen
│ ├── calendar/ # Period calendar view
│ ├── history/ # Cup alert history
│ └── period/
│ └── add.tsx # Add period data form
├── utils/
│ ├── storage.ts # AsyncStorage data management
│ └── notifications.ts # Expo notification scheduling
├── assets/ # Images, fonts, sounds
└── components/ # Reusable UI components
Made with ❤️ by Akanksha Bursu