Hướng dẫn
Sắp làm lại trang web? Hãy trích xuất hệ thống thiết kế trước
Làm lại trang, đổi thương hiệu hay chuyển sang framework mới là lúc hệ thống thiết kế lặng lẽ thất lạc. Màu sắc nằm trong CSS cũ, thang kiểu chữ nằm trong đầu ai đó, trạng thái của nút nằm trong một component không ai muốn mở ra.
Hãy trích xuất trang hiện tại thành DESIGN.md trước khi thay đổi bất cứ thứ gì. Bạn sẽ có một mốc chuẩn bằng văn bản cho bản dựng mới, thứ mà cả nhóm lẫn agent lập trình AI của bạn đều đọc được.
Viết cho nhóm đang lên kế hoạch làm lại, đổi thương hiệu hoặc chuyển đổi. Cập nhật .
Bạn sẽ nhận được
- Một DESIGN.md của trang hiện tại, được commit trước dòng code đầu tiên của bản làm lại.
- Cái nhìn rõ ràng về những gì tệp đã ghi lại và những gì chưa.
- Danh sách những thứ cần kiểm tra thủ công: tài nguyên, trạng thái, chuyển động, breakpoint và các trang cần đăng nhập.
- Một cách để so sánh trang mới với trang cũ khi bạn làm xong.
Khi nào nên làm việc này
- Chuyển framework. Giao diện giữ nguyên, stack mới. DESIGN.md cho phép agent lập trình AI dựng lại component bằng giá trị chính xác thay vì đọc stylesheet cũ.
- Đổi thương hiệu. Lưu lại hệ thống cũ trước, để bạn biết chính xác màu, font và bo góc nào thay đổi, cái nào giữ nguyên.
- Bàn giao. Một agency mới hay một nhóm mới nhận được một tệp mô tả trang web trông thế nào hôm nay, thay vì phải đi một vòng qua codebase.
Các bước
Trích xuất trang đang chạy trước khi thay đổi bất cứ thứ gì
Dán URL production vào trang chủ Design Extractor và chạy một lượt trích xuất Pro. Đó phải là trang công khai: lượt trích xuất tải trang như một khách truy cập, nên localhost và các trang cần đăng nhập không dùng được.
Commit tệp làm mốc chuẩn
Lưu thành DESIGN.md trong repository mới và commit trước khi bắt đầu làm lại. Từ đây tệp ghi lại trang web trông thế nào vào ngày hôm đó.
Đọc phần Known Gaps
Cuối tệp liệt kê những gì lượt chạy không ghi lại được. Mỗi mục trong đó là một việc cần kiểm tra thủ công.
Kiểm tra những gì DESIGN.md không chứa được
Tài nguyên, màn hình sau đăng nhập, chuyển động và các mục khác bên dưới. Ghi chú vào tệp trong lúc làm.
Dựng dựa trên tệp
Trỏ agent lập trình AI tới tệp, như hướng dẫn cho Claude Code và Cursor chỉ ra, và đối chiếu từng màn hình mới với nó.
Những gì tệp đã ghi lại trên Stripe
Để xem bạn sẽ nhận được gì, hãy xem DESIGN.md của Stripe trong thư viện mẫu. Lượt Pro của nó đã quét 5 trang của stripe.com: /nl, /nl/pricing, /nl/products, /nl/newsroom/news/stripe-openai-instant-checkout, /nl/contact/sales. Một lượt chạy trên trang của bạn sẽ cho ra cấu trúc tương tự.
| Màu sắc | 21 token, mỗi token có vai trò riêng |
|---|---|
| Kiểu chữ | 17 kiểu dùng Sohne |
| Bo góc | 10 token |
| Khoảng cách | 62 token |
| Component | 71 công thức bằng HTML và CSS: 44 vượt qua bước kiểm tra với trang thật, 27 bị flagged hoặc không kiểm tra được, mỗi cái kèm lý do |
| Các phần | Overview, Colors, Typography, Layout, Elevation & Depth, Shapes, Components, Do's and Don'ts, Responsive Behavior, Iteration Guide, Known Gaps |
Những gì tệp tự nhận là còn thiếu
Tệp nói rõ giới hạn của mình. 5 mục đầu tiên trong tổng số 11 mục ở phần Known Gaps:
## Known Gaps
- **Many recipes did not reproduce exactly.** `button-primary` (84% pixel match), `card` (78%), `card-2` (94%), `promo-banner` (77%) and `skip-link` (0%; it is visually hidden until focused) are approximations. So are several header and footer recipes (`header-landing`, `header-inner-2` timed out, `footer-landing`, `footer-inner`, `footer-inner-2`).
- **Some recipes could not be judged at all.** `stat` and `stat-2` were not verifiable, because page media covered most of the element.
- **Some elements were never visible.** `footer-landing`, `header-inner` and `logo-strip-item` were not visible when verification ran, so their values come from computed styles only.
- **No section rhythm was measured.** `sectionRhythm` is empty, so vertical spacing between page sections and the inner padding of large cards is described only qualitatively.
- **No `base` spacing step was published.** The evidence frequency (4px, 8px, 12px, 16px and 24px most common) suggests a 4px-derived grid, but it is not a verified token.Trích xuất từ trang web công khai của Stripe, không phải hướng dẫn thương hiệu chính thức. Đọc toàn bộ DESIGN.md của Stripe
Tệp của bạn sẽ có danh sách riêng. Hãy coi đó là danh sách việc cần làm cho các bước kiểm tra bên dưới.
Những gì cần kiểm tra thủ công
| Hạng mục | Vì sao tệp có thể bỏ sót | Cần làm gì |
|---|---|---|
| Logo, icon, hình ảnh | DESIGN.md mô tả phong cách, không chứa tệp. | Xuất chúng từ codebase hiện tại và giữ cùng codebase mới. |
| Màn hình sau đăng nhập | Lượt trích xuất chỉ thấy các trang công khai. | Ghi lại ứng dụng khác trang marketing ở điểm nào, như bảng dày đặc hơn hay có thanh bên. |
| Trạng thái | Hover và focus được ghi lại ở những chỗ lượt chạy thấy chúng; trạng thái nhấn, vô hiệu hóa và lỗi thường thì không. | Bấm thử qua các biểu mẫu và nút, ghi lại những trạng thái còn thiếu. |
| Chuyển động | Hiệu ứng chuyển tiếp và hoạt ảnh cùng lắm chỉ được mô tả bằng lời. | Ghi lại thời lượng và easing từ CSS hiện tại. |
| Breakpoint | Lượt chạy ghi lại một chiều rộng desktop và một chiều rộng mobile. | Kiểm tra bố cục tablet và ghi lại chỗ số cột thay đổi. |
| Template ngoài phạm vi lấy mẫu | Pro lấy mẫu khoảng năm trang chính. | Trích xuất riêng bất kỳ trang nào trông khác, như trang tài liệu hay trang thanh toán. |
Sau khi làm lại
Khi trang mới đã chạy thật, hãy trích xuất lại và so sánh hai tệp. Token không đổi nghĩa là giao diện được giữ lại; token thay đổi hoặc là phần đổi thương hiệu bạn đã lên kế hoạch, hoặc là chỗ bị lệch cần sửa.
Bất kỳ công cụ diff văn bản nào cũng cho thấy mã hex và kích thước đã đổi. Gói @google/design.md của Google có thêm lệnh diff so sánh hai phiên bản theo từng token; bài giới thiệu DESIGN.md nói về định dạng và công cụ đi kèm. Nếu bạn sửa tệp bằng tay trong quá trình làm, hãy kiểm tra bằng Trình kiểm tra DESIGN.md.
Các tệp dùng trong hướng dẫn này
Mở một tệp để xem DESIGN.md đầy đủ, từ token ở đầu đến phần Known Gaps ở cuối.
Tài chính & FintechStripe
Trang chủ tiếp thị của Stripe sử dụng một hệ thống thiết kế được kiểm soát chặt chẽ (HDS — Stripe Design System), xây dựng quanh phông chữ biến thiên "sohne-var" ở các độ đậm nhẹ (300–400), một bảng màu thương hiệu từ xanh navy đậm đến chàm, lấy #533afd (Stripe Indigo) làm trục chính, cùng với phần hero có dải gradient quang phổ tràn viền đặc trưng. Các thành phần có bo góc nhỏ (4–6px), bóng đổ phẳng đến tối giản, và được bố cục theo lưới khoảng cách cơ sở 8px. Tổng thể giọng điệu vừa đầy uy quyền vừa gần gũi: hạ tầng tài chính được truyền đạt qua kiểu chữ tự tin và cách dùng màu tiết chế.
Dịch vụ doanh nghiệp & Chuyên mônShopify
Trang chủ tiếp thị của Shopify sử dụng một khu vực hero video toàn màn hình đầy kịch tính, với nền gần đen (#02090a) tương phản rõ rệt với thanh điều hướng màu trắng phía trên. Màu nhấn thương hiệu chủ đạo là xanh bạc hà rực rỡ (#36f4a4), được dùng tiết chế cho các điểm nhấn và trạng thái tương tác. Kiểu chữ được phân chia giữa NeueHaasGrotesk cho tiêu đề hiển thị và mang tính biên tập, và Inter-Variable cho nội dung giao diện người dùng. Các nút kêu gọi hành động (CTA) có hình viên thuốc bo tròn hoàn toàn (border-radius: 9999px). Tổng thể hệ thống thiết kế tự tin, độ tương phản cao và đầy khát vọng, được xây dựng để biến khách truy cập thành người bán hàng.
Lập trình & Hạ tầng · Developer Tools & IDEsSupabase
Supabase sử dụng một hệ thống thiết kế ưu tiên giao diện tối, lấy nền gần đen sâu (oklch ~0.19) làm nền tảng, kết hợp với màu nhấn xanh lá rực rỡ (#3ecf8e / #3fcf8e). Bố cục được xây dựng quanh lưới thẻ tính năng đáp ứng, với Manrope cho tiêu đề hiển thị và Inter cho văn bản nội dung cũng như giao diện. Source Code Pro được dùng cho mọi ngữ cảnh monospace và mã nguồn. Hệ thống màu dựa trên các custom property oklch với cách đặt tên theo ngữ nghĩa. Thẻ có bo góc 12px và viền mỏng tinh tế, nút bo góc 6–8px, mật độ nội dung vừa phải và lưới khoảng cách cơ sở 8px.
FAQ
Trích xuất hệ thống thiết kế trước khi làm lại trang: câu hỏi thường gặp
Trả lời ngắn cho những điều mọi người hay hỏi trước khi thử.
Không. DESIGN.md là một tệp văn bản mô tả phong cách: màu sắc, kiểu chữ, khoảng cách, bo góc và công thức component bằng HTML và CSS. Hãy xuất logo, icon, hình minh họa và ảnh từ codebase hoặc tệp thiết kế hiện tại và lưu chúng cạnh tệp này.
Không. Lượt trích xuất tải trang từ URL giống như một khách truy cập, nên các trang cần đăng nhập, chạy trên localhost hoặc trong mạng nội bộ không được hỗ trợ. Hãy trích xuất trang công khai, và ghi lại các màn hình sau khi đăng nhập khác ở điểm nào.
Pro lấy mẫu các trang chính của trang web, khoảng năm trang, và gộp những gì tìm được vào một DESIGN.md. Nếu một template quan trọng không nằm trong số đó, như trang tài liệu hay trang thanh toán, hãy trích xuất thêm URL của trang đó và so sánh hai tệp.
Trích xuất trang mới khi nó đã chạy thật và so sánh hai tệp. Gói @google/design.md của Google có lệnh diff so sánh hai phiên bản của một DESIGN.md theo từng token, và bất kỳ công cụ diff văn bản nào cũng cho thấy mã hex và kích thước đã thay đổi.
Lưu lại trang của bạn trước khi thay đổi
Dán URL production của bạn. Một lượt trích xuất Pro lấy mẫu các trang chính và trả về một DESIGN.md.
Hướng dẫn liên quan
Để Claude Code và Cursor dựng UI khớp với một trang web
Trích xuất một trang bạn thích, đặt DESIGN.md của nó vào repo và trỏ agent tới tệp, kèm prompt chính xác cho Claude Code và Cursor.
Không có designer? Mượn một hệ thống thiết kế đã được kiểm chứng cho ứng dụng của bạn
Cách chọn trang tham khảo, giữ gì từ DESIGN.md của nó và đổi gì để kết quả là của bạn chứ không phải bản sao.
Kết hợp hai trang tham khảo thành một thiết kế cho bản prototype
So sánh từng token của hai tệp DESIGN.md đã trích xuất và gộp thành một đặc tả cho bản prototype, thủ công hoặc cùng agent của bạn.
Cung cấp đặc tả thiết kế cho agent lập trình khi cần bằng MCP
Kết nối máy chủ MCP để agent tự trích xuất DESIGN.md của một trang, chờ kết quả và dựng giao diện từ đó.