islandcn — React向けDynamic Islandコンポーネント
opencoredev/islandcn
★ 783 ・ TypeScript ・ MIT
概要
islandcnは、Appleの「Dynamic Island」に似たインターフェースをReactアプリケーション上で再現・実装できるオープンソースのUIコンポーネントです。shadcnのレジストリ形式を採用しており、必要なコードを自身のプロジェクトへ直接取り込んで利用できます。
Webアプリケーションにおいて、バックグラウンドでのファイルアップロード、タイマー、メディア再生の状況、通話や通知といった複数のアクティビティを画面上部に統合して提示したい場面に向いています。個々のコンポーネントで通知トーストやモーダルを乱立させる代わりに、ひとつのアイランドに状態を集約して操作可能なUIを構築できます。
主な特徴
- 4つのプレゼンテーション状態:
idle(待機)、compact(コンパクト)、the split(分割)、expanded(展開)の4つの表示状態をサポートしており、状況に応じて柔軟に形状が変わります。 - 細部まで調整されたスプリングアニメーション: 実機の動作をコマ送りで記録した映像に合わせてチューニングされたスプリング(ばね)アニメーションが組み込まれており、長押し操作やアラート表示、OSの視覚効果抑制(reduced motion)にも対応しています。
- 豊富な組み込みプリセット: アップロード進行状況、タイマー、再生中メディア、着信通知、配達・配車の到着予定時間(ETA)、録音、周辺機器転送、バッテリー表示など、実用的なプリセットが用意されています。
- shadcn CLIによる導入: 外部の重量なパッケージをnpm依存として固定するのではなく、shadcnの仕組みを用いて必要なソースコードをプロジェクト内に直接追加できます。
- プレイグラウンド環境:
/playgroundが用意されており、プリセットや新規アクティビティを画面上で試しながらモーションの微調整やコード生成を行えます。 - コーディングエージェント向けスキル: AIコーディングエージェント向けの支援として、オプションのレジストリアイテム
islandcn-skillも提供されています。
使い方
インストール
shadcn CLIを利用して、リモートレジストリからコアコンポーネントをプロジェクトに追加します。
npx shadcn@latest add https://islandcn.dev/r/island-core.json
基本的な実装手順
アプリケーションのルート階層付近で IslandProvider と Island コンポーネントを配置します。その後、配下のコンポーネントから useIsland フックを呼び出してアクティビティの開始、更新、終了を制御します。
"use client";
import { Island, IslandProvider, useIsland } from "@/lib/island";
// ルート階層付近に一度だけ配置します
<IslandProvider>
<Island placement="viewport" />
{/* アプリケーションの他のコンテンツ */}
</IslandProvider>;
// 配下のコンポーネント内での利用例
const island = useIsland();
// アクティビティの開始
const upload = island.start({
id: "upload",
label: "Uploading report.pdf",
compact: { leading: <CloudIcon />, trailing: /* 状態表示など */ },
expanded: { center: "report.pdf", bottom: /* 詳細情報など */ },
});
// アクティビティの更新
upload.update({ compact: { trailing: /* 更新された表示 */ } });
// アクティビティの終了
upload.end();
技術的なポイント
アーキテクチャとディレクトリ構成
islandcnはTypeScriptで書かれており、内部は大きく「コアエンジン」「プリセット」「ドキュメント・プレイグラウンド」に分かれています。
- エンジン (
lib/island/):island-coreとして配布される中核部分です。アクティビティスタックの管理、4つの表示状態の制御、物理演算に基づいたスプリングアニメーション、アクセシビリティ(reduced motion)対応を含みます。依存関係はReactのみ(React only)とされています。 - プリセット (
components/islandcn/): タイマーやアップロードなどの各機能が、コアエンジンの上に構築された単一ファイルおよび共通コンテンツキットとして実装されています。 - ビルドと配布:
pnpm buildを実行することで、レジストリ用JSONがpublic/rに生成され、静的サイトがビルドされる構成になっています。
実機解析に基づくアニメーション設計
islandcnの特徴的な点として、アニメーションの補間パラメータを実機のDynamic Islandのコマ送り録画に合わせて調整している点が挙げられます。これにより、拡大・縮小時や状態遷移時の独特な弾性や滑らかさが再現されています。
注意点
- ライセンスと商標: islandcn自体のコードはMITライセンス(Copyright (c) 2026 Leo)で公開されています。ただし、READMEに明記されているとおり、Appleの「Dynamic Island」の外観や挙動を参考に再現しているものの、Apple社のアセットは含まれておらず、Apple社との提携関係もありません。「Dynamic Island」はApple Inc.の商標です。
- テストリソースの非同梱: モーション調整の元となった実機録画データそのものはリポジトリ内に含まれていません。そのため、録画映像と突き合わせて比較する
/compare画面や、録画データを読み込むテストはスキップされる仕様となっています。 - 環境: Next.jsなどのReact環境を前提としており、クライアントサイドでの動作(
"use client"ディレクティブの使用)が必要です。
まとめ
islandcnは、AppleのDynamic Islandのような動的ステータス表示をReactアプリ上で手軽に再現できるコンポーネントです。shadcnのエコシステムに準拠しているため、必要なコードを自分のプロジェクトに取り込んで細かくカスタマイズできます。Webアプリにおける非同期タスクやステータス通知の新しい見せ方として活用を検討できるライブラリです。





