Awesome DESIGN.md

What it is

Awesome DESIGN.md is a catalog of files that describe design systems in text form. If an AI agent or team needs an interface in a product style, rules are needed: typography, color, density, components, tone, and limits.

The repository reflects a shift in interface development: a design system becomes not only a Figma library, but machine-readable context for code generation. DESIGN.md can be versioned beside the project.

What is inside and how people use it

Inside are DESIGN.md files and analyses of popular brand systems. Such a file can explain buttons, cards, spacing, forbidden patterns, and what makes the product visually distinct.

# DESIGN.md

## Typography
Use compact headings and readable body text.

## Layout
Prefer strict grids and clear section boundaries.

## Components
Buttons are rectangular. Cards are only for repeated items.

## Avoid
Decorative blobs, random gradients, and oversized hero sections.

A typical use case is adding DESIGN.md to a project and asking an agent to follow it when generating screens. This reduces repeated constraints in every prompt.

Strengths and limitations

The strength is turning design into a text contract. That is useful for AI development, code review, and long-lived projects where visual rules should live near code.

The limitation is that text does not replace real components or visual checks. DESIGN.md sets direction, but the result still needs browser review, design comparison, and state testing.