claudeers.
// Claude Plugins

duo-adapt

Adapt any Flutter app for iPhone Duo, foldables and tablets without changing the phone layout. A Claude Code plugin: one skill, three agents and a tested ada…

// Claude Plugins[ mobile ][ claude ]#claude#plugins◷ MIT$open-sourceupdated 10 days ago

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up duo-adapt (claude-plugin project) into my current project.
Found on https://claudeers.com/duo-adapt
Repo: https://github.com/islam-diab/duo-adapt
Homepage/docs: —
Detected install method: claude-plugin → /plugin install duo-adapt@islam-diab/duo-adapt
Category: plugins. Platforms: mobile.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)

⚠ Unverified / not recently updated — review before pasting a run-this config.

/plugin marketplace add islam-diab/duo-adapt
/plugin install duo-adapt@islam-diab/duo-adapt
// or clone
git clone https://github.com/islam-diab/duo-adapt

// compatibility

Platformsmobile
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageDart

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

duo-adapt: Flutter apps on iPhone Duo, foldables and tablets, with the phone layout unchanged

duo-adapt

Adapt any Flutter app for iPhone Duo, foldables and tablets, without changing a pixel of the phone layout.

duo-adapt is a Claude Code plugin. It brings one skill that orchestrates three agents (planner, executor, reviewer), a shared plan with the hard decisions already made, and a tested adaptive core layer that gets copied into your app.

Why

iPhone Duo puts the system bars in an 84 pt column on the side of the screen: on the outer display, and on the inner display in landscape. An app built for portrait phones has a rough time there:

  • content slides under the side column;
  • flutter_screenutil with a phone design size scales the whole UI about 2x on the inner display;
  • folding or unfolding rebuilds screens, so the text you typed, the selected item and the scroll position are gone;
  • Flutter 3.47 does not report the fold on iOS yet (MediaQuery.displayFeatures is empty).

Tablets, Android foldables and phones in landscape share most of these problems. duo-adapt fixes them the same way in every app.

What it does

  • Two layers. An adaptive layer for every device (breakpoints, navigation, list/detail, readable widths, grids, safe area, state), and a fold layer that only runs while a half-open fold is reported.
  • Apple-style navigation on iPhone Duo. Back, page actions and tabs move into the side column, inside the system's own 84 pt bar. Everywhere else you get a bottom bar or a rail. The side column is detected from the safe area only, never from the device model.
  • List/detail that survives folding. The selection lives in your state management, both panes keep their state under GlobalKeys, and grid columns stay even in Book posture.
  • The phone stays exactly as it is. Every UI task pins phone values in a test before the code changes, and the reviewer checks them against HEAD.
  • iOS groundwork. UIScene migration, all orientations, iPad support (only with your approval), and a pinned bridge package that reports the fold on iOS.

How it works

flowchart LR
  A["duo-planner<br/>reads the app, writes duo-plan.md"] --> B["plan review"]
  B --> C{"you approve"}
  C --> D["duo-executor<br/>one task at a time"]
  D --> E["reviews<br/>risky tasks and every phase"]
  E --> F["simulator checks"]
  F --> G["final review"]
  • duo-planner profiles the project (state management, routing, ScreenUtil, iOS setup, plugins, payments, tests, the project's own checks) and turns the shared plan into small tasks that each stand on their own.
  • duo-executor carries out one task at a time. It pins the phone values first, shows that every new test fails on the old code, runs the project's checks, and records the result in the plan.
  • duo-reviewer is read-only. It reviews the plan before you see it, every high-risk task as soon as it is done, every phase (two reviewers in parallel, one on the rules and one on the tests) and the final result.
  • The main session orchestrates, drives the iOS simulator, and brings you every decision the plan does not make.

Safety rails: it never commits or pushes, new packages, iPad support and payment changes wait for your approval, and only one agent writes at a time.

Install

As a Claude Code plugin:

/plugin marketplace add islam-diab/duo-adapt
/plugin install duo-adapt@duo-adapt

Or by hand:

git clone https://github.com/islam-diab/duo-adapt.git
cp -R duo-adapt/skills/duo-adapt ~/.claude/skills/
cp duo-adapt/agents/*.md ~/.claude/agents/

Use

Open Claude Code in your Flutter project and ask:

Adapt this app for iPhone Duo, foldables and tablets.

You can also run the skill directly: /duo-adapt (listed as duo-adapt:duo-adapt when installed as a plugin). Progress is kept in duo-plan.md at the project root, so running it again later continues where it stopped.

Requirements

  • Claude Code. The three agents run on Opus.
  • Flutter 3.41 or newer (3.47.5 is the version that builds with Xcode 27.1) and Dart 3.0 or newer.
  • A git repository, because the reviews read git diff.
  • For the iOS checks: Xcode 27.1 with the iPhone Duo simulator.

What it runs and changes

duo-adapt works only inside the Flutter project you open it in, through Claude Code's normal tools and your permission settings.

  • Reads: your project's code, configuration and git history.
  • Changes: files in your project only: lib/, test/, iOS settings such as Info.plist (UIScene and orientations, plus iPad support only with your approval), and its own duo-plan.md. It never commits or pushes unless you ask.
  • Runs: flutter analyze, flutter test, flutter build ios --simulator, dart format and dart fix on the files it changed, read-only git commands, and xcrun simctl for the simulator checks. The template test script creates a throwaway Flutter project in a temporary folder.
  • Network: only Flutter's own package downloads from pub.dev. A new package, such as the bridge that reports the fold on iOS, is added only after you approve it.
  • Data: it collects nothing and sends nothing anywhere.

What's inside

.claude-plugin/          plugin and marketplace manifests
agents/                  duo-planner, duo-executor, duo-reviewer
skills/duo-adapt/
  SKILL.md               the orchestration
  references/plan.md     the shared plan: decisions, measured facts, phases, rules
  templates/             core layer (lib/core/responsive), its tests (test/duo), iOS UIScene files, debug probe page
  scripts/               test_templates.sh, check_sync.sh

The core layer contains AdaptiveShell (bottom bar, rail or side column), AdaptivePage and PageAction, ListDetailLayout, AdaptiveSliverGrid and AdaptiveRowGrid, readableGutter, KeptAlive, SideInsetsFrame, the fold layer (activeFold, FoldLayoutBuilder, FoldAwareSplit) and CappedScreenUtilInit. Its 57 tests run on a matrix of 15 devices: phones, tablets, an Android foldable and every iPhone Duo pose.

Status

Built in October and November 2026, right after iPhone Duo came out, and already used on two real apps. The values come from a community design kit and from measurements on the Xcode 27.1 simulator. A few checks are still open (real devices, Split View, the outer display in landscape); the shared plan keeps the list. Reports and measurements are welcome.

Language

Everything in this repository is in English. Claude talks to you in the language you write in, and writes each project's duo-plan.md in that language.

Maintaining the templates

skills/duo-adapt/scripts/test_templates.sh          # strict analyze + tests, in a throwaway Flutter project
skills/duo-adapt/scripts/check_sync.sh <project>    # compare a project's core layer with the templates

Credits

  • iPhone Duo values: iPhone Duo Adaptive Design Starter Kit by Noah Elhadedy (community, v1.0), checked against simulator measurements.
  • The fold on iOS: the foldable package.

License

MIT

// faq

What is duo-adapt?

Adapt any Flutter app for iPhone Duo, foldables and tablets without changing the phone layout. A Claude Code plugin: one skill, three agents and a tested adaptive core layer.. It is open-source on GitHub.

Is duo-adapt free to use?

duo-adapt is open-source under the MIT license, so it is free to use.

What category does duo-adapt belong to?

duo-adapt is listed under plugins in the Claudeers registry of Claude-compatible tools.

15 views
★ 10 stars
unclaimed
updated 10 days ago

// embed badge

duo-adapt on Claudeers
[![Claudeers](https://claudeers.com/api/badge/duo-adapt.svg)](https://claudeers.com/duo-adapt)

// retro hit counter

duo-adapt hit counter
[![Hits](https://claudeers.com/api/counter/duo-adapt.svg)](https://claudeers.com/duo-adapt)

// reviews

// guestbook

0/500

// related in Claude Plugins

🔓

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

// pluginsmultica-ai/★ 230,631[ claude ]
🔓

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explainin…

// pluginsanthropics/⟨Python⟩★ 156,472[ claude ]
🔓

"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/

// pluginsHKUDS/⟨Python⟩★ 58,467◷ Apache-2.0[ claude ]
🔓

financial-services — a Claude ecosystem project on GitHub.

// pluginsanthropics/⟨Python⟩★ 41,409◷ Apache-2.0[ claude ]
→ see how duo-adapt connects across the ecosystem