# Site Footer

- Page: <https://kznlabs.github.io/labsUI/components/site-footer>

## Site Footer (`site-footer`, block)

Server-safe page footer: brand, description and actions, link columns under one navigation, and a legal line. Every part is optional; the layout follows the width of its container.

- Install: `npx @kznlabs/labsui add site-footer`
- Docs: <https://kznlabs.github.io/labsUI/components/site-footer>
- Brings: link, utils
- npm: clsx@^2.1.1, tailwind-merge@^3.7.0

### API

- `<SiteFooter>` (+ <footer> props): Page footer: brand, link columns and a legal line. Every part is optional.
  - `actions?: ReactNode`: Controls under the description, e.g. social links or a ThemeToggle.
  - `brand?: ReactNode`: Logo link, e.g. `<a href="/">Acme</a>`.
  - `columns?: SiteFooterColumn[]`: Link columns, left to right.
  - `description?: ReactNode`: One or two lines under the brand.
  - `label?: string` = `"Footer"`: Accessible name of the links' navigation.
  - `legal?: ReactNode`: Bottom line: copyright, company details, legal links.
  - `onNavigate?: (href: string, event: MouseEvent<HTMLAnchorElement, MouseEvent>) => void`: `onClick` for every column link, e.g. for client routing or to stub links in a demo.

- `type SiteFooterColumn = { title: string; links: { label: string; href: string }[]; }`

### Usage

```tsx
<SiteFooter brand={<a href="/">Acme</a>} columns={[{ title: "Product", links: [{ label: "Pricing", href: "/pricing" }] }]} legal="© 2026 Acme" />
```

### Example: footer.tsx

```tsx
import { SiteFooter } from "@/components/blocks/site-footer";
import { ThemeToggle } from "@/components/ui/theme-toggle";

export function Footer() {
  return (
    <SiteFooter
      brand={<a href="/">Acme</a>}
      description="Clips, bots and merch for game communities."
      actions={<ThemeToggle />}
      columns={[
        {
          title: "Product",
          links: [
            { label: "Clips", href: "/clips" },
            { label: "Shop", href: "/shop" },
          ],
        },
        {
          title: "Company",
          links: [
            { label: "About", href: "/about" },
            { label: "Blog", href: "/blog" },
          ],
        },
      ]}
      legal="© 2026 Acme"
    />
  );
}
```
