Tools

DESIGN.md: đưa “gu thiết kế” vào repo để AI build UI không còn generic

Tóm tắt

DESIGN.md là file Markdown mô tả hệ thống thiết kế (màu, typography, spacing, elevation, responsive) để coding agent đọc khi dựng UI. Repo VoltAgent/awesome-design-md và trang getdesign.md cung cấp hàng trăm mẫu tham khảo. Dùng làm điểm khởi đầu, không sao chép nhận diện thương hiệu của người khác.

Một DESIGN.md thường có

MụcVí dụ nội dung
ColorsPrimary, surface, text, border + light/dark tokens
TypographyFont, scale, line-height, weight cho heading/body
Spacing & layoutThang 4/8px, max-width, grid
ComponentsButton, card, input — trạng thái hover/focus/disabled
Motion & elevationShadow, radius, thời lượng animation

Cách dùng với Claude Code

  1. Chọn một mẫu gần phong cách bạn muốn trên getdesign.md.
  2. Chép vào repo thành DESIGN.md, chỉnh lại màu, font, tên cho thương hiệu của bạn.
  3. Thêm vào CLAUDE.md: “Khi làm UI, tuân thủ DESIGN.md”.
  4. Yêu cầu agent tự review UI so với DESIGN.md trước khi báo xong.