@rynt/create-extension

CLI для создания нового проекта расширения Rynt: Vite, @rynt/extension-build, страница Hello World и пункт в меню лаунчера.

Документация: https://docs.rynt.space
После создания: @rynt/sdk + @rynt/extension-build

Быстрый старт

npm create @rynt/extension@latest my-extension
cd my-extension
npm install
npm run dev

Важно: команда npm create @rynt/extension, не @rynt/create-extension — иначе npm ищет несуществующий @rynt/create-create-extension.

Альтернативы:

pnpm create @rynt/extension my-extension
npx create-rynt-extension my-extension

В лаунчере включите Extension Dev Bridge, затем откройте пункт меню с именем вашего расширения.

Что создаётся

| Файл | Назначение | |------|------------| | src/HelloPage.vue | Страница Hello World | | src/index.ts | defineRyntExtension, регистрация core.page и core.nav | | vite.config.ts | ryntExtensionViteConfig + манифест | | assets/icon.svg | Иконка по умолчанию | | tsconfig.json, env.d.ts | TypeScript + Vue SFC |

Скрипты уже настроены:

• dev — vite build --watch (hot reload через dev-hub);
• build — vite build && rynt-extension-pack → .ryntextension.

Опции CLI

create-rynt-extension [каталог] [опции]

| Флаг | Описание | |------|----------| | --id @scope/name | manifest.id (по умолчанию @local/<slug>) | | --name | Название в UI и манифесте | | --author | Поле author в манифесте | | -y, --yes | Без интерактивных вопросов | | -h, --help | Справка |

Пример без вопросов:

npx create-rynt-extension my-hello \
  --id @acme/my-hello \
  --name "My Hello" \
  --author "Acme Team" \
  --yes

Дальнейшие шаги

1. Замените manifest.id в vite.config.ts, если меняли только через CLI — они должны совпадать с EXTENSION_ID в src/index.ts (в шаблоне уже синхронизированы).
2. Читайте Hello World — что делает сгенерированный код.
3. Встраивание через реестры — страницы, слоты, карточки.
4. Сборка и установка — .ryntextension и маркетплейс.

Требования

• Node.js ≥ 20
• Rynt Launcher с Extension API 1
• Установленные зависимости из сгенерированного package.json (@rynt/sdk, @rynt/extension-build, …)

См. также

• npm-пакеты экосистемы
• Документация расширений