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