File Picker

Good fit

• selecting a single image or asset
• attaching multiple documents to a record
• replacing ad-hoc upload widgets with a reusable picker

Suggested pattern

• open a Drive dialog or sheet
• keep list and grid modes available
• return selected node IDs or URLs to the parent form

Implementation notes

• use selectionConditions to prevent folders or unsupported file types from being picked
• reset row selection after confirm
• use getURL or provider-native links only when the picker needs a preview
• keep upload enabled when the picker should also create new assets on the fly

Good local-provider fit

The local provider is usually the better picker backend when you need predictable:

• private asset access
• upload lifecycle hooks
• app-specific metadata enrichment