# **Stack:** Flutter/Dart **Platforms:** iOS 14.0+, Android 9.0+ (API 24+) **Languages:** English, Spanish, German --- ## TASK Complete reskin of sound_generator project to pass App Store and Google Play moderation. App must be sufficiently different from original to avoid Guideline 4.3 rejection. --- ## FUNCTIONALITY ### PLAYER - Play/Stop buttons - Waveform visualization (change design from original) - Volume control - Timer/Scheduler (auto-off) - Favorites system (save favorite frequencies) --- ## SCREEN STRUCTURE ### Onboarding (5 screens) 1. Welcome screen 2. Features showcase 3. Paywall screen **Request 3 permissions in onboarding:** - Push notifications - App tracking (for analytics) - Request review (review prompt) ### Main window (5 screens/tabs) 1. Home (preset frequencies list) 2. Player (generator with visualization) 3. Favorites (saved) 4. Timer (schedule) --- ## LOCALIZATION **Languages:** English, Spanish, German **What to localize:** - All UI texts **Format:** - JSON files for each language (en.json, es.json, de.json) - Identical keys in all files **Client provides:** - en.json (English - base) - Spanish/German translations - we do ourselves --- ## DESIGN **Requirements:** - Completely new UI (differs from original minimum 70%) - New color scheme - New icons - New app icon (1024x1024) --- ## TECH STACK **Framework:** Flutter 3.19+ **Packages (required):** - sound_generator (base library) - in_app_purchase (subscriptions) - intl or easy_localization (localization) - shared_preferences (save favorites) - firebase_core, firebase_analytics (analytics) **State Management:** Provider or Riverpod --- ## ANALYTICS AND INFRASTRUCTURE ### Provided by client: **Accounts:** - GitHub Organization with Docker Compose - App Store Connect (iOS) - Google Play Console (Android) **Services:** - Firebase Analytics (analytics, crashes, FCM push) - Amplitude (product analytics, funnels, Session Replay) **Testing:** - Firebase Test Lab or BrowserStack - TestFlight Internal Testing --- ## DEVELOPMENT STAGES ### Stage 1: Version without permissions and In-App **Goal:** Pass moderation **Features:** - Onboarding (5 screens) WITHOUT permission requests - WITHOUT paywall (free app) - Localization (3 languages) - Firebase Analytics basic integration **Permissions:** NONE **Publishing:** App Store + Google Play (free app) --- ### Stage 2: Push notifications and actions **Add:** - Push notifications (Firebase FCM) - App tracking permission **Publishing:** Update v1.1 --- ### Stage 3: Monetization (IAP) **Add:** - Paywall screen - In-app purchases (weekly/yearly subscription) - 7-day trial - Restore purchases **Publishing:** Update v1.2 (monetization enabled) --- ## TESTING **Required:** - Unit tests (critical logic) - E2E tests (onboarding, purchases, player) - K6 load testing (1000+ users) - TestFlight Internal Testing (iOS) **All tests pass in CI/CD before release** --- ## DOCUMENTATION **Must provide:** **1. [README.md](http://readme.md/)** **2. API documentation** **3. Deployment and servers** --- ## SUPPORT **After publication:** - 1 month free bug fixes Acceptance criteria: Work is considered complete after: 1. All tests (Unit, E2E, K6) pass 2. TestFlight Internal Testing passed (no critical bugs) 3. App published in App Store and Google Play in 3 releases ---