claude

utopia-hooks-migrate-bloc

👾 Migrate Flutter BLoC/Cubit codebases to utopia_hooks. Two-phase migration (global states first, then screens) with per-commit granularity, service extraction for logic-heavy Cubits, deferred provider registration (no dual-run side effects), a flutter-test behavioral gate, staged plans for god-screens, dart analyze baseline (Dart MCP preferred), and a --finalize cleanup mode. Includes the /utopia-hooks-migrate-bloc:migrate orchestrator coordinating five sub-agents: migrate-inventory, migrate-foundation, migrate-global-state, migrate-screen, and migrate-review. Recommended companion: utopia-hooks plugin.

1 on GitHubby UtopiaSoftwarev0.5.0BSD-2-Clauseupdated 17 days ago
/

Plugin utopia-hooks-migrate-bloc from marketplace utopia-flutter-skills in Utopia-USS/utopia-flutter-skills. Commands read from the repo's manifest — 17 days ago.

This plugin runs code on your machine — its hooks fire automatically on events like tool use. The exact commands are listed below; read them before installing.

What it installs

Skills (1)

  • migrate-bloc-to-utopia-hooks

    Migrate Flutter BLoC/Cubit codebases to utopia_hooks. Applies when flutter_bloc imports, Bloc/Cubit classes, BlocProvider, BlocBuilder, BlocListener, or emit() calls are detected. Proactively suggests migration when BLoC patterns are found. Does NOT cover writing new hooks-first code in projects wit

Slash commands (1)

  • /utopia-hooks-migrate-bloc:migrate

    Orchestrate BLoC → utopia_hooks migration for the current Flutter project

Subagents (5)

  • migrate-foundation

    One-time setup of utopia_hooks foundation in a Flutter project. Adds pubspec dependency, creates _providers.dart, useInjected bridge to existing DI, and wires HookProviderContainerWidget at app root alongside existing MultiBlocProvider.

  • migrate-global-state

    Migrate a single BLoC-era Cubit/Bloc to a parallel hook-based global state in isolation - no screen changes. Creates the State class + useXState() hook (registration in _providers is deferred to the first consumer screen), marks the original Cubit @Deprecated. Emits ONE diff for ONE commit. Can also

  • migrate-inventory

    Read-only scanner for BLoC → utopia_hooks migration state. Builds screen inventory, global-state dependency graph, next-wave plan, and regenerates MIGRATION.md while preserving user-edited Skipped section.

  • migrate-review

    Independent review of a migrated screen's code against the BLoC → utopia_hooks exit gate. Fresh context, does not see the migration agent's reasoning. Runs Phase 3 self-review and Phase 4 exit gate from the skill, returns pass/fail + fix list.

  • migrate-screen

    Migrate a single Flutter screen (plus any global states it needs that aren't yet migrated) from BLoC/Cubit to utopia_hooks. Produces the diff but does not commit. For god-screens it proposes a staged plan executed across multiple invocations. Follows the migrate-bloc-to-utopia-hooks skill strictly.

Hooks (1)

  • PostToolUse

    bash "${CLAUDE_PLUGIN_ROOT}/scripts/screen_gate.sh"

View source on GitHub

More from Utopia-USS/utopia-flutter-skills

All 8 plugins →

utopia-design

claude

👾 The Utopia Design Protocol for utopia_ui apps. Edit/rebrand DTCG design tokens (design/tokens.json) with validation gates, import external designs (Figma DTCG exports, tokens.css / Tailwind @theme, handoff bundles, DESIGN.md), regenerate the Flutter theme and HTML twin from tokens, build screens from the component manifest with explicit gap reporting, and scaffold project components registered in the project/merged manifest. SessionStart detection plus PostToolUse token/literal gates; silent outside utopia_ui projects.

5 skills · hooks

1

utopia-reviews

claudecodex

👾 Code reviews as a two-way agent conversation on GitHub / GitLab / Bitbucket. Two skills: utopia-code-review performs a Utopia-aware, severity-ranked review of a PR/MR or a local branch pair (and, after one approval gate, posts it as inline comments); utopia-resolve-code-review addresses review comments on the user's own PR end to end - triage against code + spec + Utopia conventions, one gate, then fix, verify, push, reply, resolve. Includes /utopia-reviews:review and /utopia-reviews:resolve.

2 skills · 2 commands

1

utopia-cms

claudecodex

👾 Flutter CMS / admin panels with utopia_cms. CmsWidget shell, CmsTablePage, CmsDelegate (Firebase / Supabase / Hasura / GraphQL), CmsEntry catalog, filters, custom actions, management sections. PostToolUse hook flags the hand-rolled DataTable + service + state-class anti-pattern.

1 skill · hooks

1

utopia-hooks

claudecodex

👾 Flutter state management with utopia_hooks. Screen/State/View pattern, hook catalog, global state, async/pagination patterns, app bootstrap, global error handling, navigation conventions, hook-state testing, utopia_cli integration (describe / add screen / doctor / MCP), and enforcement of conventions via SessionStart project detection + PostToolUse checks.

1 skill · hooks

1

utopia-pubdev

claudecodex

👾 Compose and standardize pub.dev READMEs for Dart/Flutter packages - brand-profile-driven header and badge row, house voice, section structure (minimal vs full tiers), a no-sponsor footer with sibling links, and a tool-agnostic AI assistants section. Auto-applies the bundled Utopia profile in Utopia codebases, reads docs/pubdev-brand.md elsewhere, and ships a brand-setup interview skill plus the Utopia brand-chip header generator (package name to Clay PNG via headless Chrome). Use when creating or refreshing a package README, its header image, or the repo's branding profile; not for app code or non-package docs.

2 skills

1

utopia-ai-arch

claude

👾 Create and maintain the Claude Code `.claude/` layer (agents, skills, slash commands, enforcement hooks, settings.json, refs, claude-architecture.md decision log) for Utopia Flutter projects. Encodes the project-claude-layer blueprint plus the invariants and decision criteria distilled from production implementations across multiple Utopia repos. Use when bootstrapping a new repo's AI architecture, adding a skill/agent/command/hook script, recording a rejected alternative, auditing for drift, or diagnosing why the agent keeps forgetting a project convention.

1 skill

1

Maintain utopia-hooks-migrate-bloc?

This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.

claude & codex plugins8 plugins