kzhrknt/awesome-design-md-jp

What it solves

This project provides a collection of DESIGN.md files specifically tailored for Japanese web services. Standard design documentation often overlooks the unique requirements of Japanese typography, which can lead AI agents to generate UI with incorrect font stacks, improper line heights, and broken punctuation handling.

How it works

It uses the DESIGN.md format—a plain-text Markdown specification proposed by Google Stitch—to define the visual style and atmosphere of a website. By including these files in a project, AI agents can reference specific Japanese typographic rules, such as fallback chains for Japanese fonts, proper character spacing, and specific line-height requirements, ensuring the generated UI remains consistent and legible.

Who it’s for

This collection is for developers and designers working with AI agents to build or prototype Japanese web interfaces who need to ensure their AI-generated designs adhere to professional Japanese typographic standards.

Highlights

• Contains a curated collection of DESIGN.md files for a wide range of Japanese services.
• Addresses critical Japanese-specific design needs: font fallback chains, line-height adjustments, character spacing, and strict punctuation rules (kin-soku).
• Includes a preview.html gallery to visualize the design tokens for over 500 sites.
• Bridges the gap left by existing international design documentation that lacks Japanese-specific settings.