BloomHer is a beautifully designed, production-ready Android app template targeting women aged 30–55 who are navigating perimenopause and menopause. Built entirely with modern Android technologies, it serves as a complete starting point for a wellness or health companion app.

The app features a premium UI with soft pastel gradients (lavender, rose, peach, sage), animated transitions, rounded cards, and a polished bottom navigation bar — ready to impress users from the first launch.

10 Complete Screens Included:
• Splash Screen — Spring-physics animated logo with gradient background
• Onboarding (5 steps) — Personalization flow with progress bar and DataStore persistence
• Home Dashboard — Animated wellness score ring, mood logger, water tracker, daily AI tip
• Symptom Tracker — 7 color-coded sliders, Canvas-drawn 7-day bar chart, calendar view
• AI Health Insights — Weekly stats summary, 4 gradient insight cards with ViewModel
• Daily Wellness Plan — 5 expandable sections with checkboxes and progress tracking
• Community Feed — Post feed, category filters, expert badges, FAB to compose
• Education Hub — Hero featured card, category chips, article list with mock data
• AI Chat Assistant — Chat bubbles, animated typing indicator, suggested question chips
• Subscription Paywall — Feature checklist, plan selector (monthly/annual), free trial CTA

Architecture & Tech Stack:
• Kotlin 2.0.21 + Jetpack Compose + Material3
• Single Activity with Compose Navigation
• MVVM with ViewModels and StateFlow
• DataStore Preferences for persistent onboarding state
• Clean package structure: ui / viewmodel / data / navigation
• No third-party chart library — Canvas-based custom chart included
• GitHub Actions CI workflow included (produces APK artifact automatically)

• 10 fully coded screens — ready to run
• Jetpack Compose + Material3 (latest Compose BOM 2024.11)
• MVVM architecture with ViewModels and StateFlow
• Animated splash screen with spring physics
• 5-step onboarding with DataStore persistence
• Animated wellness score ring (Canvas)
• Custom Canvas bar chart — no external library
• Typing indicator animation (InfiniteTransition)
• Subscription paywall screen with plan toggle
• Bottom navigation bar (5 tabs)
• Full mock data layer included
• GitHub Actions CI workflow included
• Clean, well-structured package layout
• Kotlin 2.0.21 / AGP 8.6.1 / Gradle 8.10.2
• Targets Android 7.0+ (API 24–35)

• Android Studio Hedgehog (2023.1.1) or newer

• JDK 17

• Android SDK with API level 24 minimum / API 35 compile target
• Gradle 8.10.2 (wrapper included)
• Internet connection for initial Gradle dependency download
• No paid SDKs or API keys required — runs fully offline with mock data

1. Unzip the downloaded file
2. Open the project root folder in Android Studio
3. Wait for Gradle sync to complete (downloads ~200 MB on first run)
4. Connect an Android device (API 24+) or start an emulator
5. Click Run > Run 'app' or press Shift+F10
6. To build an APK: Run > Build > Build Bundle(s) / APK(s) > Build APK(s)

To replace mock data with a real backend, update the files in:
  app/src/main/java/com/bloomher/app/data/mock/MockData.kt
  and swap ViewModel mock calls with your API/repository layer.