islandcn README

README проекта с github.com/opencoredev/islandcn. Одним файлом markdown: README.md.

islandcn

A Dynamic Island-style component for any React app, installed with shadcn. Show an upload, a timer, a song, a ride on its way, an incoming call or a recording in one island at the top of your app, and shape each activity around your app's own actions.

npx shadcn@latest add https://islandcn.dev/r/island-core.json
"use client";

import { Island, IslandProvider, useIsland } from "@/lib/island";

// Mount once near the root.
<IslandProvider>
  <Island placement="viewport" />
  <App />
</IslandProvider>;

// Then, from any component inside it:
const island = useIsland();
const upload = island.start({
  id: "upload",
  label: "Uploading report.pdf",
  compact: { leading: <CloudIcon />, trailing: <ProgressRing value={0.4} /> },
  expanded: { center: <span>report.pdf</span>, bottom: <Progress value={0.4} /> },
});
upload.update({ compact: { trailing: <ProgressRing value={0.8} /> } });
upload.end();

What's here

Coding agents can use the optional islandcn-skill registry item as an install helper; see /docs/agent-skill.

Develop

pnpm install
pnpm dev           # http://localhost:3000
pnpm typecheck
pnpm build         # builds the registry into public/r, then the site

Read AGENTS.md before changing anything.

The recordings the motion was fitted to are not in this repo. /lab still plays every transition from its built-in sequences in pnpm dev; /compare, which sets the web side against the recordings, has nothing to show, and the one test that reads them is skipped.

License

MIT, copyright (c) 2026 Leo. See LICENSE. islandcn copies the look and motion of Apple's island, but none of Apple's assets. It is not affiliated with Apple. Dynamic Island is a trademark of Apple Inc.

islandcn (opencoredev/islandcn)

Ищем в базе…

Что это такое?Компонент с открытым исходным кодом в стиле Dynamic Island для любого React-приложения, который устанавливается через shadcn. Он показывает в одном островке в верхней части приложения такие активности, как загрузки, таймеры, песни или входящие звонки.
Это библиотека, которую я импортирую, или готовое приложение?Это библиотека компонентов для вашего проекта, а не отдельное приложение. Внутри есть движок только для React и готовые пресеты, которые можно сразу подключить.
Как подключить это к моему проекту?Откройте плейграунд по адресу /playground, создайте остров из пресета или пустой активности и скопируйте команду установки и код, которые он сгенерирует. ИИ-агенты для программирования также могут использовать необязательный элемент реестра islandcn-skill.
Что нужно иметь до установки?React-проект, который работает с shadcn, так как установка идёт через него. В README больше никаких обязательных требований не указано.
Будет ли анимация точно повторять записи Apple?Из этого репозитория — нет. Записи, по которым подогнана анимация, не включены, поэтому на /compare нечего показать, а один тест пропускается.
Можно ли использовать это в коммерческом продукте?Да, библиотека распространяется под лицензией MIT, так что её можно использовать на условиях файла LICENSE.
Можно ли попробовать, ничего не устанавливая?Да. Плейграунд по адресу /playground позволяет создать остров из пресета или пустой активности, запустить каждое действие, настроить анимацию и посмотреть код.
Что движок делает за меня?Стек активностей, четыре режима отображения (idle, compact, split, expanded), пружинные анимации, долгое нажатие, оповещения и поддержку режима сниженной анимации.
Почему анимация похожа на остров Apple?Пружины подогнаны под покадровые записи настоящего острова, поэтому движение близко повторяет оригинал.
Какие есть похожие проекты?arc-library, Monocharts, Libraries.dev, chakra-ui, rare-ui, animateicons, magicui, canvas-ui
Автор
opencoredev
Размер
1.8 MB
Звёзды
795
Обновлён
КоммитNov 13
Возраст
5 д
Коммиты · 90 дней