# Adipometer Mobile App Roadmap and Publishing Checklist

## Current Status — 2026-07-07

| Phase | Status |
|-------|--------|
| Phase 0 — Scope and Launch Decisions | ⬜ In progress |
| Phase 1 — PWA Hardening | ✅ Done (PWA live) |
| Phase 2 — Native Project Bootstrap | 🔄 Android done · iOS pending |
| Phase 3 — Monetization Implementation | ⬜ Not started |
| Phase 4 — Legal and Compliance | ⬜ Not started |
| Phase 5 — Quality Assurance | ⬜ Not started |
| Phase 6 — Android Publishing | ⬜ Not started |
| Phase 7 — iOS Publishing | ⬜ Not started |

**Last action:** Cordova Android shell built, icons and splash configured, APK tested on physical device. Project lives at `adipometer/cordova-android/`.

---

## Objective
This document defines a practical roadmap to keep Adipometer running as a PWA while also publishing Android and iOS versions from the same product base.

## Product Strategy
- Keep one product core: the current web app (PWA) remains the main UI and business logic base.
- Use a native wrapper for app stores: Cordova is the recommended path.
- Keep platform-specific code minimal and isolated (ads, purchases, notifications, device APIs).
- Preserve flexibility: web/PWA, Android app, and iOS app should share the same feature set as much as possible.

## Recommended Technical Stack
- App wrapper: Cordova
- Ads: Google AdMob
- In-app purchases and entitlement sync: RevenueCat
- Analytics/crash monitoring: Firebase Analytics + Crashlytics (or equivalent)
- Consent management (GDPR/LGPD): native or web consent flow before ad initialization

## Delivery Phases

### Phase 0 - Scope and Launch Decisions
- Define MVP features for mobile release.
- Define what stays out of v1.
- Define monetization model:
- Free tier with ads.
- Premium purchase to remove ads.
- Define release KPIs:
- Install conversion.
- Day-1 and Day-7 retention.
- Premium conversion rate.

### Phase 1 - PWA Hardening (Base for Mobile Wrapper) ✅
- [x] Validate service worker update behavior.
- [x] Validate offline behavior in Android and iOS browsers.
- [x] Validate local database and migration behavior.
- [x] Validate icon and manifest quality.
- [x] Freeze launch candidate version.

### Phase 2 - Native Project Bootstrap 🔄
- [x] Initialize Cordova in the existing project.
- [x] Add Android platform in Windows environment.
- [ ] Add iOS platform on Mac mini.
- [x] Configure app IDs, versioning, and signing basics.
- [x] Configure app icons and splash assets for Android.
- [ ] Configure app icons and splash assets for iOS.

### Phase 3 - Monetization Implementation
- Integrate AdMob:
- Banner placement for low-friction screens.
- Interstitial placement at natural transition points.
- Integrate in-app purchase:
- Non-consumable product: Remove Ads.
- Restore purchases flow for iOS.
- Entitlement gate:
- If premium is active, disable all ad placements.
- Persist entitlement status securely.

### Phase 4 - Legal and Compliance
- Publish Privacy Policy at a stable public URL.
- Publish Terms of Use at a stable public URL.
- Prepare data collection inventory:
- Authentication data (if any).
- Device identifiers.
- Usage analytics.
- Purchase data.
- Complete store compliance forms:
- Google Play Data Safety.
- App Store Privacy Nutrition Labels.
- Add support and contact URLs.

### Phase 5 - Quality Assurance
- Run end-to-end tests for core flows.
- Test offline-first behavior with real devices.
- Test subscription/purchase lifecycle:
- First purchase.
- Failed purchase.
- Restore purchase.
- Reinstall app and entitlement recovery.
- Test ad lifecycle:
- Consent accepted.
- Consent denied.
- Premium users see no ads.
- Test performance on low-end Android devices.

### Phase 6 - Android Publishing
- Create and configure Google Play Console app.
- Configure signing and upload key.
- Build Android App Bundle (AAB).
- Upload internal testing release.
- Complete store listing assets and metadata.
- Submit for production review.

### Phase 7 - iOS Publishing (Mac mini)
- Configure Apple Developer certificates and profiles.
- Configure App Store Connect app and bundle ID.
- Upload build via Xcode Organizer.
- Configure in-app purchases in App Store Connect.
- Complete metadata, screenshots, and legal URLs.
- Submit for TestFlight, then App Review.

## Artifact Checklist

### Brand and UI Assets
- App icon source files (SVG and PNG master)
- Android adaptive icon layers (foreground/background)
- iOS app icon set
- Splash screen assets
- Store feature graphics (optional)

### Store Listing Assets
- Android screenshots by required device classes
- iOS screenshots for required iPhone sizes
- Short and long descriptions
- Keywords (iOS)
- Category and age rating

### Legal and Support
- Privacy Policy page
- Terms of Use page
- Support URL
- Contact email

### Monetization Assets
- Ad unit IDs (test and production)
- Product IDs for Remove Ads
- RevenueCat project configuration
- Pricing and regional strategy

### Release Operations
- Release checklist
- Rollback strategy
- Crash triage process
- Post-release monitoring dashboard

## Store Metadata Templates

### Suggested App Name
Adipometer - Fitness Assessment and Activity Prescription

### Suggested Short Description
Track workouts, assess fitness, and personalize activity plans.

### Suggested Long Description (starter)
Adipometer combines workout tracking with comprehensive physical fitness assessment. Log training sessions, monitor progress, evaluate body and health indicators, and follow personalized activity recommendations in one integrated app.

## Suggested v1 Feature Scope
- Workout management
- Progress reports
- Physical fitness assessment module
- Offline data access
- Export basic reports
- Free mode with ads
- One-time purchase to remove ads

## Suggested Post-v1 Backlog
- Cloud sync and account login
- Multi-device sync
- Coach/professional mode
- Data backup restore UX improvements
- Additional premium analytics

## Risk Register (Top Items)
- iOS review delays for monetization wording or metadata mismatch
- Privacy label inconsistency with implemented SDKs
- Entitlement mismatch between stores and app state
- Ad policy violations due to placement or frequency
- Offline sync conflicts if cloud features are added later

## Execution Plan (Practical)
- Week 1:
- Freeze MVP and legal artifacts.
- Cordova setup for Android and iOS.
- Week 2:
- Ads and in-app purchase integration.
- Internal QA and bug fixing.
- Week 3:
- Store assets finalization.
- Internal/beta testing and final compliance checks.
- Week 4:
- Submission to Google Play and App Store.
- Post-submission fixes and launch.

## Definition of Done
- Android app approved and published.
- iOS app approved and published.
- Privacy and Terms URLs active and correct.
- Purchase flow validated on both stores.
- Ads disabled correctly for premium users.
- Production monitoring enabled for crashes and key events.

## Notes for Cross-Platform Continuity
- Keep all business logic in shared web code where possible.
- Keep native plugin usage behind service abstractions.
- Keep environment configuration isolated (web, android, ios).
- Maintain one release notes file for all platforms.