Содержание
  1. Визуальная правка кода и статичный макет
  2. Применимость к фреймворку: сверка с текущими docs
  3. Hosted продукт, открытый репозиторий и старые версии
  4. Контроль изменения: код и preview
  5. Pixel-perfect и production-ready: границы утверждений
  6. Текущая native beta: платформа и доступ
  7. Частые вопросы
Обзоры

Onlook: визуальные правки кода интерфейса

18 ноября 2026 · 8 минут чтения

Onlook: визуальные правки кода интерфейса — это редактор, в котором вы меняете элементы существующего приложения, а результат сразу ложится в код проекта. Официальный сайт называет его бесплатным local-first редактором для дизайнеров, работающих в коде. Документация уточняет: продукт находится в beta, а текущая native-версия рассчитана на Mac с Apple silicon.

Визуальная правка кода и статичный макет

Разница проявляется в том, что происходит после перетаскивания элемента. В графическом редакторе вы двигаете слой внутри файла макета, и разработчик потом вручную переносит решение в проект. В Onlook правка адресуется реальному приложению: документация проекта описывает, что редактор устанавливает нужные приложению зависимости и запускает его во фрейме на холсте, при любом размере экрана. На холсте отображается работающий интерфейс приложения.

Дальше правка превращается в изменение исходников. Документация формулирует это так: агент редактирует копию, а фрейм показывает результат. Предмет работы — последовательность действия на холсте, изменения файлов и обновления preview. Статичный макет живёт отдельно от репозитория; здесь холст и репозиторий связаны.

Практическое следствие для читателя: перед началом полезно понять, какой именно проект вы открываете. Onlook работает с уже существующей кодовой базой. Обзор Agent Verdict описывает продукт как визуальный редактор для кодовой базы, которая у вас уже есть, и советует использовать его рядом с генератором. Это чужая оценка позиционирования, и она помогает выбрать инструмент под задачу: у вас есть приложение, и вы хотите править его интерфейс.

Ещё одно следствие касается ожиданий. Визуальный редактор кода не отменяет необходимости читать diff. Он сокращает путь от решения до изменения, а проверка результата остаётся за вами. Ниже разберём, как устроен этот путь в текущей версии и что именно стоит проверять.

Применимость к фреймворку: сверка с текущими docs

Стек проекта — первый вопрос, который стоит закрыть до установки. Текущий вводный раздел документации Onlook описывает native-приложение и работу с папкой кода, но не перечисляет поддерживаемые фреймворки. Совместимость своего проекта уточните в актуальных требованиях или у команды продукта до основной работы.

Исторические описания дают другую картину. Обзор на Archestack относит к поддерживаемому стеку Next.js и Tailwind CSS и указывает, что остальные фреймворки числятся в планах. Обзор на Localhosted описывает продукт как self-hosted визуальный редактор для сайтов на Next.js и Tailwind CSS. Эти материалы описывают прежний открытый проект, и переносить их выводы на текущую native beta не стоит.

Порядок сверки:

  1. Откройте официальную документацию Onlook и найдите раздел о поддерживаемых проектах и стеке.
  2. Сопоставьте требования с вашим репозиторием: сборка, менеджер пакетов, структура каталогов.
  3. Проверьте, что проект запускается локально без Onlook. Это база, от которой редактор отталкивается.
  4. Зафиксируйте версию документации, по которой сверялись: справка обновляется, и через несколько месяцев вывод может отличаться.

Отдельно про ИИ-часть. Документация сообщает, что Onlook работает с Claude Code или ChatGPT на том плане, который у вас уже есть, и что сам Onlook не берёт плату за использование ИИ. Условия имеющегося плана Claude Code или ChatGPT и возможные расходы уточняйте у соответствующего провайдера. Формулировка «не берёт плату за ИИ» относится к Onlook; расходы по вашему плану провайдера она не отменяет.

Если ваш стек не упомянут в текущей справке, разумный шаг — проверить проект на отдельной тестовой копии. Так вы получите ответ по своему случаю.

Hosted продукт, открытый репозиторий и старые версии

Три сущности с похожими названиями легко перепутать, и путаница ведёт к неверным ожиданиям.

Что Как описывают источники Что это значит для выбора
Текущая native beta Документация Onlook: бесплатный local-first редактор, beta, Mac с Apple silicon Основной сценарий: локальная работа с проектом
Прежний открытый проект Localhosted: self-hosted редактор для Next.js и Tailwind CSS; Archestack: зависимость от hosted-сервисов Supabase, OpenRouter, CodeSandbox SDK, Freestyle Историческое описание архитектуры и стека
Отдельный hosted-продукт Localhosted упоминает отдельный облачный продукт Onlook Другой способ размещения и другая модель работы

Практический вывод: когда вы читаете про Onlook статью или обсуждение, сначала определите, о какой версии речь. Материалы про открытый репозиторий описывают self-host и набор внешних сервисов. Документация текущей beta описывает local-first редактор с отдельной рабочей копией. Это два разных набора условий.

Отдельная тонкость про локальность. Localhosted замечает, что локальный запуск не делает ИИ офлайн-инструментом. Локально живёт редактор и ваша копия проекта; обращения к модели уходят к провайдеру, чей план вы используете. Для команд это вопрос политики: какие части кода допустимо отправлять во внешнюю модель.

Смешивать условия размещения из разных описаний не стоит. Если вам нужен self-host по внутренним требованиям, ориентируйтесь на материалы о прежнем открытом проекте и проверяйте их актуальность. Если нужен текущий рабочий процесс с локальной копией и веткой — читайте справку native beta.

Контроль изменения: код и preview

Контроль строится на двух точках: что изменилось в файлах и как это выглядит в работающем приложении.

Документация описывает механику так. Onlook создаёт собственную копию проекта для работы, на собственной ветке. Агент правит копию, фрейм на холсте показывает результат. Когда правка готова, кнопка-пилюля в верхней панели открывает pull request, который команда может просмотреть.

Разберём на учебном примере. Это вымышленный вход, составленный для разбора; реальный интерфейс не запускался.

Задача: в карточке кружка увеличить отступ и поменять цвет кнопки. Текст, маршрут и поведение сохраняются.

  • Было: заголовок «Робототехника», подпись «По средам», кнопка «Подробнее» со старым цветом и прежним отступом.
  • Требуется: увеличенный отступ, новый цвет кнопки, тексты и переход без изменений.
  • Что проверить в diff: изменились только значения отступа и цвета; строки с текстом, ссылкой и обработчиком не тронуты.
  • Проверка на узком экране: карточка не разъезжается, кнопка остаётся кликабельной, подпись не переносится в нечитаемое состояние.

Промпт для такой правки, который можно вставить без изменений:

КОД
Ты работаешь с копией проекта на отдельной ветке. Задача: в карточке кружка [название компонента] увеличить внутренний отступ и изменить цвет кнопки «Подробнее» на [ваш цвет]. Требования: тексты «Робототехника» и «По средам» не менять, маршрут кнопки не менять, обработчики не трогать. Покажи, какие файлы и строки изменены, и перечисли, что осталось прежним.

Меняйте под себя название компонента и цвет. Вариации той же задачи: увеличить отступ только на мобильном брейкпоинте; поменять цвет кнопки при наведении; выровнять высоту кнопки с соседним элементом; добавить отступ между заголовком и подписью. Каждая вариация проверяется тем же способом: diff на предмет лишних изменений и preview на узком экране.

Pixel-perfect и production-ready: границы утверждений

Точное совпадение с макетом и готовность к выкладке проверяются на вашем проекте. Сравните результат с требованиями, посмотрите изменения файлов и выполните принятые в проекте проверки.

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

Разумный порядок приёмки правки:

  1. Прочитайте diff и убедитесь, что изменены только нужные строки.
  2. Откройте preview и сравните с макетом на том разрешении, для которого правка делалась.
  3. Проверьте узкий экран и промежуточные ширины.
  4. Прогоните существующие тесты проекта, если они есть.
  5. Отправьте pull request и дайте его просмотреть тому, кто отвечает за этот участок кода.

Пункт про pull request — часть описанного процесса: кнопка в верхней панели открывает запрос на просмотр. Дальше решение о слиянии принимает команда по своим правилам.

Формулировки «готово к продакшену» и «пиксель в пиксель» уместны после вашего теста на вашем проекте. До него корректнее говорить о правке, которая выглядит верно в preview и прошла чтение diff.

Текущая native beta: платформа и доступ

Документация Onlook сообщает, что продукт находится в beta, а текущая native-версия рассчитана на Mac с Apple silicon. Это ограничение платформы, и оно определяет, кто может работать с редактором прямо сейчас.

Для Windows, Linux и Mac на Intel в справке предусмотрен список ожидания. Практический смысл: если ваш рабочий компьютер не на Apple silicon, текущий native-сценарий вам недоступен, и стоит оформить ожидание, чтобы получить уведомление о расширении платформы.

Что это меняет в планировании:

  • Команда на смешанном парке техники получит доступ не у всех участников. Правки через Onlook будет вносить тот, у кого подходящий Mac.
  • Передача результата остаётся общей: ветка и pull request доступны всей команде независимо от платформы, на которой сделана правка.
  • Для оценки инструмента на Windows или Linux подойдёт чтение документации и материалов о прежнем открытом проекте, с оговоркой о версии.

Доступ из России проверьте отдельно по текущим условиям продукта и вашего плана у провайдера модели.

Отдельно про стоимость. Сайт называет редактор бесплатным. Документация уточняет, что Onlook не берёт плату за использование ИИ, а работа идёт через Claude Code или ChatGPT на вашем существующем плане. Его условия и возможные расходы проверяйте у провайдера.

Частые вопросы

Что такое Onlook простыми словами?
Бесплатный local-first редактор для дизайнеров, работающих в коде. Вы открываете существующий проект, правите интерфейс на холсте, а изменения попадают в исходники. Документация описывает запуск приложения во фрейме и передачу правки через pull request.

Onlook работает на Windows?
Текущая native beta рассчитана на Mac с Apple silicon. Для Windows, Linux и Mac на Intel в справке предусмотрен список ожидания. Оформите ожидание, чтобы получить уведомление о расширении платформы.

Нужен ли платный план для работы с ИИ?
Onlook не берёт плату за использование ИИ и работает через Claude Code или ChatGPT на вашем существующем плане. Условия этого плана и возможные расходы проверьте у выбранного провайдера.

Какие фреймворки поддерживаются?
Стек проекта сверяйте с текущей документацией Onlook. Материалы об открытом репозитории называют Next.js и Tailwind CSS, а остальные фреймворки относят к планам развития. Эти сведения описывают прежнюю версию проекта.

Как передать правку команде?
Onlook создаёт собственную копию проекта на отдельной ветке. Кнопка-пилюля в верхней панели открывает pull request, который команда просматривает. Дальше решение о слиянии принимается по правилам вашего репозитория.

Читайте также

3 материала