К основному содержанию
скилл CX Codex

firebase-storage — скилл для Claude Code: что делает и как установить

Скилл firebase-storage содержит инструкции по работе с Firebase Cloud Storage во Flutter: загрузке и скачиванию файлов, управлению метаданными и обработке ошибок.

MIT ★ 674 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rules
Открыть на GitHub

Что делает firebase-storage

Скилл содержит готовые шаблоны кода на Dart для интеграции Firebase Cloud Storage в проекты на Flutter. Он задаёт сценарии создания ссылок на бакет, загрузки файлов на диск через putFile, чтения файлов в память через getData, получения публичных URL и удаления объектов.

Описаны методы работы с метаданными через SettableMetadata, отслеживание прогресса загрузки с событиями snapshotEvents, а также приостановка и отмена задач. Для работы с хранилищем Firebase требует тарифный план Blaze (pay-as-you-go). В инструкцию включена таблица кодов ошибок FirebaseException с рекомендациями по повторным попыткам при сбоях сети.

Какие задачи решает

  • настроить загрузку файлов во Flutter через putFile
  • отслеживать процент загрузки файла и управлять отменой задачи
  • сохранить пользовательские метаданные файла через SettableMetadata
  • обработать ошибки FirebaseException при превышении квоты или сбое авторизации

Примеры запросов агенту

  • Напиши функцию загрузки аватарки в Firebase Storage с отслеживанием прогресса
  • Добавь обработку ошибок FirebaseException при скачивании файла из бакета
  • Покажи, как сохранить customMetadata для файла во Flutter

Как установить firebase-storage

1Через маркетплейс плагинов

/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rules

Команда ставит плагин flutter-ai-skills целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add evanca/flutter-ai-rules --skill firebase-storage -a claude-code

3Вручную: положить файлы

~/.claude/skills/firebase-storage/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/firebase-storage/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о firebase-storage

Как установить firebase-storage в Claude Code?

Запустите в чате /plugin marketplace add evanca/flutter-ai-rules, а затем выполните /plugin install flutter-ai-skills@flutter-ai-rules.

Что делает этот скилл?

Он задаёт модели правила написания кода для Firebase Cloud Storage во Flutter, включая загрузку, скачивание, метаданные и контроль прогресса.

Какой тариф Firebase нужен для работы хранилища?

Для использования Cloud Storage в проекте требуется платный тариф Blaze (pay-as-you-go).

Исходный текст

SKILL.md · MIT
---
name: firebase-storage
description: "Use when setting up Storage, uploading/downloading files, managing metadata, handling errors, or applying security rules."
license: MIT
---

# Firebase Cloud Storage Skill

This skill defines how to correctly use Firebase Cloud Storage in Flutter applications.

## When to Use

Use this skill when:

* Setting up Cloud Storage in a Flutter project.
* Uploading or downloading files.
* Managing file metadata.
* Handling Storage errors and monitoring upload progress.

---

## 1. Setup and Configuration

```
flutter pub add firebase_storage
```

```dart
import 'package:firebase_storage/firebase_storage.dart';

final storage = FirebaseStorage.instance;
// Or specify a bucket explicitly:
// final storage = FirebaseStorage.instanceFor(bucket: "gs://BUCKET_NAME");
```

- Firebase Storage requires the **Blaze (pay-as-you-go) plan**.
- Run `flutterfire configure` to update your Firebase config with the default Storage bucket name.

> **Security note:** By default, a Cloud Storage bucket requires Firebase Authentication for any action. Configuring public access may also make App Engine files publicly accessible — restrict access again when you set up Authentication.

---

## 2. File Operations

**Create a reference:**

```dart
final storageRef = FirebaseStorage.instance.ref();
final fileRef = storageRef.child("uploads/file.jpg");
```

**Upload:**

```dart
final uploadTask = fileRef.putFile(file);
final snapshot = await uploadTask;
final downloadUrl = await snapshot.ref.getDownloadURL();
```

**Download (in-memory):**

```dart
final data = await fileRef.getData();
```

**Download URL:**

```dart
final downloadUrl = await fileRef.getDownloadURL();
```

**Delete:**

```dart
await fileRef.delete();
```

---

## 3. Metadata Management

**Get metadata:**

```dart
final metadata = await fileRef.getMetadata();
print('Content type: ${metadata.contentType}');
print('Size: ${metadata.size}');
```

**Update metadata:**

```dart
final newMetadata = SettableMetadata(
  contentType: "image/jpeg",
  customMetadata: {'uploaded_by': 'user123'},
);
await fileRef.updateMetadata(newMetadata);
```

Use **custom metadata** to store additional key/value pairs with your files.

---

## 4. Error Handling

Use `try-catch` with `FirebaseException`. Key error codes:

| Code | Meaning |
|---|---|
| `storage/object-not-found` | File doesn't exist at the reference |
| `storage/bucket-not-found` | No bucket configured for Cloud Storage |
| `storage/project-not-found` | No project configured for Cloud Storage |
| `storage/quota-exceeded` | Storage quota exceeded |
| `storage/unauthenticated` | User needs to authenticate |
| `storage/unauthorized` | User lacks permission |
| `storage/retry-limit-exceeded` | Operation timeout exceeded |

- For `quota-exceeded` on the Spark plan, upgrade to Blaze.
- Implement retry logic for network-related errors and timeouts.

---

## 5. Performance and Best Practices

**Monitor upload progress:**

```dart
final uploadTask = fileRef.putFile(file);
uploadTask.snapshotEvents.listen((TaskSnapshot snapshot) {
  print('Progress: ${(snapshot.bytesTransferred / snapshot.totalBytes) * 100}%');
});
```

- **Cancel** uploads with `uploadTask.cancel()`.
- **Pause / resume** with `uploadTask.pause()` and `uploadTask.resume()`.
- Optimize file sizes before upload to reduce costs and improve performance.
- Use Cloud Storage with Firestore for comprehensive data management.
- Use the **Firebase Local Emulator Suite** for local development and testing.

---

## 6. Security

- Use **Firebase Security Rules** to control access to files.
- Combine Storage rules with **Firebase Authentication** for user-based access control.
- Test security rules thoroughly before deploying to production.

---

## References

- [Firebase Cloud Storage Flutter documentation](https://firebase.google.com/docs/storage/flutter/start)
- [Upload files](https://firebase.google.com/docs/storage/flutter/upload-files)
- [Download files](https://firebase.google.com/docs/storage/flutter/download-files)
- [Handle errors](https://firebase.google.com/docs/storage/flutter/handle-errors)

© Ivanna Kaceviča · MIT · evanca/flutter-ai-rules

Похожие скиллы

Все скиллы по теме «Мобильная разработка» →
firebase-ai-logic-basics Google LLC Скилл firebase-ai-logic-basics подключает Firebase AI Logic к мобильным и веб-приложениям, позволяя вызывать модели Gemini напрямую из клиентского кода без своего бэкенда. CX Codex +1 146 900установок firebase alinaqi Скилл подсказывает, как строить Firebase-приложения с Firestore, Auth, Storage и правилами безопасности. Срабатывает при работе с Firebase-файлами. CX Codex +1 305установок firebase-crashlytics Google LLC Помогает настроить Firebase Crashlytics и SDK для отчётов о сбоях. Запускается при добавлении Crashlytics в Android, iOS или Web-приложение. CX Codex +1 142 900установок firebase-apk-scanner trailofbits Скилл firebase-apk-scanner разбирает Android APK, вытаскивает конфиг Firebase и проверяет базы, хранилища и функции на открытый доступ. Нужен при аудите мобильных приложений. CX Codex +1 6 000установок firebase-basics официальный google Скилл firebase-basics настраивает Firebase CLI, помогает войти в аккаунт, создать или выбрать проект и скачать конфигурацию Android или iOS. CX Codex +1 14 100установок firebase-development Mindrally Скилл firebase-development задаёт правила разработки под Firebase на TypeScript и Angular: от архитектуры коллекций Firestore до тестов правил безопасности. CX Codex +1 732установок

Из того же набора39

Весь набор →
flutter-change-notifier Скилл flutter-change-notifier учит агента правильно использовать ChangeNotifier и provider для управления состоянием во Flutter: модель, провайдер, Consumer, оптимизация ребилдов. CX Codex +1 ★ 674звёзд репо provider Скилл учит нейросеть грамотно использовать пакет provider во Flutter: от настройки связок до точечной перерисовки UI. CX Codex +1 ★ 674звёзд репо mockito Скилл mockito для Claude Code помогает писать тесты Dart и Flutter с моками: генерировать классы, задавать ответы и проверять вызовы. Он подключается к задачам с Mockito. CX Codex +1 ★ 674звёзд репо developing-genkit-dart Скилл developing-genkit-dart для разработки AI-агентов на Genkit Dart: подсказывает агенту, когда загружать справки по ядру фреймворка и плагинам Genkit. CX Codex +1 ★ 674звёзд репо firebase-data-connect Скилл помогает настраивать Firebase Data Connect в Flutter, описывать GraphQL-запросы и мутации, подключать типизированный SDK и разбирать офлайн-сценарии. CX Codex +1 ★ 674звёзд репо firebase-remote-config Скилл для Flutter-приложений: агент подключает Firebase Remote Config — фича-флаги, значения по умолчанию, A/B-тесты и обновления конфига без релиза. CX Codex +1 ★ 674звёзд репо firebase-cloud-functions Помогает агенту писать код для вызова Firebase Cloud Functions во Flutter: обработка ошибок, таймауты и работа с эмулятором. CX Codex +1 ★ 674звёзд репо testing Скилл testing помогает писать и проверять unit- и widget-тесты для Flutter и Dart, разбирать flaky-тесты и выбирать подходящий тип проверки. CX Codex +1 ★ 674звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой