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

firebase-remote-config — скилл для Claude Code и Codex: фича-флаги

Скилл для Flutter-приложений: агент подключает Firebase Remote Config — фича-флаги, значения по умолчанию, A/B-тесты и обновления конфига без релиза.

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

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

Что делает firebase-remote-config

Скилл описывает, как агенту подключать Remote Config в приложении на Flutter: настройки SDK, параметры по умолчанию, получение и активацию значений, обновления в реальном времени. Внутри — разделы по установке пакетов, работе с типизированными геттерами и проверке статуса последней загрузки.

Агент ставит firebase_remote_config, а для условного таргетинга ещё и firebase_analytics: без включённой аналитики в проекте Firebase правила по аудиториям не сработают. Отдельно оговорены fetchTimeout и minimumFetchInterval, значения по умолчанию через setDefaults и то, что ключи и значения видны конечным пользователям — секреты туда не кладут.

Есть нюансы платформ и лимитов. Real-time обновления не работают в Web, на macOS нужно включить Keychain Sharing в Xcode, а частые загрузки упираются в троттлинг: в продакшене интервал по умолчанию 12 часов, короткий советуют только для debug-сборок.

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

  • включить фича-флаг без релиза приложения
  • задать значения по умолчанию, чтобы экран не падал до первой загрузки
  • подтянуть параметры с сервера и применить их одним вызовом
  • прогнать A/B-тест на разных сегментах пользователей
  • не упереться в троттлинг частых загрузок и квоты

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

  • Добавь фича-флаг feature_new_onboarding через Firebase Remote Config и прочитай его в виджете
  • Настрой setDefaults для параметров и обработай lastFetchStatus после fetchAndActivate
  • Сделай обновление конфига в реальном времени через onConfigUpdated и обнови состояние экрана

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

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-remote-config -a claude-code

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

~/.claude/skills/firebase-remote-config/SKILL.md

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

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

Вопросы о firebase-remote-config

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

Добавьте маркетплейс командой /plugin marketplace add evanca/flutter-ai-rules, затем поставьте набор: /plugin install flutter-ai-skills@flutter-ai-rules. Файл скилла окажется в ~/.claude/skills/firebase-remote-config/SKILL.md.

Что делает firebase-remote-config?

Задаёт агенту правила работы с Firebase Remote Config во Flutter: установка пакетов, параметры по умолчанию, типизированные геттеры, fetchAndActivate, обновления в реальном времени и проверка троттлинга.

Что должно быть включено помимо самого пакета?

Google Analytics в проекте Firebase — иначе не будет таргетинга по свойствам и аудиториям. Ещё нужно, чтобы не был отключён REST API Remote Config, а на macOS — Keychain Sharing в Xcode.

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

SKILL.md · MIT
---
name: firebase-remote-config
description: "Use when implementing feature flags, running A/B tests, setting parameter defaults, fetching/activating config, or enabling real-time config updates."
license: MIT
---

# Firebase Remote Config Skill

This skill defines how to correctly use Firebase Remote Config in Flutter applications.

## When to Use

Use this skill when:

* Implementing feature flags or remote configuration without deploying app updates.
* Managing parameter defaults and fetching remote values.
* Implementing real-time config updates for instant changes.
* Setting up A/B testing or conditional targeting for user segments.

---

## 1. Setup and Configuration

```
flutter pub add firebase_remote_config
flutter pub add firebase_analytics  # required for conditional targeting of app instances
```

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

final remoteConfig = FirebaseRemoteConfig.instance;
```

- Enable **Google Analytics** in the Firebase project for user property and audience targeting.
- Ensure the **Remote Config REST API** is not disabled — the SDK depends on it.
- For **macOS**, enable Keychain Sharing in Xcode.

**Configure settings:**

```dart
await remoteConfig.setConfigSettings(RemoteConfigSettings(
  fetchTimeout: const Duration(minutes: 1),
  minimumFetchInterval: const Duration(hours: 1),
));
```

---

## 2. Parameter Management

**Set in-app defaults** (ensures the app behaves as intended before connecting to the backend):

```dart
await remoteConfig.setDefaults(const {
  "feature_new_onboarding": false,
  "max_retry_attempts": 3,
  "welcome_message": "Hello, world!",
  "promo_discount_pct": 0.0,
});
```

**Read values with type-specific getters:**

```dart
final showNewOnboarding = remoteConfig.getBool("feature_new_onboarding");
final maxRetries = remoteConfig.getInt("max_retry_attempts");
final welcomeMsg = remoteConfig.getString("welcome_message");
final discount = remoteConfig.getDouble("promo_discount_pct");
```

- **Never** store confidential data in Remote Config keys or values — they can be accessed by end users.
- Define parameters with the **same names** in the Firebase console as those in the app.
- Group related parameters with common prefixes (e.g., `login_timeout`, `login_attempts_max`).

---

## 3. Fetching and Activating

```dart
await remoteConfig.fetchAndActivate();
```

- Use `fetchAndActivate()` to fetch and apply values in a single call.
- Alternatively, call `fetch()` then `activate()` separately to control when values take effect.
- Activate fetched values at appropriate times (e.g., app start) for a smooth user experience.
- Check `remoteConfig.lastFetchStatus` to determine if the fetch was successful, failed, or throttled.
- Handle fetch failures gracefully — default values are used automatically when fetch fails.

---

## 4. Real-time Updates

```dart
remoteConfig.onConfigUpdated.listen((event) async {
  await remoteConfig.activate();
  // event.updatedKeys contains the changed parameter names
  if (event.updatedKeys.contains("feature_new_onboarding")) {
    // Refresh UI based on the new value
  }
});
```

- Real-time Remote Config is **not available for Web**.
- Update UI state when new configuration values are activated.
- Ensure real-time updates do not disrupt the user experience mid-flow.

---

## 5. Throttling and Performance

- Fetch calls are **throttled** if an app fetches too frequently.
- Default minimum fetch interval in production: **12 hours**.
- For development, use a shorter interval — but only in debug builds:

```dart
await remoteConfig.setConfigSettings(RemoteConfigSettings(
  fetchTimeout: const Duration(minutes: 1),
  minimumFetchInterval: const Duration(minutes: 5),
));
```

- Be mindful of **service-side quota limits** with a large user base.

---

## 6. Testing and Debugging

- Use **conditional values** in the Firebase console to test configurations without new app deployments.
- Implement **A/B testing** with different parameter values for different user segments.
- Test the app with both default and remote values.
- Verify graceful handling of configuration changes at runtime.
- Test **offline behavior** to ensure proper fallback to defaults.

---

## References

- [Firebase Remote Config Flutter documentation](https://firebase.google.com/docs/remote-config/get-started?platform=flutter)

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

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

Все скиллы по теме «Мобильная разработка» →
firebase-remote-config-basics Google LLC Скилл firebase-remote-config-basics помогает управлять Remote Config в приложениях на Android и iOS через Firebase CLI. Позволяет менять флаги функций и параметры без выкатки обновлений в магазины. CX Codex +1 132 400установок firebase-ai-logic-basics Google LLC Скилл firebase-ai-logic-basics подключает Firebase AI Logic к мобильным и веб-приложениям, позволяя вызывать модели Gemini напрямую из клиентского кода без своего бэкенда. CX Codex +1 146 900установок firebase-apk-scanner trailofbits Скилл firebase-apk-scanner разбирает Android APK, вытаскивает конфиг Firebase и проверяет базы, хранилища и функции на открытый доступ. Нужен при аудите мобильных приложений. CX Codex +1 6 000установок Hackle hackle-io Позволяет запрашивать данные A/B-тестов, пушей, сообщений в приложении и менять Remote Config в Hackle прямо через диалог с моделью. CX Codex +1 firebase-basics официальный google Скилл firebase-basics настраивает Firebase CLI, помогает войти в аккаунт, создать или выбрать проект и скачать конфигурацию Android или iOS. CX Codex +1 14 100установок firebase sickn33 Помогает проектировать архитектуру Firebase, настраивать правила безопасности Firestore и писать Cloud Functions под реальные сценарии запросов. CX Codex +1 1 600установок

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

Весь набор →
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-data-connect Скилл помогает настраивать Firebase Data Connect в Flutter, описывать GraphQL-запросы и мутации, подключать типизированный SDK и разбирать офлайн-сценарии. 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звёзд репо flutterfire-configure Настраивает Firebase в Flutter-проектах, автоматизирует вызов flutterfire configure и помогает развести конфигурации по нескольким app flavors. CX Codex +1 ★ 674звёзд репо

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

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