Telegram-iOS icon indicating copy to clipboard operation
Telegram-iOS copied to clipboard

Home screen status detection always returns "unknown" in Telegram iOS Mini Apps

Open socaseinpoint opened this issue 8 months ago • 0 comments

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

socaseinpoint avatar Apr 03 '25 18:04 socaseinpoint