How mev297/tide works
Tide is an on-device SwiftUI period tracker. A user logs period starts in Today or Calendar; the app’s view model validates changes, updates cycle data, persists it, and refreshes reminders. Cycle calculations provide phase, timing, and history for the calendar, insights, and widget. The product also documents notification/widget quick logging, accidental-tap confirmation, late-cycle handling, and milestone celebrations. Storage and notification wiring are supported by excerpts; several view and widget connections rely on the SOURCE INDEX or README, so unsampled behavior is not expanded.
Main entry points: CycleViewModel.swift Cycle View Model · ContentView.swift Tab Navigation · HomeView.swift Today Screen · TideWidget.swift Home And Lock Widgets
Components 18
iPhone App
- App Startup
Tide/TideApp.swift - Tab Navigation
Tide/Views/ContentView.swift - Today Screen
Tide/Views/HomeView.swift - Calendar Screen
Tide/Views/CalendarView.swift - Insights Screen
Tide/Views/InsightsView.swift - Settings Screen
Tide/Views/SettingsView.swift - Visual Theme
Tide/Theme.swift - Cycle Wheel
Tide/Views/Components/CycleWheel.swift - Panda Mascot
Tide/Views/Components/PandaMascot.swift - Milestone Popup
Tide/Views/Components/MilestoneCelebration.swift
Cycle Domain
- Cycle View Model
Tide/ViewModels/CycleViewModel.swift - Cycle Calculations
Tide/Models/CycleData.swift - Phase Notes
Tide/Models/CyclePhase.swift - Shared Local Storage
Tide/Models/CycleStorage.swift
Reminders
- Reminder Scheduling
Tide/Services/NotificationManager.swift - iOS Notifications
Widget
- Home And Lock Widgets
TideWidget/TideWidget.swift
Other components
- User
Connections 33
- User → Tab Navigation: uses app
README.md - App Startup → Cycle View Model: creates
Tide/TideApp.swift - App Startup → Reminder Scheduling: configures
Tide/TideApp.swift - App Startup → Tab Navigation: shows
Tide/TideApp.swift - Tab Navigation → Today Screen: shows tab
Tide/Views/ContentView.swift - Tab Navigation → Calendar Screen: shows tab
Tide/Views/ContentView.swift - Tab Navigation → Insights Screen: shows tab
Tide/Views/ContentView.swift - Tab Navigation → Settings Screen: shows tab
Tide/Views/ContentView.swift - Tab Navigation → Cycle View Model: presents alerts
Tide/Views/ContentView.swift - Today Screen → Cycle View Model: logs period
Tide/Views/HomeView.swift - Today Screen → Cycle Wheel: renders
Tide/Views/HomeView.swift - Today Screen → Panda Mascot: renders
Tide/Views/HomeView.swift - Today Screen → Milestone Popup: shows celebration
Tide/Views/HomeView.swift - Calendar Screen → Cycle View Model: reads and edits
Tide/Views/CalendarView.swift - Insights Screen → Cycle View Model: reads trends
Tide/Views/InsightsView.swift - Settings Screen → Cycle View Model: updates settings
Tide/Views/SettingsView.swift - Cycle View Model → Cycle Calculations: updates and calculates
Tide/ViewModels/CycleViewModel.swift - Cycle View Model → Shared Local Storage: saves changes
Tide/ViewModels/CycleViewModel.swift - Cycle View Model → Reminder Scheduling: updates reminders
Tide/ViewModels/CycleViewModel.swift - Shared Local Storage → Cycle Calculations: loads and saves
Tide/Models/CycleStorage.swift - Cycle Calculations → Phase Notes: determines phase
Tide/Models/CycleData.swift - Today Screen → Visual Theme: styles screen
Tide/Views/HomeView.swift - Cycle Wheel → Visual Theme: uses colors
Tide/Views/Components/CycleWheel.swift - Panda Mascot → Phase Notes: reflects phase
Tide/Views/Components/PandaMascot.swift - Milestone Popup → Panda Mascot: renders
Tide/Views/Components/MilestoneCelebration.swift - Reminder Scheduling → iOS Notifications: schedules requests
Tide/Services/NotificationManager.swift - iOS Notifications → User: delivers reminders
README.md - Reminder Scheduling → Shared Local Storage: saves quick log
Tide/Services/NotificationManager.swift - User → Home And Lock Widgets: uses widget
README.md - Home And Lock Widgets → Shared Local Storage: reads shared data
TideWidget/TideWidget.swift - Home And Lock Widgets → Cycle Calculations: derives display state
TideWidget/TideWidget.swift - Home And Lock Widgets → Phase Notes: shows phase
TideWidget/TideWidget.swift - Shared Local Storage → Home And Lock Widgets: reloads timeline
Tide/Models/CycleStorage.swift