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 не стоит.
Порядок сверки:
- Откройте официальную документацию Onlook и найдите раздел о поддерживаемых проектах и стеке.
- Сопоставьте требования с вашим репозиторием: сборка, менеджер пакетов, структура каталогов.
- Проверьте, что проект запускается локально без Onlook. Это база, от которой редактор отталкивается.
- Зафиксируйте версию документации, по которой сверялись: справка обновляется, и через несколько месяцев вывод может отличаться.
Отдельно про ИИ-часть. Документация сообщает, что 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: границы утверждений
Точное совпадение с макетом и готовность к выкладке проверяются на вашем проекте. Сравните результат с требованиями, посмотрите изменения файлов и выполните принятые в проекте проверки.
Что можно утверждать по источникам: редактор запускает приложение во фрейме при любом размере экрана, а правки попадают в код. Что требует вашей проверки: совпадение с дизайн-макетом, поведение на реальных устройствах, доступность, производительность, корректность на всех поддерживаемых разрешениях.
Разумный порядок приёмки правки:
- Прочитайте diff и убедитесь, что изменены только нужные строки.
- Откройте preview и сравните с макетом на том разрешении, для которого правка делалась.
- Проверьте узкий экран и промежуточные ширины.
- Прогоните существующие тесты проекта, если они есть.
- Отправьте 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, который команда просматривает. Дальше решение о слиянии принимается по правилам вашего репозитория.
