Flutter Web даёт команде одну модель отрисовки на каждый экран, и поэтому он хорош для приложения. Эта же модель превращает публичную страницу в canvas, а в canvas роботу нечего читать. HydraLine ставит острова интерактивности поверх настоящего HTML, и то, как именно, решили пять пунктов.
Код: HydraLine, лицензия MIT.
Dart 3.9, Flutter 3.35, три пакета: hydraline, hydraline_server, hydraline_flutter. 486 модульных и виджет-тестов, 26 сквозных проверок в живом Chrome.
Решение 1: добавлять к приложению, а не заменять его
Библиотека не забирает main(), не заменяет MaterialApp и не навязывает роутер. Маршрут переезжает в режим document или в режим hybrid с островами Flutter внутри HTML, а остальное приложение продолжает работать.
Переезд, который можно делать по одному маршруту, переживает дедлайн. Переписывание фронтенда это проект, а проект такого размера отменяют на втором месяце.
Решение 2: сборщик не видит User-Agent
Дешёвый способ сделать сайт на Flutter индексируемым это определять робота и отдавать ему готовый HTML. Он работает, и он же клоакинг: два разных документа по одному адресу, и поисковик, который это обнаружит, считает санкцией весь домен.
Здесь User-Agent до сборщиков страниц не доходит. Робот и человек получают побайтно одинаковое тело, а тест в CI сравнивает два ответа. Это структурное обещание, а не правило, которое кто-то должен помнить.
Решение 3: три уровня, выбор на маршрут
L0 это статический HTML без JavaScript: details и summary, ссылки :target, ленивые картинки. L1 добавляет обычный JavaScript и острова на HTMX около 8–14 КБ для вкладок, форм и поиска. L2 грузит движок Flutter для острова, которому он нужен, по триггеру, а не при загрузке страницы.
Уровни существуют потому, что «интерактивный» это не одно требование. Статья это L0, форма с фильтром это L1, конфигуратор с 3D это L2. Одинаковый подход ко всем трём и даёт бандл на два мегабайта ради страницы текста.
Решение 4: одно дерево документа, SSR и SSG
Одно и то же дерево DocumentNode уходит потоком с сервера на Dart или собирается в статический dist/. Маркетинговый сайт бывает статическим, приложение обслуживается сервером, и описание страницы у них одно.
Два пути отрисовки из одной модели это единственный вариант, которому я верю. Две написанные руками реализации одной страницы расходятся за месяц, и расхождение проявляется как canonical, который не совпадает с картой сайта.
Решение 5: занять место до прихода острова
Остров объявляет размер, и заглушка держит ровно эту площадь через Declarative Shadow DOM. Сдвиг вёрстки держится около нуля, а сквозной тест в живом Chrome это измеряет, а не предполагает.
Это самое незаметное решение, и человек чувствует его сильнее всего. Страница, которая прыгает, когда читатель на середине предложения, забирает предложение, и измерение это единственное, что держит такое обещание честным.
Чего пакет не делает
Он не считает SEO-баллы, не обещает позиций и не трогает скорость страницы сверх того, что отрисовывает. Он также не обходит корень сайта в поисках страниц: карта строится из зарегистрированных маршрутов, и незарегистрированная страница в карту не попадает.
SafeUrl отклоняет javascript: и data: при создании значения, экранирование работает по контексту, sanitizeHtml() снимает встроенные обработчики, скрипты рантайма несут integrity и crossorigin. За этим стоит фаззинг на миллионе входов, потому что санитайзер с хорошей репутацией это не санитайзер с тестом.
Чему это учит
У браузера есть рабочая модель отрисовки и рабочая модель доступности. Фреймворк, который заменяет обе, должен их пересобрать, и пересборка это место, где страница становится невидимой для всего, что не браузер.
Тот же довод в прогрессивном улучшении, только приложенный к движку отрисовки, а не к форме. Та же логика в заметке загрузка файла в форму, где нативный input остаётся источником истины, а виджет его одевает.
HydraLine выходит под MIT и лежит на pub.dev, три пакета описаны отдельно.