Открытие PWA для IOS

Реализация открытия PWA на iOS за deep-link из WhatsApp

1. Общая информация

Проект создан на платформе Lovable.

Приложение работает как PWA (Progressive Web App) и устанавливается пользователями на iPhone через Safari ("Добавить на экран домой").

Необходимо реализовать механизм, при котором:

Пользователь получает сообщение в WhatsApp

В сообщении содержится URL с конкретным маршрутом (например:

https://domain.com/order/123)

При нажатии на ссылку:

если PWA установлен — открывается именно PWA,

и сразу открывается страница, соответствующая URL

если PWA не установлен — открывается веб-версия в Safari

2. Функциональные требования

2.1 Deep Linking

Реализовать корректную обработку deep-link в PWA на iOS:

Поддержка открытия маршрута типа:

/order/:id

/client/:id

другие внутренние маршруты (SPA-навигация)

При открытии через Safari или WhatsApp:

если приложение установлено через Home Screen → открывается PWA

маршрут не теряется

страница не редиректится на главную

2.2 Поведение при установленном PWA

Если пользователь уже установил PWA:

Ссылка из WhatsApp должна:

открывать именно установленное приложение

сохранять маршрут

корректно инициализировать состояние (auth, данные, токены)

2.3 Поведение при неавторизованном пользователе

Если пользователь не залогинен:

После открытия deep-link:

открывается страница логина

после успешной авторизации — редирект на первичный маршрут

3. Технические требования

3.1 PWA конфигурация

Проверить и при необходимости реализовать:

Корректный manifest.json

start_url

scope

display: standalone

HTTPS обязательно

Корректная работа Service Worker

Отсутствие полных перезагрузок страниц (SPA)

3.2 iOS специфика

Учитывать особенности iOS:

PWA открывается в отдельном standalone-контексте

Необходимо обеспечить:

правильную обработку window.location

корректную инициализацию роутера

сохранение параметров URL

3.3 Маршрутизация

Если используется:

Next.js / React Router / другой SPA роутер —

необходимо гарантировать:

работу прямого открытия маршрута

работу при обновлении страницы

работу через deep-link

4. Пример сценария

Статус заказа изменяется

Система отправляет WhatsApp сообщение с URL:

Копировать код

https://domain.com/order/4582

Пользователь нажимает ссылку

Если PWA установлен:

открывается PWA

открывается страница заказа №4582

Если PWA не установлен:

открывается веб-версия

5. Ожидаемый результат

PWA корректно открывается с deep-link на iOS

Маршрут не теряется

Не происходит редирект на главную

Авторизация сохраняется

Поведение стабильное при повторном открытии

6. Желательно

Тестирование на реальном iPhone

Проверка открытия с:

WhatsApp

Safari

Telegram

Учет edge-cases:

приложение в фоне

приложение полностью закрыто

истек токен