screenmap — плагин
Плагин и GitHub Action показывают все экраны приложения на Expo, React Native или NativeScript и экраны, затронутые pull request.
- 252 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Action запускает приложение и CI-агента с секретами `EXPO_TOKEN` и ключом провайдера, а для форков нужен `pull_request`.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/screenmapОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Action запускает приложение и CI-агента с секретами `EXPO_TOKEN` и ключом провайдера, а для форков нужен `pull_request`.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
screenmap запускает мобильное приложение на симуляторе, снимает экраны и складывает их в карту `.scrmap`: снимки, маршруты, переходы между экранами и записанные пути нажатий. Плагин для Claude Code запускается командой `/screenmap`, а вариант `--static` обходится без симулятора. GitHub Action `aleqsio/screenmap@v1` в pull request по маршрутизатору и измененным файлам определяет затронутые экраны, снимает заново только их и публикует комментарий с «до и после» и рамками вокруг изменений. Записанные пути хранятся в репозитории и проигрываются без модели, агент подключается только к экранам без записи. Снимки лежат в ветке `screenmaps` вашего репозитория.
Для кого. Мобильным командам на Expo, React Native и NativeScript, где ревьюеры пропускают визуальную часть изменений в pull request.
Подходит, если
- Новый разработчик разбирается, какие вообще экраны есть в незнакомом приложении.
- В pull request сдвинули кнопку, и ревьюеру нужны снимки до и после.
- Дизайнеру отправляют карту всех экранов с записанными путями к ним.
- Путь к экрану сохраняют в репозитории и проигрывают в CI без модели.
- Карту команды обновляют при каждом пуше в основную ветку.
Не подходит, если
- Приложение нативное на Swift или Kotlin, без Expo, React Native и NativeScript.
- Нужна автоматическая проверка, которая блокирует слияние: screenmap только сообщает.
- Экраны регистрируются без адресов, и маршруты не читаются из файлов или карты навигации.
Пример запроса к агенту
Запусти /screenmap --static и покажи список экранов приложения с их маршрутами.Ограничения
Нужен читаемый маршрутизатор: `expo-router`, карта `react-navigation` или дерево страниц NativeScript. Экраны без адресов видны только через исследование агентом. Для iOS требуется macOS с симулятором, для Android эмулятор, в CI одна платформа на задачу. Записанные пути хранят отдельно для каждой платформы. На Linux распознавание текста идет через `tesseract` и находит меньше слов, чем Apple Vision. Для сборок через EAS нужен секрет `EXPO_TOKEN`, а CI-агент использует ключ выбранного провайдера в пределах бюджета запуска.
Как отключить. Удалите плагин через менеджер плагинов Claude Code и файл рабочего процесса с `aleqsio/screenmap@v1`. Каталог `.screenmap/out/` и ветку `screenmaps` удалите вручную.
Частые вопросы
Нужен ли симулятор?
Для полной карты да: iOS-симулятор на macOS или Android-эмулятор через `--platform android`. Режим `/screenmap --static` строит карту без симулятора.
Блокирует ли он слияние?
Нет. По замыслу он сообщает, а не проверяет, и решение остается за ревьюером.
Где хранятся снимки?
По README, в ветке `screenmaps` вашего репозитория, а Action работает в ваших GitHub Actions.
На каком событии запускать Action?
На `pull_request`, а не на `pull_request_target`: второе отдает форку токен записи и секреты.
Что нужно для Action?
Приложение с `expo-dev-client` и адресуемыми маршрутами, профиль EAS для сборки под симулятор (для NativeScript готовый `.app` или `.apk`) и ключ провайдера для CI-агента.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныПлагин Callstack показывает симуляторы и устройства рядом с чатом агента и дает ему управлять мобильным приложением.
Скилл для Claude Code создает мобильные приложения на Expo: онбординг, платная подписка, реклама AdMob, аналитика и локализация.
CLI для параллельной разработки React Native на macOS: облегченные симуляторы, порты Metro и учет устройств по агентам.
Форк opencode для мобильной разработки: агент запускает симулятор iOS или эмулятор Android и показывает устройство рядом
Скилл Эвана Бэкона учит агента добавлять в Expo-приложение виджеты, App Clip, расширения Safari и другие нативные цели Apple
Плагин и MCP-сервер дают агенту пометки к экрану iOS Simulator: элемент, экран, строки для поиска в коде и два снимка.
Коротко о README
Базовая карта основной ветки кэшируется, поэтому pull request снимает только свою сторону затронутых экранов. Комментарий показывает измененную область и ссылку в просмотрщик.