Design systems and design.md
Record the small set of visual and component rules that should stay consistent across pages.
Learning
Choosing website components that fit the business
Choose website components by the reader's task, the business evidence available, and the action each section must support.
ReadLearning
What belongs in design.md
Write the decisions a person has to make, and name the colors and type the site already uses. Do not paste a second stylesheet.
ReadLearning
Keep related pages consistent
Share the header, the type, the colors, and the things you refuse to invent, so the second page still looks like the same site.
ReadFrom the Blog
How to use DESIGN.md with Codex
Create a practical design instruction file and use it across AI coding tools without assuming automatic discovery.
ReadDownload
Download the DESIGN.md starter file
Use the same downloadable design file kept with the original Blog guide.
Open fileFrom the Blog
Write an AI landing page brief
Connect audience, offer, proof, content, and visual direction before generating a page.
Read