Concepts
Uploads and Optimistic State
The local provider combines upload intents with optimistic UI so files appear immediately.
The local provider has a dedicated upload zone and upload client helpers.
Typical flow
- request an upload intent or presigned upload
- show an optimistic node in the current folder
- upload the body
- confirm the upload on the server
- reconcile optimistic state with the final node
Why this matters
- users get immediate feedback
- failed uploads can be surfaced precisely
- app code can hook into completion and failure callbacks
Google Drive does not currently expose the same local upload-zone primitives, so treat uploads as provider-specific behavior rather than a universal capability.