{
  "version": 1,
  "name": "Manual",
  "summary": "Manual is a tool for writing brand guides and publishing them to one link, as a PDF, and as design.md.\n\nThe brand looks like the thing it makes: a well-set document. Swiss in spirit — one sans family, a visible 12-column grid, hairline rules, decimal section numbers (1.0, 1.1, 2.0 …), square corners and almost no color. Restraint is the identity; the single square blue full stop is the only flourish.",
  "links": {
    "guide": "https://app.usemanual.site/g/manual",
    "designMd": "https://app.usemanual.site/g/manual/design.md",
    "brandJson": "https://app.usemanual.site/g/manual/brand.json",
    "tokensJson": "https://app.usemanual.site/g/manual/tokens.json",
    "llmsTxt": "https://app.usemanual.site/g/manual/llms.txt",
    "mcp": "https://app.usemanual.site/g/manual/mcp"
  },
  "voice": "Plain, exact and calm — the voice of a good manual. Short declarative sentences, sentence case, no exclamation marks, no hype (\"revolutionary\", \"AI-powered\", \"magic\"). Say what the thing does: \"Write it down once. Share it everywhere.\" Use US English (\"color\"), matching the product UI. Numbers and structure over adjectives.",
  "colors": {
    "palette": [
      {
        "name": "Ink",
        "hex": "#111111",
        "cssVar": "--color-ink",
        "group": "Core",
        "notes": "Text, hairline rules, primary buttons, the icon field. Never pure black."
      },
      {
        "name": "Paper",
        "hex": "#ECEAE5",
        "cssVar": "--color-paper",
        "group": "Core",
        "notes": "Page ground. The default background everywhere."
      },
      {
        "name": "Document",
        "hex": "#F7F6F2",
        "cssVar": "--color-document",
        "group": "Core",
        "notes": "Raised surfaces on Paper: cards, panels, the guide page."
      },
      {
        "name": "Blue",
        "hex": "#2D5BFF",
        "cssVar": "--color-blue",
        "group": "Core",
        "notes": "Rare accent: the full stop and the icon's square, at most one small mark per screen. Never a button, background or body text."
      },
      {
        "name": "Folder",
        "hex": "#C9C6BD",
        "cssVar": "--color-folder",
        "group": "Support",
        "notes": "Quiet fills: diagram columns, disabled states, secondary blocks. Never text."
      },
      {
        "name": "Graphite",
        "hex": "#55524C",
        "cssVar": "--color-graphite",
        "group": "Support",
        "notes": "Secondary text: captions, metadata, running headers."
      }
    ],
    "pairings": [
      {
        "foreground": "Ink",
        "background": "Paper",
        "contrast": 15.71,
        "wcag": "AAA"
      },
      {
        "foreground": "Ink",
        "background": "Document",
        "contrast": 17.46,
        "wcag": "AAA"
      },
      {
        "foreground": "Ink",
        "background": "Folder",
        "contrast": 11.06,
        "wcag": "AAA"
      },
      {
        "foreground": "Graphite",
        "background": "Paper",
        "contrast": 6.48,
        "wcag": "AA"
      },
      {
        "foreground": "Graphite",
        "background": "Document",
        "contrast": 7.2,
        "wcag": "AAA"
      },
      {
        "foreground": "Document",
        "background": "Ink",
        "contrast": 17.46,
        "wcag": "AAA"
      },
      {
        "foreground": "Document",
        "background": "Blue",
        "contrast": 4.79,
        "wcag": "AA"
      }
    ],
    "surfaces": {
      "light": "#ECEAE5",
      "dark": "#ECEAE5"
    },
    "composition": [
      {
        "name": "Paper",
        "percent": 40
      },
      {
        "name": "Ink",
        "percent": 30
      },
      {
        "name": "Document",
        "percent": 16
      },
      {
        "name": "Folder",
        "percent": 12
      },
      {
        "name": "Blue",
        "percent": 2
      }
    ],
    "notes": "Almost no color: Paper and Document carry the page, Ink carries the type, and Blue appears once — the square full stop. Blue on Paper is 4.31:1: fine for the full stop and other non-text marks, not for body text. Never use orange in any shade; it is the signature color of a direct competitor."
  },
  "typography": {
    "families": [
      {
        "name": "ABC Areal",
        "role": "Sans",
        "weights": [
          400,
          500,
          700
        ],
        "source": "upload"
      },
      {
        "name": "Arimo",
        "role": "Sans",
        "weights": [
          400,
          500,
          700
        ],
        "source": "google",
        "fallback": true,
        "fallbackFor": "ABC Areal"
      }
    ],
    "scale": [
      {
        "role": "display",
        "sizePx": 248,
        "family": "ABC Areal",
        "weight": 500,
        "lineHeightPct": 76,
        "trackingEm": -0.045,
        "note": "Hero lockup only"
      },
      {
        "role": "h1",
        "sizePx": 72,
        "family": "ABC Areal",
        "weight": 500,
        "lineHeightPct": 98,
        "trackingEm": -0.045
      },
      {
        "role": "h2",
        "sizePx": 56,
        "family": "ABC Areal",
        "weight": 500,
        "lineHeightPct": 90,
        "trackingEm": -0.045,
        "note": "Section titles, e.g. 2.0 Logo"
      },
      {
        "role": "body",
        "sizePx": 17,
        "family": "ABC Areal",
        "weight": 400,
        "lineHeightPct": 150,
        "trackingEm": 0,
        "note": "Max ~65ch"
      },
      {
        "role": "caption",
        "sizePx": 13,
        "family": "ABC Areal",
        "weight": 400,
        "lineHeightPct": 145,
        "trackingEm": 0,
        "note": "Labels in 500"
      }
    ],
    "notes": "One family, sans only: ABC Areal by Dinamo. Areal has no Semibold — use 400 for text and 500 for headings, the wordmark and emphasis; 700 is reserved. Use the default a; the alternate a (stylistic set ss01) is not part of the brand. Arimo, which shares Arial's metrics, stands in where Areal can't be loaded."
  },
  "logo": {
    "assets": [
      {
        "url": "https://app.usemanual.site/brand/manual/wordmark.svg",
        "label": "Wordmark",
        "filename": "manual-wordmark.svg"
      },
      {
        "url": "https://app.usemanual.site/brand/manual/wordmark-inverse.svg",
        "label": "Wordmark — on Ink",
        "filename": "manual-wordmark-inverse.svg"
      },
      {
        "url": "https://app.usemanual.site/brand/manual/icon.svg",
        "label": "Icon",
        "filename": "manual-icon.svg"
      }
    ],
    "donts": [
      "No symbol, monogram or printer marks next to the wordmark. Never replace, detach or enlarge the full stop.",
      "The word is Ink or Document, the full stop Blue — nothing else. (recolor)",
      "Don't stretch or condense the wordmark. (stretch)",
      "Don't outline it. (outline)",
      "No shadows, gradients or rounded icon corners. (shadow)",
      "Don't rotate it. (rotate)",
      "Don't fill it with images or patterns. (pattern)"
    ],
    "clearspace": "Keep clear space equal to the cap height of the \"M\" on all four sides.",
    "scaling": "The wordmark needs at least 16px cap height on screen; below that, use the icon.",
    "minimumSizesPx": [
      16,
      32,
      64
    ],
    "notes": "The logo is a typeset wordmark — \"Manual.\" — set in ABC Areal Medium at -0.045em letter-spacing, with the full stop in Blue. There is no symbol. The word is Ink on light grounds and Document on Ink; the full stop stays Blue on both. The icon is a square Ink field with a centered Blue square — Areal's full stop is square, and so is everything else — used wherever the wordmark would be smaller than 16px cap height."
  },
  "sections": [
    {
      "id": "introduction",
      "title": "Overview",
      "kind": "introduction",
      "text": "Manual is a tool for writing brand guides and publishing them to one link, as a PDF, and as design.md.\n\nThe brand looks like the thing it makes: a well-set document. Swiss in spirit — one sans family, a visible 12-column grid, hairline rules, decimal section numbers (1.0, 1.1, 2.0 …), square corners and almost no color. Restraint is the identity; the single square blue full stop is the only flourish.",
      "media": [
        {
          "url": "https://app.usemanual.site/brand/manual/key-visual.svg",
          "caption": "The wordmark with its clear space."
        }
      ]
    },
    {
      "id": "personality",
      "title": "Voice & Personality",
      "kind": "generic",
      "text": "Plain, exact and calm — the voice of a good manual. Short declarative sentences, sentence case, no exclamation marks, no hype (\"revolutionary\", \"AI-powered\", \"magic\"). Say what the thing does: \"Write it down once. Share it everywhere.\" Use US English (\"color\"), matching the product UI. Numbers and structure over adjectives.",
      "media": []
    },
    {
      "id": "logo",
      "title": "Logo",
      "kind": "logo",
      "text": "The logo is a typeset wordmark — \"Manual.\" — set in ABC Areal Medium at -0.045em letter-spacing, with the full stop in Blue. There is no symbol. The word is Ink on light grounds and Document on Ink; the full stop stays Blue on both. The icon is a square Ink field with a centered Blue square — Areal's full stop is square, and so is everything else — used wherever the wordmark would be smaller than 16px cap height.",
      "media": []
    },
    {
      "id": "colors",
      "title": "Colors",
      "kind": "colors",
      "text": "Almost no color: Paper and Document carry the page, Ink carries the type, and Blue appears once — the square full stop. Blue on Paper is 4.31:1: fine for the full stop and other non-text marks, not for body text. Never use orange in any shade; it is the signature color of a direct competitor.",
      "media": []
    },
    {
      "id": "typography",
      "title": "Typography",
      "kind": "typography",
      "text": "One family, sans only: ABC Areal by Dinamo. Areal has no Semibold — use 400 for text and 500 for headings, the wordmark and emphasis; 700 is reserved. Use the default a; the alternate a (stylistic set ss01) is not part of the brand. Arimo, which shares Arial's metrics, stands in where Areal can't be loaded.",
      "media": []
    },
    {
      "id": "layout",
      "title": "Layout & Shape",
      "kind": "generic",
      "text": "Grid — 12 columns, 16px gutter, 48px outer margin on desktop. Lay everything on the columns: headers as 4 × 3 columns, modules as 3, 4, 6 or 8. On brand surfaces the grid may show as faint column bands (Ink at 3.5%).\n\nCorners — radius 0 everywhere: buttons, cards, inputs, icons, images. There are no round shapes — even the full stop is square.\n\nRules — 1px Ink hairlines separate rows and sections. No shadows; a raised surface is Document on Paper with a 1px Ink outline.\n\nNumbering — sections and modules carry decimal numbers (1.0, 1.1, 2.0) in 13px Medium.\n\nButtons — Ink fill with Document text, square, 48px tall, weight 500. Secondary actions are underlined Ink text links. Blue is never a button.",
      "media": []
    },
    {
      "id": "resources",
      "title": "Resources",
      "kind": "resources",
      "media": []
    },
    {
      "id": "4u2VJq2l",
      "title": "asdf",
      "kind": "generic",
      "media": []
    }
  ],
  "resources": [
    {
      "label": "usemanual.site",
      "url": "https://usemanual.site/"
    },
    {
      "label": "design.md for coding agents",
      "url": "https://app.usemanual.site/g/manual/design.md"
    },
    {
      "label": "ABC Areal — Dinamo",
      "url": "https://abcdinamo.com/"
    }
  ],
  "houseRules": "This is Manual's own brand — the product at usemanual.site.\nGenerated from lib/manual-guide.ts: edit that file, then run `pnpm brand:design-md`. Don't edit DESIGN.md by hand."
}