firebase-data-connect · evanca — скилл для Claude Code: настройка и установка
Скилл помогает настраивать Firebase Data Connect в Flutter, описывать GraphQL-запросы и мутации, подключать типизированный SDK и разбирать офлайн-сценарии.
MIT ★ 674 обновлён 2026-10-29
/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rulesЧто делает 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-code3Вручную: положить файлы
~/.claude/skills/firebase-data-connect/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/firebase-data-connect/
1Через Skills CLI (Vercel)
npx skills add evanca/flutter-ai-rules --skill firebase-data-connect -a codex2Вручную: положить файлы
.agents/skills/firebase-data-connect/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add evanca/flutter-ai-rules --skill firebase-data-connect -a cursor2Вручную: положить файлы
.cursor/skills/firebase-data-connect/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install evanca/flutter-ai-rules skills/firebase-data-connect2Вручную: положить файлы
.github/skills/firebase-data-connect/SKILL.md1Через Skills CLI (Vercel)
npx skills add evanca/flutter-ai-rules --skill firebase-data-connect -a gemini-cli2Командой платформы
gemini skills install https://github.com/evanca/flutter-ai-rules --path skills/firebase-data-connectВручную: положить файлы
.devin/skills/firebase-data-connect/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.