fragments.manifest.json

{
  "schemaVersion": 1,
  "designSystem": { "packageName": "@usefragments/ui", "importPath": "@usefragments/ui" },
  "tokens": { "prefix": "--fui-", "rule": "no-raw-values" },
  "primitives": [
    {
      "name": "Button",
      "members": ["Root"],
      "intents": ["action", "submit", "cta", "primary", "secondary", "destructive"],
      "props": ["as", "asChild", "fullWidth", "icon", "size", "variant"],
      "do": ["one primary per view", "verbs right-aligned", "at most two per cluster"],
      "dont": ["raw <button>", "clickable div", "three or more in a row: use Menu"],
      "exemplar": "apps/cloud/src/components/onboarding/StepScan.tsx:282"
    }
  ],
  "patterns": [
    {
      "name": "PageMasthead",
      "intent": "top of a page: one status sentence and one primary action",
      "primitives": ["Main", "Text", "Button"],
      "shape": "Main.Header > Text(statement) + Button(primary)",
      "exemplar": "apps/cloud/src/page/contract/components/contract-masthead.tsx:112"
    }
  ],
  "grammar": [
    { "rule": "The top of a page carries one status sentence and one primary action; competing important cards are a defect." },
    { "rule": "Verb clusters are right-aligned and hold at most two Buttons; the third verb and later go in a Menu.", "check": "composition/cardinality" },
    { "rule": "Never nest a Card inside a Card.", "check": "composition/co-occurrence" }
  ],
  "rules": { "preset": "fragments", "off": [] }
}