Dev handoff
Превращает готовый HTML-макет/прототип в передаваемый пакет: токены, инвентарь компонентов, состояния, копирайт.
Структура пакета
handoff/
README.md ← обзор: что это, как открыть, ссылки
tokens.css ← извлечённые CSS-переменные (или скопированные)
tokens.json ← те же токены как JSON для дизайн-инструментов
components.md ← инвентарь компонентов с размерами и состояниями
copy.md ← все тексты из макета
screens/ ← PNG каждого ключевого экрана
source/ ← исходные HTML/CSS/JS
Алгоритм
- Прочитай исходный HTML. Найди все CSS-переменные в
:root — это твоя база токенов. Сохрани в tokens.css.
- Сделай из них JSON для совместимости с Style Dictionary / Tokens Studio:
{ "color": { "primary": { "value": "#D97757" } } }
- Инвентарь компонентов. Пройди по разметке, выпиши уникальные блоки (кнопки, карточки, инпуты). Для каждого:
- Размеры (width/height, padding, gap).
- Радиус, тень, бордер.
- Состояния, которые есть в коде (hover, focus, disabled). Если каких-то нет — отметь как «to be defined».
- Копирайт. Собери все видимые тексты в
copy.md с привязкой к экрану. Это полезно для перевода и редактуры.
- Скриншоты экранов. Через Playwright (см.
export-png) сними каждый ключевой стейт.
- README.md в корне handoff: ссылки на оригинал, как запустить локально, на каких разрешениях тестировалось, какие фичи не реализованы.
Шаблон components.md
# Components
## Button — primary
- **Где:** Header, Onboarding step 2
- **Размеры:** padding 12px 20px, border-radius 8px, min-height 44px
- **Цвета:** bg `var(--color-primary)`, text `#fff`
- **Шрифт:** 14px / 600 / -0.01em
- **Состояния:**
- default: `var(--color-primary)`
- hover: `oklch(from var(--color-primary) calc(l - 0.05) c h)`
- active: `oklch(from var(--color-primary) calc(l - 0.1) c h)`
- disabled: opacity 0.4, cursor not-allowed
- focus: outline 2px var(--color-primary), offset 2px
## Card
...
Шаблон tokens.json
{
"color": {
"bg": { "value": "#FAF9F6" },
"fg": { "value": "#111111" },
"primary": { "value": "#D97757" }
},
"font": {
"display": { "value": "Helvetica Neue, sans-serif" },
"body": { "value": "Helvetica Neue, sans-serif" }
},
"radius": {
"sm": { "value": "4px" },
"md": { "value": "8px" },
"lg": { "value": "16px" }
},
"spacing": {
"1": { "value": "4px" }, "2": { "value": "8px" },
"3": { "value": "12px" }, "4": { "value": "16px" },
"6": { "value": "24px" }, "8": { "value": "32px" }
}
}
Что добавить, если попросят углублённый handoff
- Storybook stub. Каждый компонент как
.stories.tsx с props и controls.
- Spec-листы: PDF с разметкой расстояний и подписями (легко делать через
export-pdf поверх макета с overlay-сеткой).
- Анимации: список переходов с длительностью и easing. Например:
transition: opacity 200ms cubic-bezier(0.4, 0, 0.2, 1).
- Адаптивность: breakpoints + что меняется на каждом.
Чего не делать
- Не выгружай как handoff макет, в котором ещё всё в
inline-style и магических числах. Сначала вынеси в переменные.
- Не пиши «hover: чуть темнее» — давай конкретное значение или формулу через
oklch(from ...).
- Не плоди
tokens.unused.json. Включай только то, что реально используется в макете.
1---2name: dev-handoff3description: "Handoff-пакет разработчику из готового HTML: токены, компоненты, README. Триггеры: «пакет для разраба», «передать разработчику», «хендофф»."4metadata:5 source: https://skillmd.com/skills/jhamidun/dev-handoff6---78# Dev handoff910Превращает готовый HTML-макет/прототип в передаваемый пакет: токены, инвентарь компонентов, состояния, копирайт.1112## Структура пакета1314```15handoff/16 README.md ← обзор: что это, как открыть, ссылки17 tokens.css ← извлечённые CSS-переменные (или скопированные)18 tokens.json ← те же токены как JSON для дизайн-инструментов19 components.md ← инвентарь компонентов с размерами и состояниями20 copy.md ← все тексты из макета21 screens/ ← PNG каждого ключевого экрана22 source/ ← исходные HTML/CSS/JS23```2425## Алгоритм26271. **Прочитай исходный HTML.** Найди все CSS-переменные в `:root` — это твоя база токенов. Сохрани в `tokens.css`.282. **Сделай из них JSON** для совместимости с Style Dictionary / Tokens Studio:29 ```json30 { "color": { "primary": { "value": "#D97757" } } }31 ```323. **Инвентарь компонентов.** Пройди по разметке, выпиши уникальные блоки (кнопки, карточки, инпуты). Для каждого:33 - Размеры (width/height, padding, gap).34 - Радиус, тень, бордер.35 - Состояния, которые есть в коде (hover, focus, disabled). Если каких-то нет — отметь как «to be defined».364. **Копирайт.** Собери все видимые тексты в `copy.md` с привязкой к экрану. Это полезно для перевода и редактуры.375. **Скриншоты экранов.** Через Playwright (см. `export-png`) сними каждый ключевой стейт.386. **README.md** в корне handoff: ссылки на оригинал, как запустить локально, на каких разрешениях тестировалось, какие фичи не реализованы.3940## Шаблон components.md4142```md43# Components4445## Button — primary46- **Где:** Header, Onboarding step 247- **Размеры:** padding 12px 20px, border-radius 8px, min-height 44px48- **Цвета:** bg `var(--color-primary)`, text `#fff`49- **Шрифт:** 14px / 600 / -0.01em50- **Состояния:**51 - default: `var(--color-primary)`52 - hover: `oklch(from var(--color-primary) calc(l - 0.05) c h)`53 - active: `oklch(from var(--color-primary) calc(l - 0.1) c h)`54 - disabled: opacity 0.4, cursor not-allowed55 - focus: outline 2px var(--color-primary), offset 2px5657## Card58...59```6061## Шаблон tokens.json6263```json64{65 "color": {66 "bg": { "value": "#FAF9F6" },67 "fg": { "value": "#111111" },68 "primary": { "value": "#D97757" }69 },70 "font": {71 "display": { "value": "Helvetica Neue, sans-serif" },72 "body": { "value": "Helvetica Neue, sans-serif" }73 },74 "radius": {75 "sm": { "value": "4px" },76 "md": { "value": "8px" },77 "lg": { "value": "16px" }78 },79 "spacing": {80 "1": { "value": "4px" }, "2": { "value": "8px" },81 "3": { "value": "12px" }, "4": { "value": "16px" },82 "6": { "value": "24px" }, "8": { "value": "32px" }83 }84}85```8687## Что добавить, если попросят углублённый handoff8889- **Storybook stub.** Каждый компонент как `.stories.tsx` с props и controls.90- **Spec-листы:** PDF с разметкой расстояний и подписями (легко делать через `export-pdf` поверх макета с overlay-сеткой).91- **Анимации:** список переходов с длительностью и easing. Например: `transition: opacity 200ms cubic-bezier(0.4, 0, 0.2, 1)`.92- **Адаптивность:** breakpoints + что меняется на каждом.9394## Чего не делать9596- Не выгружай как handoff макет, в котором ещё всё в `inline-style` и магических числах. Сначала вынеси в переменные.97- Не пиши «hover: чуть темнее» — давай конкретное значение или формулу через `oklch(from ...)`.98- Не плоди `tokens.unused.json`. Включай только то, что реально используется в макете.