Как использовать VoltAgent/awesome-design-md для генерации UI
Пошаговый гайд: берёте DESIGN.md из коллекции, кладёте его в проект и запускаете coding‑agent, который генерирует соответствующий интерфейс.
Требования
- Имеется проект, в который можно добавить файлы
- Доступ к AI‑coding‑agent (например, через CLI или интеграцию в IDE)
- Интернет‑соединение для загрузки DESIGN.md‑файла
Подготовьте проект
Создайте (или откройте) директорию вашего проекта, где будет размещён сгенерированный UI. Убедитесь, что у вас есть доступ к терминалу и к AI‑coding‑agent.
mkdir my-project && cd my-projectСкачайте DESIGN.md из awesome-design-md
Выберите подходящий DESIGN.md‑файл из коллекции (например, систем Figma) и загрузите его в ваш проект. В этом примере используется файл из репозитория VoltAgent.
curl -L -o DESIGN.md "https://raw.githubusercontent.com/VoltAgent/awesome-design-md/main/design-systems/figma/design.md"Поместите DESIGN.md в проект
Убедитесь, что файл DESIGN.md находится в корневой папке проекта (или в нужной поддиректории), чтобы агент мог его прочитать.
# Файл уже загружен в предыдущем шаге, проверка:
ls -l DESIGN.mdЗапустите coding‑agent для генерации UI
Используйте CLI‑команду вашего AI‑coding‑agent, передав DESIGN.md как входной файл и укажите, в каком формате нужно сгенерировать код (например, React + Tailwind).
coding-agent generate ui --input DESIGN.md --framework react --style tailwind --output src/components/GeneratedUI.tsxПроверьте сгенерированный код
Откройте файл src/components/GeneratedUI.tsx и убедитесь, что структура, цвета, отступы и токены соответствуют дизайну из DESIGN.md. При необходимости отредактируйте файл вручную.
# Пример просмотра файла
cat src/components/GeneratedUI.tsx(Опционально) Синхронизация с Figma
Если дизайн хранится в Figma, экспортируйте токены или SVG‑элементы и замените их в сгенерированном коде, используя скрипт или плагин.
# Пример команды экспорта токенов из Figma (через API)
figma export tokens --api-key $FIGMA_API_KEY --output design-tokens.jsonКак использовать VoltAgent/awesome-design-md для генерации UI
Пошаговый гайд: берёте DESIGN.md из коллекции, кладёте его в проект и запускаете coding‑agent, который генерирует соответствующий интерфейс.
Предварительные требования
- Имеется проект, в который можно добавить файлы
- Доступ к AI‑coding‑agent (например, через CLI или интеграцию в IDE)
- Интернет‑соединение для загрузки DESIGN.md‑файла
Шаг 1: Подготовьте проект
Создайте (или откройте) директорию вашего проекта, где будет размещён сгенерированный UI. Убедитесь, что у вас есть доступ к терминалу и к AI‑coding‑agent.
mkdir my-project && cd my-project
Шаг 2: Скачайте DESIGN.md из awesome-design-md
Выберите подходящий DESIGN.md‑файл из коллекции (например, систем Figma) и загрузите его в ваш проект. В этом примере используется файл из репозитория VoltAgent.
curl -L -o DESIGN.md "https://raw.githubusercontent.com/VoltAgent/awesome-design-md/main/design-systems/figma/design.md"
Шаг 3: Поместите DESIGN.md в проект
Убедитесь, что файл DESIGN.md находится в корневой папке проекта (или в нужной поддиректории), чтобы агент мог его прочитать.
# Файл уже загружен в предыдущем шаге, проверка:
ls -l DESIGN.md
Шаг 4: Запустите coding‑agent для генерации UI
Используйте CLI‑команду вашего AI‑coding‑agent, передав DESIGN.md как входной файл и укажите, в каком формате нужно сгенерировать код (например, React + Tailwind).
coding-agent generate ui --input DESIGN.md --framework react --style tailwind --output src/components/GeneratedUI.tsx
Шаг 5: Проверьте сгенерированный код
Откройте файл src/components/GeneratedUI.tsx и убедитесь, что структура, цвета, отступы и токены соответствуют дизайну из DESIGN.md. При необходимости отредактируйте файл вручную.
# Пример просмотра файла
cat src/components/GeneratedUI.tsx
Шаг 6: (Опционально) Синхронизация с Figma
Если дизайн хранится в Figma, экспортируйте токены или SVG‑элементы и замените их в сгенерированном коде, используя скрипт или плагин.
# Пример команды экспорта токенов из Figma (через API)
figma export tokens --api-key $FIGMA_API_KEY --output design-tokens.json