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

firebase-database — скилл для Claude Code: работа с Realtime Database

Скилл firebase-database помогает проектировать структуру Firebase Realtime Database и работать с чтением, записями, синхронизацией и правилами доступа в приложениях 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-database

Скилл описывает работу с Firebase Realtime Database в приложениях Flutter: как уплощать JSON-дерево, выбирать запросы и получать обновления через слушатели. Он также охватывает офлайн-режим, статус присутствия пользователей и правила безопасности. При сложных запросах и богатой модели данных в тексте советуют выбрать Cloud Firestore.

Перед обращением к базе нужно дождаться Firebase.initializeApp(), а настройку сохранения данных выполнить до операций чтения и записи. Запросы по умолчанию возвращают всё поддерево; один запрос не может одновременно фильтровать и сортировать данные. Поэтому структуру путей и правила индексации стоит согласовать с нужными запросами заранее.

Для изменений можно использовать set(), update() и транзакции, а для синхронизации — слушатели onValue; подписку можно отменить. Скилл также описывает атомарное обновление нескольких путей, временные метки сервера и очистку статуса через onDisconnect().

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

  • спроектировать плоскую структуру JSON для базы
  • подписать экран Flutter на изменения данных
  • обновить несколько путей одной операцией
  • настроить офлайн-доступ и статус присутствия
  • подобрать запросы и индексы для часто читаемых полей

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

  • Спроектируй структуру Realtime Database для комнат и сообщений, чтобы данные комнаты читались отдельно от сообщений.
  • Покажи, как подписать экран на изменения users/123 и отменить подписку, когда экран закрывается.
  • Настрой офлайн-сохранение и статус присутствия пользователя через onDisconnect().

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

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-database -a claude-code

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

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

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

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

Вопросы о firebase-database

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

Добавьте маркетплейс командой /plugin marketplace add evanca/flutter-ai-rules, затем установите плагин командой /plugin install flutter-ai-skills@flutter-ai-rules.

Что делает скилл firebase-database?

Он помогает реализовать Firebase Realtime Database в приложении Flutter: моделировать JSON-данные, выполнять запросы и записи, подключать слушатели, офлайн-режим и правила безопасности.

Когда вместо Realtime Database выбрать Cloud Firestore?

В описании советуют Cloud Firestore для богатых моделей данных, которым нужны сложные запросы и высокая масштабируемость.

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

SKILL.md · MIT
---
name: firebase-database
description: "Use when syncing real-time data, structuring JSON trees, reading/writing, creating listeners, enabling offline persistence, managing presence, sharding, or writing security rules."
license: MIT
---

# Firebase Realtime Database Skill

This skill defines how to correctly implement Firebase Realtime Database in Flutter applications, covering data modeling, queries, real-time sync, offline support, and security rules.

## When to Use

Use this skill when working with Firebase Realtime Database for **simple data models**, **low-latency sync**, or **presence functionality**. For rich data models requiring complex queries and high scalability, use Cloud Firestore instead.

---

## 1. Database Selection

Choose **Realtime Database** when the app needs:
- Simple data models with simple lookups.
- Extremely low-latency synchronization (typical response times under 10ms).
- Deep queries that return an entire subtree by default.
- Access to data at any granularity, down to individual leaf-node values.
- Frequent state-syncing with built-in presence functionality.

Choose **Cloud Firestore** instead for rich data models requiring queryability, scalability, and high availability.

---

## 2. Setup and Configuration

```
flutter pub add firebase_database
```

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

// After Firebase.initializeApp():
final DatabaseReference ref = FirebaseDatabase.instance.ref();
```

- Select the database location closest to users.
- Enable persistence for offline capabilities:

```dart
FirebaseDatabase.instance.setPersistenceEnabled(true);
FirebaseDatabase.instance.setPersistenceCacheSizeBytes(10000000); // 10MB
```

### Setup Checklist

1. Confirm `Firebase.initializeApp()` completes before accessing `FirebaseDatabase.instance`.
2. Set persistence **before** any read/write operations.
3. Verify connectivity by writing a test value and reading it back.

---

## 3. Data Structure

- Structure data as a **flattened JSON tree** — avoid deep nesting.
- Maximum nesting depth is **32 levels**.
- Design the data structure to support the most common queries.
- Use **push IDs** for unique identifiers in list-type data:

```dart
final newPostKey = FirebaseDatabase.instance.ref().child('posts').push().key;
```

- **Denormalize** data when necessary — Realtime Database does not support joins.
- Custom keys must be UTF-8 encoded, max 768 bytes, and cannot contain `.` `$` `#` `[` `]` `/` or ASCII control characters 0-31 or 127.

### Flattened Structure Example

```dart
// Instead of nesting chat messages inside rooms:
// rooms/roomId/messages/messageId/...

// Flatten into separate top-level paths:
// rooms/roomId: { name: "General", createdBy: "uid1" }
// room-members/roomId: { uid1: true, uid2: true }
// room-messages/roomId/messageId: { text: "Hello", sender: "uid1", timestamp: ... }
```

This pattern allows reading room metadata without downloading all messages.

---

## 4. Indexing and Querying

- Queries can sort **or** filter on a property, but not both in the same query.
- Use `.indexOn` in security rules to index frequently queried fields:

```json
{
  "rules": {
    "dinosaurs": {
      ".indexOn": ["height", "length"]
    }
  }
}
```

- Queries are **deep** by default and return the entire subtree.
- Sort with `orderByChild()`, `orderByKey()`, or `orderByValue()`:

```dart
final query = FirebaseDatabase.instance.ref("dinosaurs").orderByChild("height");
```

- Limit results with `limitToFirst()` or `limitToLast()`:

```dart
final query = ref.orderByChild("height").limitToFirst(10);
```

- Range queries using `startAt()`, `endAt()`, and `equalTo()`:

```dart
// Find users whose name starts with "A"
final query = ref.child("users")
    .orderByChild("name")
    .startAt("A")
    .endAt("A\uf8ff");
```

---

## 5. Read and Write Operations

**Read once:**

```dart
final snapshot = await FirebaseDatabase.instance.ref('users/123').get();
if (snapshot.exists) {
  print(snapshot.value);
}
```

**Real-time listener:**

```dart
final subscription = FirebaseDatabase.instance
    .ref('users/123')
    .onValue
    .listen((event) {
      final data = event.snapshot.value;
      print(data);
    });

// Cancel when no longer needed:
subscription.cancel();
```

A `DatabaseEvent` fires every time data changes at the reference, including changes to children.

**Write (replace):**

```dart
await ref.set({
  "name": "John",
  "age": 18,
  "created_at": ServerValue.timestamp,
});
```

**Update (partial):**

```dart
await ref.update({"age": 19});
```

**Atomic transaction:**

```dart
final result = await FirebaseDatabase.instance
    .ref('posts/123/likes')
    .runTransaction((currentValue) {
      return Transaction.success((currentValue as int? ?? 0) + 1);
    });
print('Likes: ${result.snapshot.value}');
```

**Multi-path atomic update:**

```dart
final updates = <String, dynamic>{
  'posts/$postId': postData,
  'user-posts/$uid/$postId': postData,
};
await FirebaseDatabase.instance.ref().update(updates);
```

- Keep individual write operations under **256KB**.
- Use listeners for real-time updates rather than polling.

---

## 6. Designing for Scale

- Realtime Database scales to ~200,000 concurrent connections and 1,000 writes/second per database. For higher scale, **shard** data across multiple database instances.
- Avoid storing large blobs — use **Firebase Storage** for files.
- Use **server timestamps** for consistent time tracking:

```dart
await FirebaseDatabase.instance.ref('posts/123/timestamp').set(ServerValue.timestamp);
```

- Implement **fan-out patterns** for data accessed from multiple paths.
- Avoid deep nesting — it leads to performance issues when retrieving data.

---

## 7. Offline Capabilities and Presence

```dart
FirebaseDatabase.instance.setPersistenceEnabled(true);

// Keep critical paths synced when offline
FirebaseDatabase.instance.ref('important-data').keepSynced(true);
```

### Connection State and Presence

```dart
// Detect connection state
FirebaseDatabase.instance.ref('.info/connected').onValue.listen((event) {
  final connected = event.snapshot.value as bool? ?? false;
  if (connected) {
    // Set online status and configure onDisconnect cleanup
    final presenceRef = FirebaseDatabase.instance.ref('status/${uid}');
    presenceRef.set({'online': true, 'last_seen': ServerValue.timestamp});
    presenceRef.onDisconnect().set({
      'online': false,
      'last_seen': ServerValue.timestamp,
    });
  }
});
```

- Use value events (`onValue`) to read data and get notified of updates — optimized for online/offline transitions.
- Use `get()` only when data is needed once; it probes local cache if the server is unavailable.
- `onDisconnect()` operations are executed server-side, ensuring cleanup even if the app crashes.

---

## 8. Security

```json
{
  "rules": {
    "users": {
      "$uid": {
        ".read": "$uid === auth.uid",
        ".write": "$uid === auth.uid"
      }
    }
  }
}
```

- Use `.read`, `.write`, `.validate`, and `.indexOn` to control access and validate data.
- Read and write rules **cascade** in Realtime Database — a parent rule granting access cannot be revoked by a child rule.
- Use the `auth` variable to authenticate users in security rules.

### Data Validation Example

```json
{
  "rules": {
    "messages": {
      "$messageId": {
        ".validate": "newData.hasChildren(['text', 'sender', 'timestamp'])",
        "text": {
          ".validate": "newData.isString() && newData.val().length <= 500"
        }
      }
    }
  }
}
```

- Test rules thoroughly using the Firebase console's rules simulator.
- Use the **Firebase Emulator Suite** for local testing.

---

## References

- [Firebase Realtime Database Flutter documentation](https://firebase.google.com/docs/database/flutter/start)
- [Structure data](https://firebase.google.com/docs/database/flutter/structure-data)
- [Read and write data](https://firebase.google.com/docs/database/flutter/read-and-write)

© 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-data-connect Google LLC Скилл firebase-data-connect для Claude Code помогает создавать бэкенды Firebase SQL Connect с PostgreSQL. Он включается при проектировании схем, запросов и мутаций или генерации SDK. CX Codex +1 179 900установок 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установок firebase-development Mindrally Скилл firebase-development задаёт правила разработки под Firebase на TypeScript и Angular: от архитектуры коллекций Firestore до тестов правил безопасности. CX Codex +1 732установок firebase-app-platform devops-skills Скилл firebase-app-platform для Claude Code подключает знания о Firebase: агент пишет правила безопасности, настраивает триггеры и деплоит бэкенды через firebase deploy. CX Codex +1 347установок

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

Весь набор →
flutter-app-architecture Скилл flutter-app-architecture задаёт правила многослойной архитектуры Flutter-проекта: MVVM, репозитории, сервисы и однонаправленный поток данных. CX Codex +1 ★ 674звёзд репо riverpod Скилл помогает писать Flutter- и Dart-код с Riverpod: настраивать провайдеры, управлять их жизненным циклом и проверять их тестами. Пригодится при работе с состоянием приложения. CX Codex +1 ★ 674звёзд репо architecture-feature-first Скилл architecture-feature-first задаёт слоистую feature-first архитектуру для Flutter: где лежит UI, где данные и когда нужен доменный слой. CX Codex +1 ★ 674звёзд репо inclusive-design Скилл inclusive-design помогает проектировать интерфейсы с учётом медленного интернета, дешёвых смартфонов, нестандартных имён и низкого цифрового опыта. Не заменяет WCAG. CX Codex +1 ★ 674звёзд репо dart-3-updates Скилл dart-3-updates для Claude Code и Codex учит ИИ писать switch-выражения, паттерны, records и modern Dart вместо старых if-else цепочек. Помогает при рефакторинге кода под Dart 3 и выборе между records и классами. CX Codex +1 ★ 674звёзд репо effective-dart Скилл effective-dart задаёт правила чистого кода на Dart и Flutter: стиль имён, явные типы, оформление документации и структуру тестов. CX Codex +1 ★ 674звёзд репо accessibility Скилл accessibility разбирает задачу по чек-листу WCAG — клавиатура, скринридер, контраст, формы — и находит конкретные нарушения доступности. Включается по словам a11y, ARIA, alt text, focus order, contrast. CX Codex +1 ★ 674звёзд репо firebase-cloud-firestore Скилл firebase-cloud-firestore учит агента настраивать Cloud Firestore во Flutter-проекте: схему данных, запросы, листенеры и правила безопасности. CX Codex +1 ★ 674звёзд репо

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

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