# Peachboom — Glute Growth Fitness App

Peachboom is a mobile fitness application for iOS and Android designed to help users build stronger, rounder glutes through science-backed workouts, interactive training sessions, and progress tracking. The app features an animated mascot called "Coach Peach" (a sheep) who demonstrates exercises and provides motivation.

## Core Value Proposition
Fun, effective glute growth training that users actually stick with. Combines progressive workout programs, real progress tracking, nutrition guidance, and gamification elements (streaks, confetti celebrations).

## Key Features

### Workouts & Training
- 4 progressive glute-focused workout programs with scalable difficulty
- Interactive workout player: tap-to-complete sets, built-in rest timer
- Exercise demonstrations via Coach Peach animated mascot (hip thrusts, squats, Romanian deadlifts, glute bridges, kickbacks, lateral raises, pigeon pose, happy baby, figure-four stretch)
- Confetti celebrations on session completion
- Session duration and completion rate tracking

### Progress Tracking
- Baseline measurements during onboarding (glutes required; hips and weight optional)
- Measurement logging with visual progress charts
- Personal best detection and growth milestone animations
- Daily workout streak tracking

### Nutrition
- Daily macro targets calculated per user
- 8+ expert nutrition tips specifically written for glute development
- Covers protein timing, calorie surplus for growth, recovery nutrition, sleep optimization

### Motivation & Engagement
- Daily workout streak counter with fire streak badges
- Referral system: unique invite codes, friend invites
- Premium subscription tier unlocking all programs and advanced routines
- In-app review prompts, calendar integration for workout scheduling

### Platform Support
- iOS (iPhone and iPad)
- Android phones and tablets
- Web (Flutter web build for marketing landing page)
- Firebase backend: Authentication (email + Google Sign-In), Cloud Firestore, Cloud Functions, Crashlytics, Analytics, Cloud Messaging, In-App Purchases

### Localization
Available in 6 languages: English, French, German, Spanish, Italian, Portuguese.

## Pricing
- Free tier: core workouts and basic features
- Premium subscription: monthly and yearly plans (premium_monthly, premium_yearly via Google Play / App Store IAP)
- Server-side purchase verification via Firebase Cloud Functions

## Technical Stack
- Flutter (Dart SDK 3.10+)
- Firebase (Auth, Firestore, Cloud Functions, Analytics, Crashlytics, Cloud Messaging)
- In-App Purchases (Google Play Billing + StoreKit)
- Provider state management
- go_router for navigation
- Local notifications with flutter_local_notifications
- Permission handling for notifications
- Share Plus for referral sharing
- URL Launcher for legal pages
- WebView for legal page display
- Image picker for progress photos

## Backend & Security
- Firestore security rules: owner-only access for /users/{uid} and subcollections
- Public read access limited to publicReferralCodes for invite system
- Account deletion via callable Cloud Function (deleteMyAccount) using Firebase Admin SDK — removes Auth user + all Firestore data
- Server-side premium verification (verifyPremiumPurchase) — client can no longer self-activate premium
- Referral code system with public mapping for invite validation

## Branding
- Brand color: #E8456A (pink)
- Icon: peachboom_icon.png (1024x1024 pink square)
- Wide logo: peachboom.png (with "oo" stylized as peaches)
- Mascot: Coach Peach (sheep / mouton, name: Peach)

## Contact & Legal
- Contact email: contact@peachboom.app
- Terms of Service (CGU): bilingual EN/FR
- Privacy Policy: bilingual EN/FR
- Account deletion page hosted on Firebase Hosting
- Legal hub: https://peachboom.web.app/

## Marketing
- App Store listing optimized for: "Peachboom - Glute Coach" with keywords: glute workout, glute coach, build glutes, hip thrust, glute growth, glute training, fitness tracker, coach peach, progress chart, women fitness
- Google Play listing optimized for: "Peachboom - Glute Growth Coach" with similar keyword set
- Screenshots and feature graphics localized for all 6 supported languages
- Landing page: https://peachboom.web.app/

## Target Audience
Primarily women interested in glute training, from beginners to intermediate level. Users looking for a fun, science-backed alternative to generic fitness apps, with emphasis on measurement-based progress and consistent habit building.