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

flutter-app-architecture — скилл для Claude Code: как настроить

Скилл flutter-app-architecture задаёт правила многослойной архитектуры Flutter-проекта: MVVM, репозитории, сервисы и однонаправленный поток данных.

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

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

Что делает flutter-app-architecture

Скилл регламентирует разбиение Flutter-приложений на слои: представление с ViewModel, слой данных с репозиториями и сервисами, а для сложной логики — промежуточный слой Use Cases. Агент при генерации и рефакторинге держит связь строго между соседними слоями: экран никогда не обращается к сетевому сервису напрямую.

В правилах зафиксирован принцип единого источника правды: только Repository может менять сохранённые данные, кэшировать их и транслировать во внешний мир. Данные спускаются вниз к интерфейсу через неизменяемые списки и геттеры ChangeNotifier, а действия пользователя поднимаются наверх через методы ViewModel.

Зависимости передаются исключительно через конструкторы с абстрактными интерфейсами, поэтому для тестов реализацию легко заменить заглушкой. Любое прямое обращение из View в Service нарушает эти правила и приведёт к ошибке архитектурной проверки.

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

  • Разложить новый экран на View, ViewModel, Repository и Service
  • Настроить внедрение зависимостей через конструкторы с интерфейсами
  • Организовать офлайн-кэширование в SQLite через drift или sqflite
  • Вынести общую бизнес-логику нескольких экранов в Use Case

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

  • Разбей экран профиля на View, ViewModel и репозиторий по правилам архитектуры
  • Напиши BookingRepository с кэшированием ответов BookingApiService через sqflite
  • Сделай use case для фильтрации бронирований текущего пользователя

Как установить flutter-app-architecture

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 flutter-app-architecture -a claude-code

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

~/.claude/skills/flutter-app-architecture/SKILL.md

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

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

Вопросы о flutter-app-architecture

Как установить flutter-app-architecture в Claude Code?

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

Что делает этот скилл?

Он задаёт шаблоны проектирования Flutter: слои UI, Logic и Data, структуру классов MVVM, правила работы с хранилищами и требования к чистоте виджетов.

Когда скилл рекомендует выделять Domain Layer?

Слой Use Cases добавляется только в сложных случаях: когда логика переиспользуется между разными ViewModel или объединяет данные сразу нескольких репозиториев.

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

SKILL.md · MIT
---
name: flutter-app-architecture
description: "Use when scaffolding a project, refactoring into layers, creating view models/repositories, configuring dependency injection, or implementing unidirectional data flow (MVVM)."
license: MIT
---

# Flutter App Architecture Skill

This skill defines how to structure Flutter applications using layered architecture, proper data flow, and MVVM patterns for maintainability and testability.

## When to Use

Use this skill when:

* Scaffolding a new Flutter project with layered architecture.
* Creating or refactoring View Models, Repositories, or Services.
* Wiring dependency injection between architectural components.
* Implementing unidirectional data flow across layers.
* Adding a Domain (Logic) Layer for complex business logic or shared use cases.

---

## 1. Layer Structure

Separate every app into a **UI Layer** and a **Data Layer**. Add a **Logic (Domain) Layer** only for complex apps.

```
┌──────────────────────────────────────────────────────────────┐
│   UI Layer    │  Views + ViewModels                           │
├──────────────────────────────────────────────────────────────┤
│  Logic Layer  │  Use Cases / Interactors  (optional)         │
├──────────────────────────────────────────────────────────────┤
│   Data Layer  │  Repositories + Services                     │
└──────────────────────────────────────────────────────────────┘
```

**Rules:**
- Only adjacent layers may communicate. The UI layer must never access a Service directly.
- Data changes always happen in the Data layer (SSOT = Repository). No mutation in UI or Logic layers.
- Follow unidirectional data flow: state flows **down** (Data → UI), events flow **up** (UI → Data).

---

## 2. Component Responsibilities

### View
- Describes how to present data; keep logic minimal and UI-related only.
- Passes events to the ViewModel in response to user interactions.

### ViewModel
- Converts app data into UI state and maintains the current state needed by the View.
- Exposes callbacks (commands) to the View and retrieves/transforms data from Repositories.

```dart
class BookingViewModel extends ChangeNotifier {
  final BookingRepository _repo;

  BookingViewModel(this._repo);

  List<Booking> _bookings = [];
  List<Booking> get bookings => List.unmodifiable(_bookings);

  bool _isLoading = false;
  bool get isLoading => _isLoading;

  Future<void> loadBookings() async {
    _isLoading = true;
    notifyListeners();

    _bookings = await _repo.getBookings();
    _isLoading = false;
    notifyListeners();
  }

  Future<void> cancelBooking(String id) async {
    await _repo.cancelBooking(id);
    _bookings = await _repo.getBookings();
    notifyListeners();
  }
}
```

### Repository (Single Source of Truth)
- The only class that may mutate its data; all other classes read from it.
- Handles caching, error handling, and data refresh logic.
- Transforms raw data from Services into domain models.

```dart
class BookingRepository {
  final BookingApiService _apiService;
  final BookingLocalService _localService;

  BookingRepository(this._apiService, this._localService);

  Future<List<Booking>> getBookings() async {
    try {
      final remote = await _apiService.fetchBookings();
      await _localService.cacheBookings(remote);
      return remote;
    } catch (_) {
      return _localService.getCachedBookings();
    }
  }

  Future<void> cancelBooking(String id) async {
    await _apiService.cancelBooking(id);
    await _localService.removeCachedBooking(id);
  }
}
```

### Service
- Wraps API endpoints and exposes asynchronous response objects.
- Isolates data-loading and holds no state.

```dart
class BookingApiService {
  final http.Client _client;
  BookingApiService(this._client);

  Future<List<Booking>> fetchBookings() async {
    final response = await _client.get(Uri.parse('/api/bookings'));
    if (response.statusCode != 200) {
      throw HttpException('Failed to load bookings');
    }
    final data = jsonDecode(response.body) as List;
    return data.map((json) => Booking.fromJson(json)).toList();
  }
}
```

---

## 3. Dependency Injection

Supply dependencies via constructors. Define abstract interfaces so implementations can be swapped for testing.

```dart
// Abstract interface for the repository
abstract class BookingRepository {
  Future<List<Booking>> getBookings();
  Future<void> cancelBooking(String id);
}

// Concrete implementation
class BookingRepositoryImpl implements BookingRepository {
  final BookingApiService _api;
  BookingRepositoryImpl(this._api);

  @override
  Future<List<Booking>> getBookings() => _api.fetchBookings();

  @override
  Future<void> cancelBooking(String id) => _api.cancelBooking(id);
}
```

---

## 4. Use Cases (Domain Layer)

Introduce use cases only when:
- Logic is complex or does not fit cleanly in the UI or Data layers.
- Logic is reused across multiple ViewModels or merges data from multiple Repositories.

```dart
class GetUpcomingBookingsUseCase {
  final BookingRepository _bookingRepo;
  final UserRepository _userRepo;

  GetUpcomingBookingsUseCase(this._bookingRepo, this._userRepo);

  Future<List<Booking>> call() async {
    final user = await _userRepo.getCurrentUser();
    final bookings = await _bookingRepo.getBookings();
    return bookings
        .where((b) => b.userId == user.id && b.date.isAfter(DateTime.now()))
        .toList();
  }
}
```

---

## 5. Workflow: Scaffold a New Feature

1. **Create the Service** — implement the API wrapper with typed response parsing.
2. **Create the Repository** — inject the Service, implement caching and error-handling logic.
3. **Create the ViewModel** — inject the Repository, expose UI state and commands.
4. **Create the View** — bind to the ViewModel, render state, dispatch events.
5. **Wire DI** — register all components in the dependency injection container.
6. **Verify** — confirm the View never accesses the Service directly and data flows unidirectionally.

---

## 6. Data Storage

- Use **key-value storage** (e.g., `shared_preferences`) for configuration and preferences.
- Use **SQL storage** (e.g., `drift`, `sqflite`) for complex relational data.
- Implement **optimistic updates** to improve perceived responsiveness by updating UI before server confirms.
- Support **offline-first** by combining local and remote data sources in Repositories.

---

## 7. Coding Conventions

- Use `StatelessWidget` when possible; avoid unnecessary `StatefulWidget`s.
- Keep build methods simple and focused on rendering.
- Prefer `final` for fields and top-level variables. Prefer `const` constructors when the class supports it.
- Prefer explicit typing on public APIs (e.g., `Command0<void>` over dynamic signatures).
- Use descriptive constant names (e.g., `_todoTableName` over `_kTableTodo`).

---

## References

- [Flutter app architecture guide](https://docs.flutter.dev/app-architecture/guide)
- [Flutter Website GitHub Repository](https://github.com/flutter/website)

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

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

Все скиллы по теме «Мобильная разработка» →
flutter-architecture Stanislav [MADTeacher] Chernyshev Скилл flutter-architecture для проектирования и ревью архитектуры Flutter-приложений: слои, MVVM, feature-first структура, DI и паттерны вроде Result и Command. CX Codex +1 1 700установок flutter-apply-architecture-best-practices flutter Скилл flutter-apply-architecture-best-practices для Claude Code раскладывает Flutter-приложение по слоям UI, Logic и Data. Описывает архитектуру нового проекта и рефакторинг кода. CX Codex +1 47 000установок Flutter App taste f Промпт Flutter App taste для ChatGPT задаёт стандарты разработки кроссплатформенных мобильных приложений на Flutter. Задействуется при проектировании архитектуры и написании кода. GP ChatGPT ★ 178 201звёзд репо flutter-riverpod-expert juparave Скилл flutter-riverpod-expert обучает агента архитектуре Flutter Riverpod с кодогенерацией и AsyncNotifier. Он нужен при настройке реактивного стейта, разделении слоёв и борьбе с лишними перерисовками. CX Codex +1 1 200установок flutter-development-guidelines-cursorrules-prompt-file PatrickJS flutter-development-guidelines-cursorrules-prompt-file — правило Cursor для структуры Flutter-проекта, нейминга и стиля Dart. Включается при работе с файлами **/*.dart. CX Codex +1 ★ 41 178звёзд репо flutter sanjeed5 Правило задаёт Cursor единый стиль Flutter-кода: форматирование, линты, слои MVVM и Riverpod. Агент перестаёт спорить о стиле и ловит типовые ошибки раньше. CX Codex +1 ★ 3 589звёзд репо

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

Весь набор →
patrol-e2e-testing Скилл patrol-e2e-testing пишет и запускает E2E-тесты на Patrol 4.x для Flutter: пользовательские сценарии, системные диалоги разрешений, деплинки. CX Codex +1 ★ 674звёзд репо revenuecat-testing Скилл revenuecat-testing помогает составить план тестирования встроенных покупок и подписок в RevenueCat, проверить события в песочнице и разобрать сбои. CX Codex +1 ★ 674звёзд репо firebase-app-check Скилл помогает внедрить Firebase App Check во Flutter: выбрать провайдеров, настроить debug-токены и включить проверку запросов. CX Codex +1 ★ 674звёзд репо flutter-best-practices Скилл flutter-best-practices для Claude Code задаёт правила Flutter и Dart: слои, структура фич, виджеты и тесты. Агент читает нужный файл-справочник под задачу. 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звёзд репо firebase-database Скилл firebase-database помогает проектировать структуру Firebase Realtime Database и работать с чтением, записями, синхронизацией и правилами доступа в приложениях Flutter. CX Codex +1 ★ 674звёзд репо

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

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