Submit

Add a design to the directory.

Three ways to get a DESIGN.md added — pick whichever maps to where you are.

01 · You have a URL.

Auto-extract

Run npx design-md extract https://yoursite.com — get a draft DESIGN.md back in 30 seconds. Review it, tweak the lineage prose, send a PR.

Try the extractor →
02 · You have a vibe.

Chat-build

Describe the feeling — "warm editorial broadsheet", "neon arcade", "swiss grid" — chat agent walks you through the tokens. Live preview renders as you talk.

Open the chat →
03 · You already have one.

Hand-craft

Already have a DESIGN.md in your repo? Open a PR adding it under site/src/content/designs/<slug>.md with the directory metadata header. We review within 48h.

Open a PR →

What we accept

  • ✓ Real production sites' design systems (your own product, not a competitor's).
  • ✓ Open-source design systems (Tailwind UI, shadcn/ui themes, Material variants).
  • ✓ Editorial templates with named lineage and Do's & Don'ts.
  • ✗ Token swaps of existing entries with cosmetic changes only.
  • ✗ Submissions that don't pass design-md lint.

Before you submit

  1. Run design-md lint <file> locally; fix all errors.
  2. Add a lineage block — 200 words explaining what it draws from. We won't accept Mad-Libs prose.
  3. Add a preview_swatch array of 3 hexes for the card meta strip.
  4. Tag categories + tags using the existing taxonomy (see /spec).