Гайды

Как сделать PWA — превратить сайт в приложение без магазинов

Иллюстрация: окно браузера, превращающееся в иконку на экране телефона

Смотри, что можно сделать за вечер: взять обычный сайт и научить его ставиться на телефон. Иконка на домашнем экране, запуск без адресной строки, ощущение настоящего приложения. Без App Store, без Google Play, без ревью и без 30% комиссии.

И вот что удивляет большинство: сервис-воркер для этого не нужен. В списке требований Chromium к установке его нет — там только манифест и иконки. Сервис-воркер отвечает за офлайн, а не за иконку. Половина людей бросает PWA на этапе «надо разбираться с воркерами», хотя первый рабочий результат достигается одним JSON-файлом.

Давай соберём по шагам.

1. Создай манифест

В корне сайта создай файл manifest.json. Это паспорт приложения — по нему браузер понимает, как показывать твой сайт после установки.

{
  "name": "Трекер воды",
  "short_name": "Вода",
  "start_url": "/",
  "display": "standalone",
  "background_color": "#141416",
  "theme_color": "#D4A373",
  "icons": [
    { "src": "/icon-192.png", "sizes": "192x192", "type": "image/png" },
    { "src": "/icon-512.png", "sizes": "512x512", "type": "image/png" }
  ]
}

Что обязательно для установки в Chromium-браузерах:

  • name или short_name — подпись под иконкой;
  • icons — обязательно должны быть иконки 192×192 и 512×512;
  • start_url — что открывать при запуске;
  • display — режим окна. standalone убирает адресную строку, и приложение перестаёт выглядеть как вкладка;
  • prefer_related_applications — либо false, либо его вообще нет.

Пропустишь одну из иконок — предложения установить не будет. Это самая частая причина «я всё сделал, а кнопки нет».

2. Подключи манифест к странице

Одна строка в <head> каждой страницы:

<link rel="manifest" href="/manifest.json" />

Проверь путь: файл должен реально отдаваться по этому адресу. Открой твойсайт.ру/manifest.json в браузере — должен показаться JSON, а не 404.

3. Нарисуй две иконки

Нужны два PNG: 192×192 и 512×512 пикселей. Не SVG, не JPG — именно PNG в этих размерах.

Не усложняй: возьми квадрат фирменного цвета и крупный символ или букву по центру. Мелкие детали на иконке 192 пикселя всё равно не разглядеть.

Положи файлы туда, куда указывает src в манифесте.

4. Проверь HTTPS

PWA работает только на защищённом соединении — HTTPS обязателен. Без него не установится и сервис-воркер не запустится.

Хорошая новость: localhost считается защищённым контекстом. Локально всё тестируется без всяких сертификатов, а на боевом хостинге HTTPS обычно уже включён по умолчанию — про деплой мы разбирали отдельно.

5. Проверь установку

Открой сайт в Chrome на телефоне или в десктопном Chrome. В адресной строке (десктоп) или в меню браузера (мобильный) появится пункт «Установить приложение».

Если не появился — открой DevTools → вкладка Application → раздел Manifest. Там браузер прямым текстом напишет, чего не хватает.

Уже на этом шаге у тебя рабочее PWA. Дальше — про офлайн.

6. Добавь сервис-воркер для офлайна

Сервис-воркер — это скрипт, который живёт между твоим сайтом и сетью и может отвечать на запросы из кэша. Именно он даёт работу без интернета.

Файл sw.js в корне:

const CACHE = "app-v1";
const ASSETS = ["/", "/index.html", "/style.css", "/app.js"];

self.addEventListener("install", (e) => {
  e.waitUntil(caches.open(CACHE).then((c) => c.addAll(ASSETS)));
});

self.addEventListener("fetch", (e) => {
  e.respondWith(caches.match(e.request).then((r) => r || fetch(e.request)));
});

И регистрация — в основном скрипте страницы:

if ("serviceWorker" in navigator) {
  navigator.serviceWorker.register("/sw.js");
}

Логика простая: при установке складываем файлы в кэш, при каждом запросе сначала смотрим в кэш и только потом идём в сеть.

Одна деталь, которая сэкономит тебе час отладки: меняй app-v1 на app-v2 при каждом обновлении файлов. Иначе браузер будет упорно отдавать старую версию из кэша, и ты решишь, что деплой не сработал.

Что получится

Открываешь сайт с телефона → «Добавить на главный экран» → на рабочем столе появляется иконка. Тапаешь — приложение открывается на весь экран, без адресной строки и вкладок. В авиарежиме закэшированные страницы всё равно открываются.

Со стороны это неотличимо от нативного приложения. Разница в том, что обновление выкатывается деплоем за секунды, а не проходит ревью три дня.

Где PWA не поставится

Тут важно не питать иллюзий, поддержка неровная:

  • Android — ставится везде: Chrome, Firefox, Edge, Opera, Samsung Internet.
  • iOS 16.4 и новее — через меню «Поделиться» в Safari, Chrome, Edge, Firefox и Orion. На iOS 16.3 и старше — только через Safari.
  • Десктопные Chromium-браузеры — ставятся на всех поддерживаемых ОС.
  • Safari на macOS Sonoma (Safari 17) и новее — «Добавить в Dock», причём работает даже без манифеста.
  • Firefox на десктопе — не ставит PWA вообще. Манифест ему не поможет.

Так что «установите наше приложение» на десктопе стоит показывать не всем подряд.

Нужен ли фреймворк, чтобы сделать PWA?

Нет. PWA — это не технология и не библиотека, а набор возможностей браузера. Статичный сайт из трёх файлов становится PWA ровно так же, как приложение на React. Фреймворки лишь автоматизируют генерацию манифеста и воркера.

Можно ли выложить PWA в магазины приложений?

В Google Play — да, через обёртку (Trusted Web Activity), это рабочая практика. В App Store с голым PWA не пустят: Apple требует нативную обёртку. Если магазины принципиальны — стоит сначала честно решить, нужно ли тебе приложение или хватит сайта. И отдельно проверь, что сайт нормально выглядит на мобильном: PWA не чинит вёрстку, оно её только оборачивает.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →