← all repositories
kzhrknt/awesome-design-md-jp

607 Japanese sites, distilled into prompts an AI can actually typeset

AI agents keep generating Japanese UI with cramped line-height and broken punctuation rules — this DESIGN.md collection fixes the spec, not the symptom.

awesome-design-md-jp
Collecting fresh signals — velocity needs a few days of history.
collecting data…
star history

What it does It’s a curated library of DESIGN.md files — plain-Markdown design specs in the format Google Stitch proposed, meant to sit next to AGENTS.md in your repo — one per Japanese web service. Drop one in and your AI coding agent gets the look-and-feel rules instead of guessing. The existing awesome-design-md covers 55+ Western services but, as the README bluntly puts it, completely lacks Japanese typography specs.

The interesting bit The value isn’t the brand list; it’s the CJK typography rules baked into each spec: Japanese-first font fallback chains, line-height of 1.5–2.0 (vs. Latin’s 1.4–1.5), 0.04–0.1em letter-spacing, kinsoku line-breaking rules, OpenType features like palt and kern, and mixed Japanese/Latin composition. These are exactly the details an LLM silently gets wrong.

Key highlights

  • 607 sites covered, from Mercari and LINE to Nintendo, MUJI, and Japan’s Digital Agency
  • Each entry ships with a preview.html visualizing its design tokens, plus a hosted gallery
  • Extends the Stitch DESIGN.md format rather than inventing a new one
  • Bilingual README (Japanese and English)

Caveats

  • It’s a content collection, not tooling — no automation beyond the preview pages
  • The README doesn’t explain how each spec was derived (hand-curated vs. scraped), so accuracy per site is unverified

Verdict Anyone building Japanese UI with AI agents should bookmark this immediately. If you never typeset Japanese, it’s still a neat reference for what CJK-aware design specs look like — but not much more.

Frequently asked

What is kzhrknt/awesome-design-md-jp?
AI agents keep generating Japanese UI with cramped line-height and broken punctuation rules — this DESIGN.md collection fixes the spec, not the symptom.
Is awesome-design-md-jp open source?
Yes — kzhrknt/awesome-design-md-jp is open source, released under the MIT license.
What language is awesome-design-md-jp written in?
kzhrknt/awesome-design-md-jp is primarily written in HTML.
How popular is awesome-design-md-jp?
kzhrknt/awesome-design-md-jp has 1k stars on GitHub.
Where can I find awesome-design-md-jp?
kzhrknt/awesome-design-md-jp is on GitHub at https://github.com/kzhrknt/awesome-design-md-jp.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.