object-storage

Use a two-step presigned URL flow: the client sends JSON metadata to POST /api/storage/uploads/request-url, receives a presigned GCS URL, then uploads the file directly to Google Cloud Storage with a PUT request. The backend never handles file bytes.

The server generates a presigned PUT URL via the Replit sidecar endpoint, valid for 900 seconds. The client uploads file bytes directly to that URL, bypassing the backend entirely. The returned objectPath is stored in your database for later serving.

No, this Skill is for web stacks only (Express plus React with Vite). For Expo or React Native mobile apps, use the expo_object_storage blueprint instead, which provides Expo-specific client utilities and avoids incompatible web libraries.

Set up Replit Auth first, then uncomment the auth check block in routes/storage.ts to guard endpoints with req.isAuthenticated(). Use req.user.id as the owner when setting ACL policies via the objectAcl.ts framework. PostgreSQL is also required for protected uploads.

Uppy v5 declares react>=19 as a peer dependency while the project uses React 18. Add pnpm overrides for react and react-dom in the root package.json to force a single React version, then run pnpm install.

This error indicates the cloud budget has been exceeded for object storage. Inform the user about the budget limit and call the notify_cloud_budget_exceeded tool with service_name set to object_storage. Do not use this handling for other error types.