Home screen status detection always returns "unknown" in Telegram iOS Mini Apps
Checklist I am reporting an issue in existing functionality that does not work as intended
I've searched for existing GitHub issues
Description In a Telegram Mini App, the checkHomeScreenStatus() method from @telegram-apps/sdk-react always returns "unknown" on Telegram for iOS, even after proper initialization with init() and using HTTPS with the recommended headers.
This prevents developers from knowing whether the app has been added to the home screen on iOS devices.
The same logic works correctly on Telegram for Android, returning "added" or "not-added" as expected.
Expected Behavior On iOS, checkHomeScreenStatus() should return:
"added" if the Mini App is installed on the home screen
"not-added" if it is not installed
Actual Behavior It always returns "unknown" regardless of the actual home screen status.
Steps to Reproduce Create a Telegram Mini App using @telegram-apps/sdk-react
Call init() before using checkHomeScreenStatus()
Use this code:
ts Copy Edit if (checkHomeScreenStatus.isAvailable()) { const status = await checkHomeScreenStatus(); console.log(status); // Always logs "unknown" on iOS } Open the Mini App in Telegram for iOS
Observe console — status is always "unknown"
Screenshots and Videos Not applicable
Environment Device: iPhone 12 Pro iOS version: 18.3.2 App version: 11.9.0