คู่มือ

กำลังสร้างเว็บไซต์ใหม่? ดึงระบบดีไซน์ออกมาก่อน

การสร้างใหม่ การรีแบรนด์ หรือการย้ายไปเฟรมเวิร์กใหม่ คือช่วงที่ระบบดีไซน์มักสูญหายไปอย่างเงียบ ๆ สีอยู่ใน CSS เก่า สเกลตัวอักษรอยู่ในหัวของใครสักคน สถานะของปุ่มอยู่ในคอมโพเนนต์ที่ไม่มีใครอยากเปิด

ดึงเว็บไซต์ปัจจุบันของคุณเป็น DESIGN.md ก่อนเปลี่ยนแปลงอะไร คุณจะได้ข้อมูลพื้นฐานที่เป็นลายลักษณ์อักษรสำหรับการสร้างใหม่ ซึ่งทั้งทีมและเอเจนต์เขียนโค้ดของคุณอ่านได้

เขียนสำหรับทีมที่วางแผนสร้างใหม่ รีแบรนด์ หรือย้ายระบบ อัปเดตเมื่อ

สิ่งที่คุณจะได้

  • DESIGN.md ของเว็บไซต์ปัจจุบัน commit ไว้ก่อนเขียนโค้ดบรรทัดแรกของการสร้างใหม่
  • ภาพที่ชัดเจนว่าไฟล์เก็บอะไรไว้ได้และอะไรที่เก็บไม่ได้
  • รายการตรวจสอบสิ่งที่ต้องตรวจด้วยตัวเอง ได้แก่ asset สถานะ motion breakpoint และหน้าที่ต้องล็อกอิน
  • วิธีเปรียบเทียบเว็บไซต์ใหม่กับเว็บไซต์เก่าเมื่อเสร็จแล้ว

ควรทำเมื่อไร

  • การย้ายเฟรมเวิร์ก หน้าตาเหมือนเดิม แต่ stack ใหม่ DESIGN.md ช่วยให้เอเจนต์เขียนโค้ดของคุณสร้างคอมโพเนนต์ใหม่ด้วยค่าที่แน่นอน แทนการอ่านสไตล์ชีตเก่า
  • การรีแบรนด์ บันทึกระบบเก่าไว้ก่อน เพื่อให้รู้แน่ชัดว่าสี ฟอนต์ และความโค้งมุมไหนเปลี่ยน และอะไรคงเดิม
  • การส่งมอบงาน เอเจนซีใหม่หรือทีมใหม่จะได้ไฟล์เดียวที่อธิบายว่าเว็บไซต์มีหน้าตาอย่างไรในวันนี้ แทนการพาเดินดูโค้ดเบส

ขั้นตอน

  1. ดึงดีไซน์จากเว็บไซต์จริงก่อนเปลี่ยนแปลงอะไร

    วาง URL ของ production ในหน้าแรกของ Design Extractor แล้วเริ่มการดึงดีไซน์ระดับ Pro ต้องเป็นหน้าสาธารณะ เพราะการดึงดีไซน์โหลดหน้าเว็บเหมือนผู้เข้าชม localhost และหน้าที่ต้องล็อกอินจึงใช้ไม่ได้

  2. commit เป็นข้อมูลพื้นฐาน

    บันทึกเป็น DESIGN.md ใน repository ใหม่ แล้ว commit ก่อนเริ่มสร้างใหม่ ตอนนี้ไฟล์บันทึกว่าเว็บไซต์มีหน้าตาอย่างไรในวันนั้น

  3. อ่านส่วน Known Gaps

    ท้ายไฟล์แสดงรายการสิ่งที่การดึงดีไซน์บันทึกไม่ได้ ทุกรายการในนั้นคือสิ่งที่ต้องตรวจสอบด้วยตัวเอง

  4. ตรวจสอบสิ่งที่ DESIGN.md เก็บไม่ได้

    asset หน้าจอที่ต้องล็อกอิน motion และรายการอื่นด้านล่าง เพิ่มหมายเหตุลงในไฟล์ไปพร้อมกัน

  5. สร้างโดยอิงจากไฟล์นี้

    บอกเอเจนต์เขียนโค้ดให้ใช้ไฟล์นี้ ตามที่คู่มือ Claude Code และ Cursorแสดงไว้ แล้วรีวิวหน้าจอใหม่แต่ละหน้าเทียบกับไฟล์

สิ่งที่ไฟล์เก็บไว้ได้จาก Stripe

หากต้องการดูว่าคุณจะได้อะไร ให้ดูDESIGN.md ของ Stripeในแกลเลอรี การดึงดีไซน์ระดับ Pro บันทึก 5 หน้าของ stripe.com: /nl, /nl/pricing, /nl/products, /nl/newsroom/news/stripe-openai-instant-checkout, /nl/contact/sales การดึงดีไซน์เว็บไซต์ของคุณเองจะได้โครงสร้างแบบเดียวกัน

สี21 โทเค็น แต่ละตัวพร้อมบทบาท
ตัวอักษร17 สไตล์ ใน Sohne
ความโค้งมุม10 โทเค็น
ระยะห่าง62 โทเค็น
คอมโพเนนต์71 สูตรใน HTML และ CSS: 44 สูตรผ่านการตรวจสอบเทียบกับหน้าเว็บจริง 27 สูตรถูกแจ้งเตือนหรือตรวจสอบไม่ได้ แต่ละสูตรพร้อมเหตุผล
ส่วนต่าง ๆOverview, Colors, Typography, Layout, Elevation & Depth, Shapes, Components, Do's and Don'ts, Responsive Behavior, Iteration Guide, Known Gaps

สิ่งที่ไฟล์ระบุว่าพลาดไป

ไฟล์บอกข้อจำกัดของตัวเองอย่างตรงไปตรงมา 5 รายการแรกจากทั้งหมด 11 รายการในส่วน Known Gaps:

จากท้าย DESIGN.md ของ Stripe ตามต้นฉบับ
## 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.

ดึงจากเว็บไซต์สาธารณะของ Stripe ไม่ใช่แนวทางแบรนด์อย่างเป็นทางการ อ่าน DESIGN.md ฉบับเต็มของ Stripe

ไฟล์ของคุณเองจะมีรายการของตัวเอง ให้ใช้เป็นรายการสิ่งที่ต้องทำสำหรับการตรวจสอบด้านล่าง

สิ่งที่ต้องตรวจสอบด้วยตัวเอง

รายการทำไมไฟล์อาจพลาดสิ่งที่ต้องทำ
โลโก้ ไอคอน ภาพDESIGN.md อธิบายสไตล์ ไม่ใช่ไฟล์export จากโค้ดเบสปัจจุบันแล้วเก็บไว้กับโค้ดเบสใหม่
หน้าจอที่ต้องล็อกอินการดึงดีไซน์เห็นเฉพาะหน้าสาธารณะจดรายการว่าแอปแตกต่างจากเว็บไซต์การตลาดอย่างไร เช่น ตารางที่หนาแน่นกว่าหรือแถบด้านข้าง
สถานะhover และ focus ถูกบันทึกไว้ในจุดที่การดึงดีไซน์เห็น ส่วนสถานะ pressed, disabled และ error มักไม่ถูกบันทึกคลิกไล่ดูฟอร์มและปุ่ม แล้วจดสถานะที่ขาดไป
Motiontransition และ animation ถูกอธิบายเป็นคำพูดเท่านั้น หากมีจดระยะเวลาและ easing จาก CSS ปัจจุบัน
Breakpointการดึงดีไซน์บันทึกความกว้างแบบเดสก์ท็อปและมือถือตรวจสอบเลย์เอาต์แท็บเล็ตและจดจุดที่จำนวนคอลัมน์เปลี่ยน
เทมเพลตที่อยู่นอกตัวอย่างระดับ Pro เก็บตัวอย่างจากหน้าสำคัญประมาณห้าหน้าดึงดีไซน์ของหน้าที่ดูแตกต่าง เช่น หน้าเอกสารหรือหน้าชำระเงิน แยกต่างหาก

หลังสร้างใหม่

เมื่อเว็บไซต์ใหม่เผยแพร่แล้ว ให้ดึงดีไซน์อีกครั้งแล้วเปรียบเทียบสองไฟล์ โทเค็นที่ไม่เปลี่ยนแปลงหมายความว่าหน้าตายังคงอยู่ ส่วนโทเค็นที่เปลี่ยนไปคือการรีแบรนด์ที่คุณวางแผนไว้ หรือความคลาดเคลื่อนที่ต้องแก้

text diff ทั่วไปแสดงค่า hex และขนาดที่เปลี่ยนไปได้ แพ็กเกจ @google/design.md ของ Google เพิ่มคำสั่ง diff ที่เปรียบเทียบสองเวอร์ชันทีละโทเค็น คำอธิบาย DESIGN.mdครอบคลุมรูปแบบและเครื่องมือที่เกี่ยวข้อง หากคุณแก้ไขไฟล์เองระหว่างทาง ให้ตรวจสอบด้วยตัวตรวจสอบ DESIGN.md

FAQ

ดึงระบบดีไซน์ของคุณก่อนสร้างเว็บไซต์ใหม่: คำถามที่พบบ่อย

คำตอบสั้น ๆ สำหรับคำถามที่คนมักถามก่อนลองทำ

ไม่มี DESIGN.md เป็นไฟล์ข้อความที่อธิบายสไตล์ ได้แก่ สี ตัวอักษร ระยะห่าง ความโค้งมุม และสูตรคอมโพเนนต์ใน HTML และ CSS ให้ export โลโก้ ไอคอน ภาพประกอบ และภาพถ่ายจากโค้ดเบสหรือไฟล์ดีไซน์ปัจจุบัน แล้วเก็บไว้คู่กัน

ไม่ได้ การดึงดีไซน์โหลดหน้าเว็บจาก URL เหมือนผู้เข้าชมทั่วไป หน้าที่ต้องล็อกอิน หน้าบน localhost หรือบนเครือข่ายส่วนตัวจึงไม่รองรับ ให้ดึงดีไซน์จากเว็บไซต์สาธารณะ แล้วจดบันทึกว่าหน้าจอที่ต้องล็อกอินแตกต่างอย่างไร

ระดับ Pro เก็บตัวอย่างจากหน้าสำคัญของเว็บไซต์ประมาณห้าหน้า และรวมสิ่งที่พบไว้ใน DESIGN.md ไฟล์เดียว หากเทมเพลตสำคัญไม่ได้อยู่ในนั้น เช่น หน้าเอกสารหรือหน้าชำระเงิน ให้ดึงดีไซน์จาก URL ของหน้านั้นด้วย แล้วเปรียบเทียบสองไฟล์

ดึงดีไซน์ของเว็บไซต์ใหม่เมื่อเผยแพร่แล้ว แล้วเปรียบเทียบสองไฟล์ แพ็กเกจ @google/design.md ของ Google มีคำสั่ง diff ที่เปรียบเทียบสองเวอร์ชันของ DESIGN.md ทีละโทเค็น และ text diff ทั่วไปก็แสดงค่า hex และขนาดที่เปลี่ยนไปได้

บันทึกเว็บไซต์ของคุณก่อนเปลี่ยนแปลง

วาง URL ของ production การดึงดีไซน์ระดับ Pro จะเก็บตัวอย่างจากหน้าสำคัญและส่งคืน DESIGN.md หนึ่งไฟล์

ดูคู่มือ DESIGN.md ทั้งหมด