128 lines
3.6 KiB
Markdown
128 lines
3.6 KiB
Markdown
# Christian Period Tracker
|
|
|
|
A faith-centered period and fertility tracking app for Christian women and their husbands.
|
|
|
|
## Features
|
|
|
|
### Wife's App (Primary)
|
|
|
|
- **Cycle Tracking** - Period logging, predictions, and phase identification
|
|
- **Symptom Logging** - Mood, energy, cramps, and more
|
|
- **Daily Devotionals** - Phase-specific scripture and reflections
|
|
- **NFP Support** - BBT, cervical mucus tracking (for married users)
|
|
- **Calendar View** - Color-coded cycle visualization
|
|
- **Private Data** - All data stored locally on device
|
|
|
|
### Husband's Companion App
|
|
|
|
- **Cycle Overview** - See where she is in her cycle
|
|
- **Support Tips** - Phase-specific ways to help
|
|
- **Scripture** - Verses for loving husbands
|
|
- **Learning Library** - Understanding her cycle, biblical manhood
|
|
|
|
## Marital Status Awareness
|
|
|
|
The app adapts content based on relationship status:
|
|
|
|
- **Single/Engaged**: Health tracking only, no intimacy/fertility content
|
|
- **Married**: Full features including NFP, fertility window, partner sharing
|
|
|
|
## Tech Stack
|
|
|
|
- **Framework**: Flutter 3.24+
|
|
- **State Management**: Riverpod
|
|
- **Local Database**: Hive (privacy-first, no cloud required)
|
|
- **UI**: Material 3 + Custom Design System
|
|
- **Fonts**: Outfit (UI), Lora (Scripture)
|
|
|
|
## Getting Started
|
|
|
|
### Prerequisites
|
|
|
|
- Flutter SDK 3.24+
|
|
- Dart 3.5+
|
|
|
|
### Installation
|
|
|
|
```bash
|
|
# Clone the repository
|
|
cd christian_period_tracker
|
|
|
|
# Install dependencies
|
|
flutter pub get
|
|
|
|
# Generate Hive adapters (if needed)
|
|
dart run build_runner build --delete-conflicting-outputs
|
|
|
|
# Run the app
|
|
flutter run
|
|
```bash
|
|
|
|
### Platforms
|
|
|
|
- ✅ iOS (iPhone + iPad)
|
|
- ✅ Android (Phone + Tablet)
|
|
- ✅ Web (Progressive Web App)
|
|
|
|
## Project Structure
|
|
|
|
```bash
|
|
lib/
|
|
├── main.dart # App entry point
|
|
├── theme/
|
|
│ └── app_theme.dart # Color palette, typography
|
|
├── models/
|
|
│ ├── user_profile.dart # User & relationship status
|
|
│ ├── cycle_entry.dart # Daily tracking data
|
|
│ └── scripture.dart # Scripture database
|
|
├── screens/
|
|
│ ├── splash_screen.dart # Animated splash
|
|
│ ├── onboarding/ # Welcome, name, status, cycle setup
|
|
│ ├── home/ # Dashboard with cycle ring
|
|
│ ├── calendar/ # Month view with phase markers
|
|
│ ├── log/ # Symptom & period logging
|
|
│ ├── devotional/ # Daily scripture & reflection
|
|
│ └── husband/ # Husband companion screens
|
|
└── widgets/
|
|
├── cycle_ring.dart # Animated progress ring
|
|
├── scripture_card.dart # Phase-colored verse display
|
|
├── quick_log_buttons.dart # Quick action buttons
|
|
└── tip_card.dart # Contextual tips
|
|
```bash
|
|
|
|
## Color Palettes
|
|
|
|
### Wife's App
|
|
|
|
| Color | Hex | Usage |
|
|
|-------|-----|-------|
|
|
| Blush Pink | `#F8E1E7` | Backgrounds, accents |
|
|
| Rose | `#E8A0B0` | Secondary actions |
|
|
| Sage Green | `#A8C5A8` | Primary, CTAs |
|
|
| Lavender | `#D4C4E8` | Tertiary, calm states |
|
|
| Cream | `#FDF8F5` | Scaffold background |
|
|
|
|
### Husband's App
|
|
|
|
| Color | Hex | Usage |
|
|
|-------|-----|-------|
|
|
| Navy Blue | `#2C3E50` | Primary |
|
|
| Steel Blue | `#5D7B93` | Secondary |
|
|
| Warm Cream | `#F5F0E8` | Background |
|
|
| Gold | `#C9A961` | Accents, scripture |
|
|
|
|
## Privacy
|
|
|
|
- **Local-first**: All data stored on device using Hive
|
|
- **No account required**: Works fully offline
|
|
- **Optional cloud sync**: Future feature with end-to-end encryption
|
|
- **Biometric lock**: Planned for sensitive data
|
|
|
|
## License
|
|
|
|
MIT
|
|
|
|
## Contributing
|
|
|
|
Contributions welcome! Please read the contribution guidelines first.
|