

<InteractiveDemo
  name="file-trigger"
  controls="[
  {
    type: 'boolean',
    name: 'allowsMultiple',
    defaultValue: false,
  },
]"
/>

## Installation [#installation]

<CodeBlockTabs defaultValue="npm">
  <CodeBlockTabsList>
    <CodeBlockTabsTrigger value="npm">
      npm
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="pnpm">
      pnpm
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="yarn">
      yarn
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="bun">
      bun
    </CodeBlockTabsTrigger>
  </CodeBlockTabsList>

  <CodeBlockTab value="npm">
    ```bash
    npx shadcn@latest add @dotui/file-trigger
    ```
  </CodeBlockTab>

  <CodeBlockTab value="pnpm">
    ```bash
    pnpm dlx shadcn@latest add @dotui/file-trigger
    ```
  </CodeBlockTab>

  <CodeBlockTab value="yarn">
    ```bash
    yarn dlx shadcn@latest add @dotui/file-trigger
    ```
  </CodeBlockTab>

  <CodeBlockTab value="bun">
    ```bash
    bun x shadcn@latest add @dotui/file-trigger
    ```
  </CodeBlockTab>
</CodeBlockTabs>

## Usage [#usage]

Use file triggers to allow users to upload files using any pressable element.

```tsx
import { Button } from '@/components/ui/button'
import { FileTrigger } from '@/components/ui/file-trigger'
```

```tsx
<FileTrigger onSelect={(e) => console.log(e)}>
  <Button>Upload File</Button>
</FileTrigger>
```

## Examples [#examples]

<Examples>
  <Example name="file-trigger/demos/default" />

  <Example name="file-trigger/demos/multiple-files" />

  <Example name="file-trigger/demos/file-types" />

  <Example name="file-trigger/demos/directory-selection" />

  <Example name="file-trigger/demos/media-capture" />
</Examples>

## API Reference [#api-reference]

<Reference name="file-trigger" />
