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

  1. 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.

  2. 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 đó.

  3. Đọ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.

  4. 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.

  5. 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ắc21 token, mỗi token có vai trò riêng
Kiểu chữ17 kiểu dùng Sohne
Bo góc10 token
Khoảng cách62 token
Component71 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ầnOverview, 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:

Trích từ cuối DESIGN.md của Stripe, giữ nguyên văn.
## 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ụcVì sao tệp có thể bỏ sótCần làm gì
Logo, icon, hình ảnhDESIGN.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ậpLượ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áiHover 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 độngHiệ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.
BreakpointLượ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ẫuPro 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.

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.

Xem tất cả hướng dẫn DESIGN.md