🧰 CLI
@emailmaker/cli — публичный генератор проектов: внешние плагины и демо-стенды. Работает в интерактивном режиме и с полным набором аргументов командной строки.
Флаги командной строки
Ниже перечислены основные опции, которые доступны пользователю через --help.
--dev / --dev-packages
Самый частый флаг для разработки: в сгенерированном проекте пакеты экосистемы получают dist-tag dev вместо latest. Используйте, когда нужны свежие предрелизные сборки.
npx @emailmaker/cli my-plugin --kind plugin --preset advanced --bundler vite --target npm-package --dev --output-dir ./my-plugin
Короткая форма: --dev (эквивалент --dev-packages).
Остальные опции
| Флаг | Назначение |
|---|---|
--interactive | Запустить интерактивный мастер. |
--package-name | Явное имя npm-пакета для генерируемого плагина. |
--kind | Режим: plugin или demo-stand. |
--stand-mode | Сценарий стенда: oauth, closed-loop, react-adapter, advanced. |
--advanced-profile | Для --stand-mode advanced: subpath, shadow-dom, umd. |
--preset | Шаблон плагина: minimal или advanced. |
--bundler | vite или webpack — сборщик в шаблоне. |
--target | Поставка плагина: npm-package, browser, advanced. |
--advanced-target | Доп. цель для режима advanced (только webpack), см. справку CLI. |
--output-dir | Каталог, куда положить сгенерированный проект. |
--output-base | Базовый каталог: внутри него будет создана папка проекта. |
--force | Разрешить запись в уже существующую директорию. |
Полный список и актуальные значения перечислены в выводе:
npx @emailmaker/cli --help
Что умеет CLI
- интерактивный wizard и неинтерактивный запуск;
- генерация проекта плагина и демо-стендов;
- шаблоны под vite и webpack;
- выбор способа поставки плагина: npm-модуль, браузерный бандл, режим advanced.
Основные режимы
plugin
Внешний плагин: app-часть, sandbox, локальный debug host, базовые скрипты сборки.
demo-stand
Отдельный стенд для интеграции: варианты с OAuth, закрытым контуром, react-adapter и advanced-профилями.
Preset-ы для plugin
minimal— каркас без React-примера.advanced— React UI,ComponentRegistry, примеры панелей и API.
Примеры
С dev-пакетами:
npx @emailmaker/cli my-plugin --kind plugin --preset advanced --bundler vite --target npm-package --dev --output-dir ./my-plugin
Без dev (стабильные версии из реестра):
npx @emailmaker/cli my-plugin --kind plugin --preset advanced --bundler vite --target npm-package --output-dir ./my-plugin
После глобальной установки команда может называться emailmaker-cli.
Когда использовать CLI
- быстро создать новый внешний плагин;
- не собирать вручную конфиг vite / webpack;
- получить согласованную структуру app, sandbox и локальной отладки.