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

firebase-data-connect · evanca — скилл для Claude Code: настройка и установка

Скилл помогает настраивать Firebase Data Connect в Flutter, описывать GraphQL-запросы и мутации, подключать типизированный SDK и разбирать офлайн-сценарии.

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

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

Что делает firebase-data-connect

Скилл ведёт по настройке Data Connect в Flutter-проекте: добавлению firebase_data_connect, инициализации Firebase, описанию схемы и операций в GraphQL-файлах. Затем через flutterfire generate создаются типизированные Dart-классы для запросов и мутаций. Их можно выполнять через SDK или слушать обновления запросов в реальном времени.

В инструкциях также есть пагинация, локальное кэширование результатов и обработка ошибок сети и валидации. Для контроля доступа используются директивы @auth и Firebase Authentication. Поддерживаются iOS, Android и Web; другие платформы не поддерживаются, поэтому проверьте целевую платформу до настройки SDK.

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

  • настроить Firebase Data Connect в Flutter-проекте
  • описать GraphQL-схему, запросы и мутации
  • сгенерировать типизированный Dart SDK
  • обработать сетевой сбой и вернуть кэшированные данные
  • ограничить доступ через директивы @auth

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

  • Настрой Firebase Data Connect в моём Flutter-проекте и сгенерируй типизированный SDK.
  • Опиши GraphQL-запрос и мутацию для этой схемы Data Connect.
  • Добавь обработку сетевых ошибок и чтение кэшированных данных при офлайне.

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

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-data-connect -a claude-code

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

~/.claude/skills/firebase-data-connect/SKILL.md

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

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

Вопросы о firebase-data-connect

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

Нет, команда должна быть точной: /plugin.

Что делает firebase-data-connect?

Скилл описывает настройку Firebase Data Connect в Flutter: GraphQL-схемы и операции, генерацию типизированного SDK, обработку ошибок и контроль доступа.

Какие платформы поддерживает настройка из скилла?

Описанная поддержка охватывает iOS, Android и Web. Для других платформ она не предусмотрена.

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

SKILL.md · MIT
---
name: firebase-data-connect
description: "Use when setting up Data Connect, writing GraphQL queries/mutations, configuring generated SDKs, handling offline, or applying security rules."
license: MIT
---

# Firebase Data Connect Skill

This skill defines how to correctly use Firebase Data Connect in Flutter applications.

## When to Use

Use this skill when:

* Setting up and configuring Firebase Data Connect in a Flutter project.
* Designing schemas, queries, and mutations for Data Connect.
* Implementing generated SDK calls for typed queries and mutations.
* Handling network failures, data inconsistencies, and offline scenarios.
* Applying security and performance best practices.

---

## 1. Setup and Configuration

### Step 1: Install the package

```
flutter pub add firebase_data_connect
```

### Step 2: Import and initialize

```dart
import 'package:firebase_data_connect/firebase_data_connect.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);
```

### Step 3: Define a schema in `dataconnect/schema/schema.gql`

```graphql
type Movie @table {
  id: UUID! @default(expr: "uuidV4()")
  title: String!
  releaseYear: Int
  genre: String
  rating: Float
  description: String
}
```

### Step 4: Define queries and mutations in `dataconnect/connector/queries.gql`

```graphql
query ListMovies @auth(level: PUBLIC) {
  movies {
    id
    title
    releaseYear
    genre
    rating
  }
}

mutation CreateMovie($title: String!, $releaseYear: Int, $genre: String) @auth(level: USER) {
  movie_insert(data: {
    title: $title
    releaseYear: $releaseYear
    genre: $genre
  })
}

mutation DeleteMovie($id: UUID!) @auth(level: USER) {
  movie_delete(id: $id)
}
```

### Step 5: Generate the typed Flutter SDK

```
flutterfire generate
```

This produces typed Dart classes for each query and mutation.

**Platform support:**

| Platform | Support |
|---|---|
| iOS | Full |
| Android | Full |
| Web | Full |
| Other platforms | Not supported |

---

## 2. Executing Queries and Mutations

Use the generated SDK to execute typed queries and mutations:

```dart
// Execute a query
final result = await ListMoviesQuery().execute();
final movies = result.data.movies;

// Execute a mutation
await CreateMovieMutation(title: 'Inception', releaseYear: 2010, genre: 'Sci-Fi')
    .execute();

// Delete by ID
await DeleteMovieMutation(id: movieId).execute();
```

### Real-Time Listeners

Subscribe to query changes for live updates:

```dart
final subscription = ListMoviesQuery().subscribe();
subscription.listen((result) {
  final movies = result.data.movies;
  // Update UI with latest movie list
});
```

---

## 3. Performance and Caching

- Design efficient queries requesting only the fields needed to minimize data transfer.
- Implement **pagination** for large datasets:
  ```graphql
  query ListMoviesPaginated($limit: Int!, $offset: Int!) @auth(level: PUBLIC) {
    movies(limit: $limit, offset: $offset) {
      id
      title
      releaseYear
    }
  }
  ```
- Use real-time listeners judiciously to avoid unnecessary network usage.
- Consider **offline capabilities** for critical app functionality by caching query results locally.

---

## 4. Error Handling

Wrap Data Connect calls in try/catch to handle network and validation errors:

```dart
try {
  final result = await ListMoviesQuery().execute();
  return result.data.movies;
} on FirebaseException catch (e) {
  if (e.code == 'unavailable') {
    // Handle offline — return cached data
    return _localCache.getMovies();
  }
  rethrow;
}
```

- Implement **retry logic** with exponential backoff for transient connection errors.
- Provide meaningful error messages for data validation failures.
- Monitor error rates and investigate recurring issues.

---

## 5. Security

- Use `@auth` directives in schema to control access levels (`PUBLIC`, `USER`, `NO_ACCESS`).
- Integrate **Firebase Authentication** for user-based access control.
- Validate data on both client and server sides.
- Follow data privacy best practices when handling user information.

---

## References

- [Firebase Data Connect documentation](https://firebase.google.com/docs/data-connect)
- [Data Connect Flutter SDK reference](https://firebase.google.com/docs/data-connect/flutter-sdk)

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

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

Все скиллы по теме «Бэкенд и API» →

Сначала — firebase-data-connect от других авторов.

firebase-data-connect Google LLC Скилл firebase-data-connect для Claude Code помогает создавать бэкенды Firebase SQL Connect с PostgreSQL. Он включается при проектировании схем, запросов и мутаций или генерации SDK. CX Codex +1 179 900установок firebase-ai-logic-basics Google LLC Скилл firebase-ai-logic-basics подключает Firebase AI Logic к мобильным и веб-приложениям, позволяя вызывать модели Gemini напрямую из клиентского кода без своего бэкенда. CX Codex +1 146 900установок firebase-firestore Google LLC Скилл firebase-firestore для Claude Code настраивает Cloud Firestore, модели данных, индексы и SDK. Помогает добавить или перенести базу данных в приложение. CX Codex +1 146 900установок appwrite-dart appwrite Скилл appwrite-dart подсказывает агенту, как работать с Appwrite из Dart: авторизация, база, файлы, realtime и серверное администрирование. CX Codex +1 1 100установок firebase sickn33 Помогает проектировать архитектуру Firebase, настраивать правила безопасности Firestore и писать Cloud Functions под реальные сценарии запросов. CX Codex +1 1 600установок firebase-apk-scanner trailofbits Скилл firebase-apk-scanner разбирает Android APK, вытаскивает конфиг Firebase и проверяет базы, хранилища и функции на открытый доступ. Нужен при аудите мобильных приложений. CX Codex +1 6 000установок flutter-use-http-package flutter Скилл flutter-use-http-package для Claude Code добавляет в Flutter запросы к REST API через пакет http и обработку JSON-ответов. Загружает и отправляет данные. CX Codex +1 39 100установок

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

Весь набор →
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-storage Скилл firebase-storage содержит инструкции по работе с Firebase Cloud Storage во Flutter: загрузке и скачиванию файлов, управлению метаданными и обработке ошибок. 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звёзд репо firebase-ai Скилл учит агента правильно подключать Firebase AI Logic в Flutter-проекте и писать код для генерации текста и чата через Gemini. CX Codex +1 ★ 674звёзд репо

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

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