# FileList

A named native list of file rows.

Connect Flood once using [the installation guide](https://flood.md/docs/installation). Then import the components you use; no per-component add command is needed.

## Example

```tsx
"use client";

import { FloodRoot, FileList, FileItem } from "@flood-md/react";
import "@flood-md/react/styles.css";

export function Example() {
  return (
    <FloodRoot>
      <FileList label="Attachments">
        <FileItem name="Brand guidelines.pdf" size={2400000} mimeType="PDF" />
        <FileItem name="Logo.svg" size={18400} mimeType="SVG" />
      </FileList>
    </FloodRoot>
  );
}
```

## Design notes

- List contents and file identities are host owned. Narrow list containers adapt media, copy and actions without hiding primitive anatomy, including on a wide screen.
- Use stable host IDs for React keys; a name is not a unique file identity.

## API reference

| Prop | Values | Default |
| --- | --- | --- |
| `density` | `"compact" \| "comfortable"` | `—` |
| `dividers` | `boolean` | `—` |
| `label` | `string` | `Required` |
| `Native HTML props` | `Omit<HTMLAttributes<HTMLUListElement>, "role">` | `Forwarded` |