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.

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.htmlvisualizing its design tokens, plus a hosted gallery - Extends the Stitch
DESIGN.mdformat 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.