Show platform-specific release notes in update notification #187

New issue

Open

opened 2025-10-16 02:49:35 +00:00 by qarqun · 0 comments

qarqun commented

2025-10-16 02:49:35 +00:00

(Migrated from github.com)

Description:
Currently, the app prompts users with a notification when a new release is available. However, if a release contains platform-specific changes (e.g., iOS-only features), users on both platforms see all release notes, which can be confusing or irrelevant.

Example:
The latest release notes for v1.2.5 include iOS-specific features (Liquid Glass Theme for iOS/iPadOS 26+), but Android users are also shown these notes, even though they don’t apply to them.

Current Release Notes (v1.2.5):
Android Phone:

GitHub Release Page:

Expected Behavior:

Android users should only see notes relevant to Android (e.g., general improvements, backend updates, and any Android-specific changes).
iOS users should only see notes relevant to iOS (e.g., general improvements, backend updates, and any iOS-specific changes).

In other words, both platforms should only show their own relevant notes, not all notes. The general/universal notes should appear for both, but platform-specific notes should only appear for the respective platform.

Proposed Solution:

Structure release notes by platform (e.g., using markdown sections or JSON fields).
Detect the user’s platform in the app (using Platform.OS in React Native).
Filter and display only relevant notes to the user.

Example Release Notes Format:

## v1.2.5

### All Platforms
- Major dependency updates across the project
- Optimized metadata screen rendering and responsiveness
- Various backend improvements for smoother operations
- Overall stability and performance improvements

### iOS
- Introduced Liquid Glass Theme for iOS/iPadOS 26 and above
  Devices running iOS/iPadOS 26 will now use the new Liquid Glass theme across the app
  Older iOS versions will automatically fall back to the default theme
- Improved iOS player performance

Implementation Suggestions:

Use a JSON structure for release notes, with platform keys:

{
  "version": "1.2.5",
  "notes": {
    "all": [
      "Major dependency updates across the project",
      "Optimized metadata screen rendering and responsiveness",
      "Various backend improvements for smoother operations",
      "Overall stability and performance improvements"
    ],
    "ios": [
      "Introduced Liquid Glass Theme for iOS/iPadOS 26 and above",
      "Devices running iOS/iPadOS 26 will now use the new Liquid Glass theme across the app",
      "Older iOS versions will automatically fall back to the default theme",
      "Improved iOS player performance"
    ]
  }
}

In the app, fetch the full release notes, then filter based on Platform.OS.

Thanks @tapframe !!

**Description:** Currently, the app prompts users with a notification when a new release is available. However, if a release contains platform-specific changes (e.g., iOS-only features), users on both platforms see all release notes, which can be confusing or irrelevant. **Example:** The latest release notes for v1.2.5 include iOS-specific features (Liquid Glass Theme for iOS/iPadOS 26+), but Android users are also shown these notes, even though they don’t apply to them. **Current Release Notes (v1.2.5):** _Android Phone:_ <img width="200" height="700" alt="Image" src="https://github.com/user-attachments/assets/ab691710-1273-4b6b-bae3-0ea9b06a9ce9" /> _GitHub Release Page:_ <img width="300" height="600" alt="Image" src="https://github.com/user-attachments/assets/648e1f26-2950-4435-a35f-93f8675d9648" /> **Expected Behavior:** - Android users should only see notes relevant to Android (e.g., general improvements, backend updates, and any Android-specific changes). - iOS users should only see notes relevant to iOS (e.g., general improvements, backend updates, and any iOS-specific changes). In other words, both platforms should only show their own relevant notes, not all notes. The general/universal notes should appear for both, but platform-specific notes should only appear for the respective platform. **Proposed Solution:** 1. Structure release notes by platform (e.g., using markdown sections or JSON fields). 2. Detect the user’s platform in the app (using Platform.OS in React Native). 3. Filter and display only relevant notes to the user. **Example Release Notes Format:** ``` ## v1.2.5 ### All Platforms - Major dependency updates across the project - Optimized metadata screen rendering and responsiveness - Various backend improvements for smoother operations - Overall stability and performance improvements ### iOS - Introduced Liquid Glass Theme for iOS/iPadOS 26 and above Devices running iOS/iPadOS 26 will now use the new Liquid Glass theme across the app Older iOS versions will automatically fall back to the default theme - Improved iOS player performance ``` **Implementation Suggestions:** - Use a JSON structure for release notes, with **platform** keys: ``` { "version": "1.2.5", "notes": { "all": [ "Major dependency updates across the project", "Optimized metadata screen rendering and responsiveness", "Various backend improvements for smoother operations", "Overall stability and performance improvements" ], "ios": [ "Introduced Liquid Glass Theme for iOS/iPadOS 26 and above", "Devices running iOS/iPadOS 26 will now use the new Liquid Glass theme across the app", "Older iOS versions will automatically fall back to the default theme", "Improved iOS player performance" ] } } ``` - In the app, fetch the full release notes, then filter based on Platform.OS. Thanks @tapframe !!