awesome-design-md/CONTRIBUTING.md

Contributing to Awesome Design MD

Thanks for contributing.

This repository is a curated collection of DESIGN.md files extracted from popular websites. Each file captures a site's complete visual language in a format any AI agent can read.

How to Contribute

Request a New Site

To request a DESIGN.md for a website, open an issue with the website URL.

We receive many requests, and maintainer bandwidth is limited. Sponsor-backed requests are prioritized, consider supporting the project via GitHub Sponsors if you'd like faster turnaround.

Improve an Existing DESIGN.md

If you notice issues with an existing file:

1. Open the site's DESIGN.md
2. Compare against the live site
3. Fix incorrect hex values, missing tokens, or weak descriptions
4. Update the preview.html and preview-dark.html if your changes affect displayed tokens
5. Open a PR with before/after rationale

License

By contributing, you agree your contributions are provided under the repository license terms.