Источник истины переехал: Figma теперь документация

Кодовая база теперь источник истины, а Figma является документацией, которая её описывает. Именно этот переворот совершило всё больше продуктовых команд на протяжении 2026 года, и это не антифигмовская позиция. Это закономерный итог трёх вещей, созревших одновременно.

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

Что на самом деле означает «источник истины»

Источником истины не является «то, где дизайн красивее». Это артефакт, который побеждает, когда две версии расходятся. Если в файле Figma один радиус, а в задеплоенном компоненте другой, источником истины является тот, к которому вы подгоняете второй.

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

Проблема всегда была в шаге перевода. Дизайн-файл нельзя задеплоить. Код можно. Поэтому «Figma является источником истины» на самом деле означало «Figma является источником истины, пока инженер не перетолкует его», что является вежливым способом сказать: истина меняла владельца на каждой передаче, и никто не отвечал за разрыв.

Сдвиг: code-first с Figma в роли документации

Code-first переворачивает умолчание. Значения, компоненты и выпускаемый UI определяются в репозитории. Figma описывает эту систему, а не задаёт её.

Ничего из рабочего дня дизайнера здесь ухудшаться не должно. Вы по-прежнему проектируете в Figma. По-прежнему исследуете, ветвитесь, критикуете и прототипируете там. Меняется направление авторитета: репозиторий больше не гонится за файлом, файл ссылается на репозиторий.

Вот что принадлежит каждому слою после честного переворота.

Что сделало репозиторий источником истины

Три вещи созрели одновременно. Ни одна из них не означает «AI заменил дизайнеров». Все они представляют собой скучную инфраструктуру, которая наконец дозрела.

Токены переехали в код. Design tokens представляют собой сырые значения: цвет, отступы, радиус, типографическая шкала. С пайплайнами токенов, построенными на инструментах вроде Style Dictionary, эти значения определяются один раз в коде и синхронизируются на все платформы. С того момента, как канонический цвет живёт в репозитории и Figma читает его оттуда, репозиторий является источником для цвета. Остальные значения следуют за ним.

Дизайн и код связались. Собственный Dev Mode и Code Connect в Figma позволяют компоненту Figma указывать на реальный закодированный компонент в репозитории. Это та часть, которую люди обычно пропускают. Figma не сопротивляется этому сдвигу, она сама выпустила функцию, делающую код связующей целью.

Тем временем Storybook даёт закодированному компоненту живой дом, который можно видеть и тестировать, а shadcn/ui распространяет компоненты как реальный код, который вы копируете в свой репозиторий, а не перерисовываете как слой. Когда вопрос «какой правильный» наконец получает детерминированный ответ, ответом является код.

AI строит в репозитории, а не на холсте. Нынешнее поколение генерации UI читает и пишет код. Оно не читает ваши слои Figma и не пишет их обратно. Поэтому цикл сборки теперь начинается и заканчивается в репозитории, что незаметно делает репозиторий местом, где реально накапливается работа.

Для чего Figma теперь на самом деле

Для многого, и в основном для того, что дизайнерам нравится больше всего.

Figma по-прежнему владеет началом процесса: исследование, дивергенция, быстрые итерации, беспорядочная середина, где вы находите дизайн до того, как он существует. Код является ужасным местом для размышлений вслух. Figma создана для этого.

Она также владеет документацией. Флоу, состояния, крайние случаи, аннотации, «почему», прототип, который вы показываете пользователю. Репозиторий является источником истины, но репозиторий плохо подходит для объяснения дизайнерских решений клиенту. Файл делает это.

Честный контраргумент

Figma не умирает, и тот, кто продаёт вам этот заголовок, продаёт вам именно заголовок.

Три реальных ограничения делают Figma незаменимой:

• Код враждебен к раннему исследованию, поэтому дивергентная фаза по-прежнему принадлежит холсту.
• Не-инженерам нужно место, где они могут читать систему, а репозиторий для этого не подходит.
• Связывание работает только если человек поддерживает синхронизацию дизайна и закодированного компонента. Это дисциплина, а не умолчание.

Это репозиционирование. Место, где живёт истина, переехало. Место, где команды думают, не переехало. Воспринимайте «Figma является документацией» как уточнение ролей, а не приговор инструменту, и ваши дизайнеры будут кивать в знак согласия, а не окапываться.

Как запустить code-first систему дизайна, не потеряв команду

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

1. Сначала перенесите токены, больше ничего. Определите цвет, отступы, типографику и радиус в коде и синхронизируйте их. Пусть Figma потребляет эти значения, а не объявляет их. Это наименьшее изменение, делающее репозиторий авторитетным, и оно пока не касается ни одного компонента.

2. Свяжите ваши десять главных компонентов. Используйте Code Connect, чтобы указать наиболее используемые компоненты Figma на их закодированные аналоги, и дайте им живой дом в Storybook. Не пытайтесь охватить всё сразу. Десять компонентов, которые есть везде, несут большую часть расхождений.

3. Назовите источник вслух. Напишите одно предложение в документации вашей системы: «Когда файл и код расходятся, код прав». Неоднозначность и есть то, что начинает войну, а не само правило.

4. Держите дизайнеров выше по потоку, а не ниже. Дизайнеры должны владеть намерением, иерархией и направлением системы, работая впереди кода. Их нельзя сводить к разметке продакшна. Если code-first превращает ваших дизайнеров в QA, вы сделали это неправильно.

5. Сделайте синхронизацию чьей-то работой. Связь между дизайном и кодом не поддерживает себя сама. Назначьте ответственного. Устаревший маппинг Code Connect хуже, чем отсутствие маппинга, потому что он лжёт с уверенностью.

Кому стоит переключаться, а кому нет

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

Переключайтесь, если:

• У вас есть продакшн-приложение с библиотекой компонентов в коде
• Вы видите постоянное расхождение дизайна и сборки
• Ваши инженеры уже живут в Storybook или аналогичной среде

Репозиторий является тем местом, где ваша истина уже накапливается. Сделайте это официальным.

Подождите, если:

• Ваш результат в основном статические материалы, маркетинговые страницы или презентационные работы
• Ничто не реализуется как долговечная библиотека компонентов

Если нет кодовой базы, где могла бы жить истина, «code-first» — это лозунг, а не система. В таком случае Figma правильно остаётся вашим источником истины.

FAQ

Является ли Figma по-прежнему источником истины в 2026 году?

Для всё большего числа продуктовых команд ответ отрицательный. Репозиторий определяет токены и компоненты, а Figma документирует эту систему. Для команд без долговечной кодовой базы Figma как источник истины по-прежнему является правильной установкой.

Означает ли code-first, что дизайнеры перестают использовать Figma?

Нет. Дизайнеры по-прежнему исследуют, прототипируют и документируют в Figma. Меняется то, что канонические значения и «правильный» компонент живут в коде, а Figma ссылается на них, а не определяет их.

Какова роль Figma Code Connect здесь?

Code Connect позволяет компоненту Figma указывать на реальный закодированный компонент в репозитории. Это механизм, который даёт вопросу «какой правильный» детерминированный ответ, и он сигнализирует о том, что сама Figma рассматривает код как связующую цель.

Где вписываются design tokens?

Токены являются клином. Когда цвет, отступы и типографика определяются в коде через пайплайн вроде Style Dictionary и синхронизируются наружу, репозиторий становится источником для этих значений. Перенос токенов первым — это путь с наименьшим риском.

А как насчёт Storybook и shadcn/ui?

Оба делают код живым домом для компонентов. Storybook даёт закодированному компоненту видимый, тестируемый дом, а shadcn/ui распространяет компоненты как реальный код, который вы копируете в свой репозиторий, а не перерисовываете как слой. Именно на них указывают команды, когда говорят, что код является источником.

Вывод

Истина живёт в одном месте. Единственный реальный вопрос: выбрали ли вы это место намеренно или позволили ему принять значение по умолчанию.

Для всё большего числа команд в 2026 году репозиторий является этим местом: токены в коде, компоненты, связанные через Code Connect и Storybook, и цикл сборки, который начинается и заканчивается в кодовой базе. Figma не потеряла работу. Она получила более чёткую задачу: начало процесса и документирование системы.

Выбирайте источник истины осознанно, переносите авторитет по порядку и записывайте, кто побеждает, когда файл и код расходятся. Сделайте это, и code-first станет апгрейдом. Пропустите, получите войну на передаче с дополнительными шагами.