DESIGN.md Generator (Google design.md spec)

Where should the design information come from? → Explore codebase

Read src/styles/global.css (@theme), src/layouts/Layout.astro and all 7 section components. Heading weights were taken from the actual markup: no weight class on any heading, so they are recorded as 400, not an assumed bold.

Generated DESIGN.md (frontmatter excerpt)

---
version: alpha
name: Minimufy
description: Brand landing page for Minimufy, a minimal-luxury outdoor brand opening its flagship store in Jingumae, Tokyo.
colors:
  primary: "#16150F"
  secondary: "#A9813D"
  secondary-soft: "#C9A668"
  surface: "#F4F1E9"
  surface-alt: "#EAE6D9"
  border: "#DDD6C4"
  muted: "#86816E"
typography:
  display:
    fontFamily: Gen Interface JP Display
    fontSize: 89px
    fontWeight: 400
    lineHeight: 1.05
    letterSpacing: -0.025em
  body-md:
    fontFamily: Gen Interface JP
    fontSize: 15px
    fontWeight: 400
    lineHeight: 1.625
  eyebrow:
    fontFamily: Gen Interface JP
    fontSize: 9.6px
    fontWeight: 400
    lineHeight: 1.5
    letterSpacing: 0.35em

  # + h1, h2, h3, body-sm, label-md
rounded:
  none: 0px
components:
  button-primary:
    backgroundColor: "{colors.primary}"
    textColor: "{colors.surface}"
    rounded: "{rounded.none}"
    padding: 12px
  divider:
    backgroundColor: "{colors.border}"
    height: 1px

  # + button-primary-hover, button-outline, input, eyebrow,
  #   body-muted, section-alt, footer, footer-link-hover
---

The body follows the spec's fixed section order: Overview, Colors, Typography, Layout, Elevation & Depth, Shapes, Components, Do's and Don'ts.

Lint (@google/design.md lint DESIGN.md)

All 3 warnings are real contrast problems in the existing site, not formatting issues:

These are below the WCAG AA minimum of 4.5:1. The brand colors were kept exactly as they are in the code. Changing a brand palette is a design decision, so they are reported for you to act on rather than silently adjusted.

Summary

DESIGN.md created at the project root.
Lint: 0 errors, 3 warnings (contrast), 1 info.

Colors: achromatic ink/paper base + one brass accent (7 tokens)
Type:   Gen Interface JP Display (headings, all 400) / Gen Interface JP (body 15px),
        Major Third scale
Shape:  square corners throughout, no shadows
Next:   consider darkening `muted` and `secondary` for text use to reach 4.5:1.