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

flutterfire-configure — скилл для Claude Code: настройка Firebase

Настраивает Firebase в Flutter-проектах, автоматизирует вызов flutterfire configure и помогает развести конфигурации по нескольким app flavors.

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

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

Что делает flutterfire-configure

Скилл задаёт порядок интеграции Firebase в приложения на Flutter. Он направляет агента, как запустить flutterfire configure, подключить пакет firebase_core и подготовить вызов Firebase.initializeApp в файле main.dart обязательно после WidgetsFlutterBinding.ensureInitialized().

В инструкциях разобран сценарий разделения окружений (flavors: dev, stg, prod). Ассистент генерирует отдельные файлы настроек ключами --project и --out, связывая их через псевдонимы импорта и переключатель switch (appFlavor).

Для выполнения шагов требуются системные утилиты: без пакетов firebase-tools и flutterfire_cli запуск конфигуратора завершится ошибкой. Минимальные поддерживаемые платформы в проекте — Android API 19 и iOS 11.

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

  • подключить Firebase к приложению Flutter через flutterfire configure
  • прописать запуск Firebase в main.dart без ошибок инициализации
  • разделить настройки Firebase под dev, stg и prod через флейворы
  • автоматизировать генерацию firebase_options.dart для разных платформ

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

  • Настрой Firebase для этого Flutter-проекта и подготовь инициализацию в main.dart.
  • Сконфигурируй отдельные Firebase-проекты под dev, stg и prod с помощью флейворов.
  • Обнови firebase_options.dart после добавления Crashlytics в приложение.

Как установить flutterfire-configure

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 flutterfire-configure -a claude-code

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

~/.claude/skills/flutterfire-configure/SKILL.md

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

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

Вопросы о flutterfire-configure

Как установить flutterfire-configure в Claude Code?

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

Что делает flutterfire-configure?

Скилл даёт агенту правила настройки Firebase в Flutter: как запускать CLI, генерировать конфигурационные файлы и переключать проекты между разными сборками приложения.

Какие системные инструменты нужны для работы скилла?

В системе должны стоять firebase-tools через npm и глобальный пакет flutterfire_cli через dart pub global activate. Минимальные требования к проекту — Android API 19 и iOS 11.

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

SKILL.md · MIT
---
name: flutterfire-configure
description: "Use when adding Firebase to a Flutter project, running flutterfire configure, initializing Firebase in main.dart, or configuring multiple flavors."
license: MIT
---

# FlutterFire Configure Skill

This skill defines how to correctly set up and configure Firebase for Flutter applications.

## When to Use

Use this skill when:

* Adding Firebase to a Flutter project for the first time.
* Running `flutterfire configure` after adding a new Firebase service or platform.
* Initializing Firebase in `main.dart`.
* Setting up separate Firebase projects for multiple app flavors.

---

## 1. Prerequisites

Install the required tools:

```bash
npm install -g firebase-tools
firebase login
dart pub global activate flutterfire_cli
```

**Minimum platform requirements:**
- Android: API level 19 (KitKat) or higher
- Apple: iOS 11 or higher

---

## 2. Setup and Configuration

```bash
# From your Flutter project directory:
flutterfire configure

# Add the core Firebase package:
flutter pub add firebase_core
```

- Re-run `flutterfire configure` any time you **add support for a new platform** or **start using a new Firebase service**.
- For Android-specific services (Crashlytics, Performance Monitoring), the FlutterFire CLI automatically adds the required Gradle plugins.
- Rebuild with `flutter run` after adding new Firebase plugins.

---

## 3. Firebase Initialization

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );
  runApp(const MyApp());
}
```

- Call `WidgetsFlutterBinding.ensureInitialized()` **before** Firebase initialization.
- Place Firebase initialization **before** any other Firebase service calls.
- **Never modify** `firebase_options.dart` manually — it is auto-generated.
- **Commit** `firebase_options.dart` to version control — it contains non-secret configuration identifiers.
- For Firebase Emulator Suite: `await Firebase.initializeApp(demoProjectId: "demo-project-id")`.

---

## 4. Verification and Best Practices

After configuration, verify the setup is working:

1. Run `flutter run` and confirm the app launches without Firebase initialization errors.
2. Check the debug console for `Firebase initialized successfully` or similar confirmation.
3. Verify `firebase_options.dart` was generated with the correct project ID.

- Enable **Firebase Analytics** for optimal experience with Crashlytics, Remote Config, and other products.
- Use a **consistent Firebase project** across all platforms for data consistency.
- For iOS/macOS apps using certain Firebase services, add the **Keychain Sharing** capability in Xcode.
- Test the Firebase configuration with **both debug and release** builds.
- Check **version compatibility** between Flutter plugins and the underlying Firebase SDK.

---

## 5. Multiple App Flavors

Create separate Firebase projects per environment (development, staging, production):

```bash
flutterfire config \
  --project=flutter-app-dev \
  --out=lib/firebase_options_dev.dart \
  --ios-bundle-id=com.example.flutterApp.dev \
  --ios-out=ios/flavors/dev/GoogleService-Info.plist \
  --android-package-name=com.example.flutter_app.dev \
  --android-out=android/app/src/dev/google-services.json
```

**Centralize Firebase initialization by flavor:**

```dart
// firebase.dart
import 'package:firebase_core/firebase_core.dart';
import 'package:flutter/services.dart';
import 'package:flutter_app/firebase_options_prod.dart' as prod;
import 'package:flutter_app/firebase_options_stg.dart' as stg;
import 'package:flutter_app/firebase_options_dev.dart' as dev;

Future<void> initializeFirebaseApp() async {
  final firebaseOptions = switch (appFlavor) {
    'prod' => prod.DefaultFirebaseOptions.currentPlatform,
    'stg' => stg.DefaultFirebaseOptions.currentPlatform,
    'dev' => dev.DefaultFirebaseOptions.currentPlatform,
    _ => throw UnsupportedError('Invalid flavor: $appFlavor'),
  };
  await Firebase.initializeApp(options: firebaseOptions);
}
```

```dart
// main.dart
void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await initializeFirebaseApp();
  runApp(const MainApp());
}
```

- Use `appFlavor` or environment variables to select the configuration at runtime.
- Import each flavor's config with **namespace aliases** (e.g., `as dev`).
- Use a helper script to automate multi-flavor configuration.

---

## References

- [Add Firebase to your Flutter app](https://firebase.google.com/docs/flutter/setup)
- [FlutterFire CLI](https://firebase.flutter.dev/docs/cli)

© 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установок flutter-mobile rohitg00 Плагин flutter-mobile для создания Flutter-приложений прямо в Claude Code. Помогает писать виджеты и настраивать связь между Dart-кодом и нативным слоем через platform channels. ★ 2 858звёзд репо firebase-remote-config-basics Google LLC Скилл firebase-remote-config-basics помогает управлять Remote Config в приложениях на Android и iOS через Firebase CLI. Позволяет менять флаги функций и параметры без выкатки обновлений в магазины. CX Codex +1 132 400установок flutter-expert VoltAgent Community Субагент flutter-expert для создания кроссплатформенных приложений на Flutter 3+. Помогает выстроить архитектуру, связать стейт-менеджмент и настроить нативный код. CX Codex 720установок iphone-duo-flutter mirzaaghazadeh Скилл iphone-duo-flutter помогает адаптировать приложение на Flutter под складной iPhone Duo. Учит обходить ограничения MediaQuery и пробрасывать нативные API через платформенные каналы. CX Codex +1 690установок capacitor-push-notifications capawesome-team Скилл capacitor-push-notifications ведёт агента по шагам: Firebase, плагин @capacitor-firebase/messaging, настройка Android, iOS и Web, APNs, токены FCM и тестовая отправка. CX Codex +1 1 600установок

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

Весь набор →
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звёзд репо flutter-use-column-row-first Скилл flutter-use-column-row-first помогает собирать адаптивные Flutter-экраны на Row и Column, а фиксированные размеры оставляет для конкретных задач. Пригодится при создании и проверке интерфейсов. CX Codex +1 ★ 674звёзд репо firebase-crashlytics Скилл учит агента настраивать Firebase Crashlytics во Flutter-проектах: ловить фатальные и нефатальные ошибки, логировать асинхронные исключения, добавлять кастомные ключи и загружать символы обфусцированных сборок. CX Codex +1 ★ 674звёзд репо firebase-in-app-messaging Помогает настроить Firebase In-App Messaging во Flutter: подавлять показы на критичных экранах, настраивать сбор согласий для GDPR и тестировать кампании на тестовых устройствах. CX Codex +1 ★ 674звёзд репо firebase-analytics Скилл firebase-analytics для Claude Code помогает настраивать Firebase Analytics в приложениях Flutter. Подключается при добавлении событий, свойств пользователей, воронок и отслеживания экранов. CX Codex +1 ★ 674звёзд репо

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

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