New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Flutter Pageview URL Routing Reorder Loop

by divinevideo in divinevideo/divine-mobile

Fix infinite rebuild loop in Flutter when using PageView with URL-based routing (GoRouter) and reactive state management (Riverpod/BLoC).

MPL-2.0Auto-check passedMobile

Install Flutter Pageview URL Routing Reorder Loop

skills CLI
$ npx skills add divinevideo/divine-mobile --skill flutter-pageview-url-routing-reorder-loop -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install divinevideo/divine-mobile flutter-pageview-url-routing-reorder-loop --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/divinevideo/divine-mobile.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/flutter-pageview-url-routing-reorder-loop .claude/skills/flutter-pageview-url-routing-reorder-loop && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
flutter-pageview-url-routing-reorder-loop
GitHub stars
266
Token cost
~1.6k tokens
SKILL.md length
454 words
Files
1
Skills in repo
103
Repo updated
First seen
Licence
MPL-2.0

At a glance

Fix infinite rebuild loop in Flutter when using PageView with URL-based routing (GoRouter) and reactive state management (Riverpod/BLoC).

  • Works in 3 steps: Remove tracking state → Remove reorder detection block → Keep only one-way sync patterns
  • RAPID REBUILD warnings appear in console (20+)
  • SKILL.md covers Problem, Context / Trigger Conditions, Solution and The Feedback Loop Explained, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Flutter Pageview URL Routing Reorder Loop is an agent skill from divinevideo/divine-mobile. Fix infinite rebuild loop in Flutter when using PageView with URL-based routing (GoRouter) and reactive state management (Riverpod/BLoC). Use when: (1) RAPID REBUILD warnings appear in console (20+), (2) "setState() or markNeedsBuild() called during build" errors from ValueListenableBuilder, (3) Video feed or list-based PageView is frozen and won't swipe, (4) Overlay or UI elements flicker between visible/invisible rapidly, (5) Logs show item "moved from index X to Y" repeatedly. Caused by tracking items by ID…

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile, covering Cross-platform mobile apps and State management. It works with Flutter. The licence is MPL-2.0.

When your agent uses it

  • RAPID REBUILD warnings appear in console (20+)
  • MarkNeedsBuild() called during build errors from ValueListenableBuilder
  • List-based PageView is frozen and wont swipe
  • UI elements flicker between visible/invisible rapidly

Example prompts

  • “setState() or markNeedsBuild() called during build”
  • “moved from index X to Y”
  • “/flutter-pageview-url-routing-reorder-loop”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Remove tracking state
  2. Remove reorder detection block
  3. Keep only one-way sync patterns

What it can do on your machine

Read from SKILL.md and the folder at commit c3d6f7e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are dart).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Flutter Pageview URL Routing Reorder Loop loads about 1.6k tokens when it runs. Until then it costs about 151 tokens; SKILL.md has 454 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~151
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from divinevideo/divine-mobile at commit c3d6f7e, republished under its MPL-2.0 licence (© divinevideo). 454 words, ~1,581 tokens.

Download SKILL.mdSave it as .claude/skills/flutter-pageview-url-routing-reorder-loop/SKILL.md (or your agent's skills folder).
name
flutter-pageview-url-routing-reorder-loop
description
Fix infinite rebuild loop in Flutter when using PageView with URL-based routing (GoRouter) and reactive state management (Riverpod/BLoC). Use when: (1) RAPID REBUILD warnings appear in console (#20+), (2) "setState() or markNeedsBuild() called during build" errors from ValueListenableBuilder, (3) Video feed or list-based PageView is frozen and won't swipe, (4) Overlay or UI elements flicker between visible/invisible rapidly, (5) Logs show item "moved from index X to Y" repeatedly. Caused by tracking items by ID and updating URL when reactive list reorders.
author
Claude Code
version
1.0.0
date
2026-02-06

Flutter PageView + URL Routing Reorder Detection Loop

Problem

When a PageView is synced bidirectionally with URL-based routing (e.g., GoRouter /home/:index) and the data source is a reactive provider (Riverpod, BLoC stream), attempting to track the currently-viewed item by its ID and update the URL when the item moves to a different index in the list creates an infinite feedback loop.

Context / Trigger Conditions

Symptoms:

  • Console shows RAPID REBUILD #42! warnings (build count growing rapidly)
  • setState() or markNeedsBuild() called during build errors from ValueListenableBuilder
  • PageView is frozen - user swipes but page bounces back to same position
  • UI overlay (social buttons, controls) flickers between visible and invisible
  • Logs show repeated pattern: Video X moved from index 4 -> 3, updating URL

Architecture that triggers this:

  • PageView.builder with onPageChanged updating URL via context.go('/feed/$index')
  • URL-derived index synced back to PageController via jumpToPage() during build
  • Reactive data source (Riverpod provider, stream) that can re-emit with reordered items
  • Item tracking: _currentItemId compared against list to detect "moves"

Example of the anti-pattern:

dart
// IN BUILD METHOD - creates feedback loop!
if (_currentVideoStableId != null && videos.isNotEmpty) {
  final currentVideoIndex = videos.indexWhere(
    (v) => v.stableId == _currentVideoStableId,
  );
  if (currentVideoIndex != -1 && currentVideoIndex != urlIndex) {
    // This triggers URL update -> rebuild -> PageController sync ->
    // onPageChanged -> URL update -> INFINITE LOOP
    context.go('/home/$currentVideoIndex');
  }
}

Solution

Remove item-tracking reorder detection entirely. The PageController should be the sole source of truth for which page the user is viewing.

Step 1: Remove tracking state
dart
// REMOVE these fields:
// String? _currentVideoStableId;
// bool _urlUpdateScheduled = false;
Step 2: Remove reorder detection block

Remove any code in build() that:

  • Searches for a tracked item ID in the current list
  • Compares found index against URL index
  • Schedules URL updates when indices differ
Step 3: Keep only one-way sync patterns

User swipe -> URL (one-way):

dart
onPageChanged: (newIndex) {
  if (newIndex != urlIndex) {
    context.go('/home/$newIndex');
  }
}

External navigation -> PageController (one-way):

dart
if (urlIndex != _lastUrlIndex) {
  _lastUrlIndex = urlIndex;
  controller.jumpToPage(urlIndex);
}

These two paths don't create loops because:

  • User swipe: URL updates, next build sees matching urlIndex -> no sync needed
  • External nav: URL changes, sync fires, onPageChanged fires but newIndex == urlIndex -> no URL update
Show full SKILL.md (181 more words)Show less

The Feedback Loop Explained

┌─ Reactive provider re-emits (new data from server) ─┐
│                                                       │
▼                                                       │
Build runs with new video list                          │
│                                                       │
▼                                                       │
Reorder detection: "Video X moved from idx 4 to 3"     │
│                                                       │
▼                                                       │
Schedule URL update: context.go('/home/3')              │
│                                                       │
▼                                                       │
Build runs: urlIndex=3, PageController at page 4        │
│                                                       │
▼                                                       │
Sync: jumpToPage(3)                                     │
│                                                       │
▼                                                       │
onPageChanged(3) fires → context.go('/home/3')          │
│                                                       │
▼                                                       │
But PageController was at 4, which showed different     │
video → _currentVideoStableId mismatches → detects      │
"move" again → URL update to /home/4                    │
│                                                       │
└───────── INFINITE LOOP ──────────────────────────────┘

Verification

After removing reorder detection:

  1. No more RAPID REBUILD warnings in console
  2. No setState() called during build errors
  3. Swiping between pages works smoothly
  4. UI overlays stay visible on the active page
  5. No "moved from index X to Y" log spam

Notes

  • Why reorder detection seems needed: When a reactive list reorders (e.g., new items prepended), the user's current page index points to a different item. However, trying to "follow" the item creates worse UX (infinite loop) than staying on the same page index.

  • Alternative if position preservation is critical: Instead of URL-based reorder detection, stabilize the list order. Either:

    • Don't reorder while the user is actively viewing (batch updates)
    • Use a stable sort that preserves relative positions of existing items
    • Only prepend/append new items, never reorder existing ones

  • Related pattern: flutter-pageview-implicit-scrolling-snapback addresses a different PageView issue (snap-back on state rebuild) but can co-occur with this loop.

  • Framework-agnostic: While this was discovered with GoRouter + Riverpod, the same pattern applies to any PageView + URL routing + reactive state combination (Navigator 2.0, auto_route, BLoC streams, etc.)

© divinevideo, MPL-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/flutter-pageview-url-routing-reorder-loop of divinevideo/divine-mobile.

Open the folder on GitHubat commit c3d6f7e

Compare with similar skills

Flutter Pageview URL Routing Reorder Loop next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Flutter Pageview URL Routing Reorder Loop compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flutter Pageview URL Routing Reorder Loop this skilldivinevideo/divine-mobile266—~1.6kAutomated safety check: PassMPL-2.0
Flutter Riverpod State Managementandrewyng/context-hub14k—~1.1kAutomated safety check: PassMIT
BlocVeryGoodOpenSource/vgv-ai-flutter-plugin170—~2kAutomated safety check: PassMIT
Flutter Dart Code Reviewaffaan-m/ECC276k2 repos~5.8kAutomated safety check: NotesMIT
Signals for Flutterrodydavis/signals.dart819—~1.9kAutomated safety check: PassApache-2.0
Flutteralinaqi/maggy707—~3.5kAutomated safety check: PassMIT

Similar skills

  • Flutter Riverpod State Management

    andrewyng/context-hub

    Guides Flutter state management with Riverpod: choosing provider types, wiring ConsumerWidgets, handling async state and lifecycle, and overriding providers in tests.

    14k GitHub stars~1.1k tokensUpdated 4 mo ago
    MobileAuto-check passed

  • Bloc

    VeryGoodOpenSource/vgv-ai-flutter-plugin

    Best practices for Bloc state management in Flutter/Dart, covering Cubit versus Bloc, event and state naming, sealed classes with Equatable, the Page/View split with BlocProvider, BlocBuilder…

    170 GitHub stars~2k tokensUpdated 4 days ago
    MobileAuto-check passed

  • Flutter Dart Code Review

    affaan-m/ECC

    Library-agnostic Flutter/Dart code review checklist covering widget best practices, state management patterns (BLoC, Riverpod, Provider, GetX, MobX, Signals), Dart idioms, performance…

    276k GitHub starsUsed in 2 repos~5.8k tokens
    MobileAuto-check: notes

  • Signals for Flutter

    rodydavis/signals.dart

    Reference for the signals_flutter package: reactive signals, computed values, effects, async signals and collection signals bound to Flutter widgets.

    819 GitHub stars~1.9k tokensUpdated 26 days ago
    MobileAuto-check passed

  • Flutter

    alinaqi/maggy

    Flutter development with Riverpod state management, Freezed, gorouter, and mocktail testing

    707 GitHub stars~3.5k tokensUpdated 16 days ago
    MobileAuto-check passed

  • Mobile Development

    rohitg00/awesome-claude-code-toolkit

    Mobile development patterns for React Native and Flutter including navigation, state management, and responsive design

    2.7k GitHub stars~1.5k tokensUpdated 5 mo ago
    MobileAuto-check passed

More from divinevideo/divine-mobile

All 103 skills in this repo

  • Argocd Externalsecret Namespace Permission

    divinevideo/divine-mobile

    Fix ArgoCD ExternalSecret deployment failing with "namespace X is not permitted in project Y".

    266 GitHub stars~931 tokensUpdated today
    Auto-check passed

  • Art Direct

    divinevideo/divine-mobile

    Art direction for any content — reads text, PDF, Word, HTML, PPT, then proposes 2-3 creative directions with photography style, mood, and visual language.

    266 GitHub stars~4.8k tokensUpdated today
    Auto-check passed

  • Async Await Null Race Condition

    divinevideo/divine-mobile

    Fix "Null check operator used on a null value" errors when an object is set to null during an async await.

    266 GitHub stars~881 tokensUpdated today
    Auto-check passed

  • AWS V4 Signing Custom Headers Gcs

    divinevideo/divine-mobile

    Add custom metadata headers (x-amz-meta-) to AWS v4 signed requests for GCS S3-compatible API.

    266 GitHub stars~1k tokensUpdated today
    Auto-check passed

  • Bash Herestring Newline Secrets

    divinevideo/divine-mobile

    Fix password/secret authentication failures caused by trailing newlines when creating Google Cloud secrets (or similar) with bash here-strings.

    266 GitHub stars~791 tokensUpdated today
    Auto-check passed

  • Blossom Content Addressed URL Filtering

    divinevideo/divine-mobile

    Fix silent video/media processing failures caused by URL extraction code that filters on file extensions (.mp4, .webm, .webp).

    266 GitHub stars~1.1k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Flutter Pageview URL Routing Reorder Loop

What does Flutter Pageview URL Routing Reorder Loop do?

Fix infinite rebuild loop in Flutter when using PageView with URL-based routing (GoRouter) and reactive state management (Riverpod/BLoC). Flutter Pageview URL Routing Reorder Loop is an agent skill from divinevideo/divine-mobile. Fix infinite rebuild loop in Flutter when using PageView with URL-based routing (GoRouter) and reactive state management (Riverpod/BLoC).

When should I use Flutter Pageview URL Routing Reorder Loop?

Flutter Pageview URL Routing Reorder Loop fits situations like: RAPID REBUILD warnings appear in console (20+); markNeedsBuild() called during build errors from ValueListenableBuilder; list-based PageView is frozen and wont swipe; UI elements flicker between visible/invisible rapidly.

How do I install Flutter Pageview URL Routing Reorder Loop in Claude Code?

Run `npx skills add divinevideo/divine-mobile --skill flutter-pageview-url-routing-reorder-loop -a claude-code`. Or copy the skill folder (.agents/skills/flutter-pageview-url-routing-reorder-loop in divinevideo/divine-mobile) into .claude/skills/flutter-pageview-url-routing-reorder-loop in your project. Claude Code loads it when a task matches its description.

How do I install Flutter Pageview URL Routing Reorder Loop in Codex?

Run `npx skills add divinevideo/divine-mobile --skill flutter-pageview-url-routing-reorder-loop -a codex`. Or copy the skill folder (.agents/skills/flutter-pageview-url-routing-reorder-loop in divinevideo/divine-mobile) into .agents/skills/flutter-pageview-url-routing-reorder-loop in your project. Codex loads it when a task matches its description.

Can I use Flutter Pageview URL Routing Reorder Loop in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add divinevideo/divine-mobile --skill flutter-pageview-url-routing-reorder-loop -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/flutter-pageview-url-routing-reorder-loop, .gemini/skills/flutter-pageview-url-routing-reorder-loop, .github/skills/flutter-pageview-url-routing-reorder-loop and .opencode/skills/flutter-pageview-url-routing-reorder-loop in your project.

What does Flutter Pageview URL Routing Reorder Loop need to run?

SKILL.md names no scripts, command-line tools or credentials: Flutter Pageview URL Routing Reorder Loop is instructions for the agent only.

Does Flutter Pageview URL Routing Reorder Loop access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Flutter Pageview URL Routing Reorder Loop safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Flutter Pageview URL Routing Reorder Loop use?

Flutter Pageview URL Routing Reorder Loop is published under the MPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Flutter Pageview URL Routing Reorder Loop use?

About 1.6k tokens (SKILL.md is roughly 6.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Flutter Pageview URL Routing Reorder Loop?

Skills that share tags, products or a category with Flutter Pageview URL Routing Reorder Loop: Flutter Riverpod State Management (andrewyng/context-hub, 14k stars), Bloc (VeryGoodOpenSource/vgv-ai-flutter-plugin, 170 stars), Flutter Dart Code Review (affaan-m/ECC, 276k stars) and Signals for Flutter (rodydavis/signals.dart, 819 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flutter Pageview URL Routing Reorder Loop?

divinevideo (a GitHub organization) maintains it in divinevideo/divine-mobile, which has 266 GitHub stars. The repository holds 103 skills in this directory. The repository was last updated on October 10, 2026.

Source: divinevideo/divine-mobile on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.