Cloud Storage

ShipFlutter uses Firebase Cloud Storage to store and serve user files. The storage module provides a simple interface for common operations like uploading user avatars.

Setup

1. Create a default Cloud Storage bucket in your Firebase Console

2. Deploy the default storage rules:

   firebase deploy --only storage

3. The rules will be deployed from storage.rules:

   rules_version = '2';
   service firebase.storage {
     match /b/{bucket}/o {
       // User files
       match /users/{userId}/{allPaths=**} {
         allow read: if request.auth != null;
         allow write: if request.auth.uid == userId;
       }
     }
   }

Storage Service

The StorageService class provides a type-safe way to interact with Cloud Storage:

Upload

// Upload user avatar
final file = await imagePicker.pickImage(
  source: ImageSource.gallery,
);

if (file != null) {
  final url = await storageService.instance
    .uploadUserAvatar(file);

  // Use the download URL
  print('Avatar URL: $url');
}

Download

// Get avatar URL
final url = await storageService.instance
  .getUserAvatarUrl();

// Display in Image widget
Image.network(url);

Tip

Files are stored in user-specific paths (users/userId/...) and protected by storage rules. Only authenticated users can read files, and only owners can write to their paths.

File Organization

ShipFlutter follows this storage structure:

• Directoryusers/

  • Directory$userId/

    • avatar // User profile picture
    • Directoryfiles/ // User uploaded files

      • …

Each user gets their own storage space under their user ID, ensuring proper isolation and security.