Разработка генератора

Подготовка

npm install
npm --prefix template install

Проверки

Перед отправкой изменений выполните:

npm run check
npm test
npm run build
npm run docs:build

Работа с шаблоном

Файлы из template/ копируются в новый проект. Утилиты из utilities/ не входят в базовый шаблон: CLI предлагает выбрать их при инициализации и переносит выбранные папки в src/utils/. Для локальной разработки template/src/utils — игнорируемая Git символьная ссылка на этот каталог, а utilities/tsconfig.json даёт редактору те же типы TypeScript и Vite, что у шаблона. Некоторые dotfiles хранятся под безопасными для npm именами:

В npm-шаблоне	В созданном проекте
_gitignore	.gitignore
_github/	.github/
_gitlab-ci.yml	.gitlab-ci.yml

Переименование выполняется в cli/project.js.

Проверка npm-пакета

Перед публикацией убедитесь, что шаблонные файлы входят в архив, а локальные ENV отсутствуют:

npm pack --dry-run

Документация

Исходники находятся в docs/. Навигация и поиск настраиваются в docs/.vitepress/config.ts, визуальная тема — в docs/.vitepress/theme/style.css.