{
  "id": "container",
  "name": "Container",
  "level": "atom",
  "status": "stable",
  "purpose": "Keeps a page to a readable width, from prose to fluid.",
  "description": "Page-width primitive. Picks one of the system's container widths, applies the page gutter and centers itself. Pair with `<Grid>` for the column system.",
  "role": "surface",
  "import": "@rrios-forge/ui/atoms/container",
  "exports": [
    "Container",
    "CONTAINER_PADDINGS",
    "CONTAINER_SIZES",
    "containerVariants"
  ],
  "source": "packages/ui/src/atoms/container",
  "axes": [
    {
      "axis": "size",
      "part": null,
      "values": [
        "prose",
        "sm",
        "md",
        "lg",
        "xl",
        "fluid"
      ],
      "default": "lg",
      "meaning": "Ergonomic scale, in three families (control, text, container)."
    },
    {
      "axis": "padding",
      "part": null,
      "values": [
        "none",
        "sm",
        "md",
        "lg"
      ],
      "default": "md",
      "meaning": "Inner spacing of a container."
    },
    {
      "axis": "centered",
      "part": null,
      "values": [
        "true",
        "false"
      ],
      "default": "true",
      "meaning": "Container centres itself."
    }
  ],
  "needs": [
    {
      "need": "Responsive grid / max-width container",
      "answer": "`Grid` / `Container`"
    }
  ],
  "patterns": [],
  "a11yExceptions": [],
  "decisions": [
    {
      "id": "ADR-008",
      "title": "Layout layer: refined `Grid` + new `Container`"
    },
    {
      "id": "ADR-009",
      "title": "Editorial Frame: PageShell v3 + new `TopBar` molecule"
    },
    {
      "id": "ADR-013",
      "title": "PageShell: mobile-nav polymorphism"
    },
    {
      "id": "ADR-029",
      "title": "The page gutter belongs outside the frame"
    }
  ],
  "stories": [
    {
      "name": "Playground",
      "id": "components-atoms-container--playground",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-atoms-container--playground",
      "frame": "/iframe.html?id=components-atoms-container--playground&viewMode=story"
    },
    {
      "name": "Sizes",
      "id": "components-atoms-container--sizes",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-atoms-container--sizes",
      "frame": "/iframe.html?id=components-atoms-container--sizes&viewMode=story"
    },
    {
      "name": "Prose width",
      "id": "components-atoms-container--prose",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-atoms-container--prose",
      "frame": "/iframe.html?id=components-atoms-container--prose&viewMode=story"
    },
    {
      "name": "Fluid",
      "id": "components-atoms-container--fluid",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-atoms-container--fluid",
      "frame": "/iframe.html?id=components-atoms-container--fluid&viewMode=story"
    }
  ],
  "storyFile": "tooling/storybook/stories/components/atoms/container.stories.tsx"
}
