# `Mob.Files`
[🔗](https://github.com/genericjam/mob/blob/main/lib/mob/files.ex#L1)

System file picker. Opens the OS document picker (Files app on iOS, SAF on Android).

No permission required — the user explicitly selects files.

Results arrive as:

    handle_info({:files, :picked,    items},   socket)
    handle_info({:files, :cancelled},           socket)

Each item in `items` is:

    %{path: "/tmp/mob_file_xxx.pdf", name: "report.pdf",
      mime: "application/pdf", size: 102400}

iOS: `UIDocumentPickerViewController`. Android: `OpenMultipleDocuments`.

# `pick`

```elixir
@spec pick(
  Mob.Socket.t(),
  keyword()
) :: Mob.Socket.t()
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*