| Do | Always specify an accept prop to guide users toward valid file types. |
| Do | Use maxSize and maxFiles to prevent oversized uploads; the component handles validation and error display automatically. |
| Do | Add a description to communicate constraints like file size limits or accepted formats. |
| Do | Use changeAction for immediate upload workflows that benefit from optimistic UI. |
| Don't | Don't use FileInput for directory or folder uploads; that is not supported in v1. |
| Don't | Don't avoid dropzone mode unless space is constrained; drag-and-drop is the expected interaction for file uploads. |