Об этом проекте
CNA Templates — это официальный репозиторий шаблонов и расширений для CLI create-awesome-node-app, опубликованный в npm. Его цель — предоставить разработчикам курируемый набор заготовок (scaffolding) и дополнительных модулей, которые можно комбинировать при создании нового проекта на базе Node.
Шаблоны и использование
Репозиторий содержит десять стартовых шаблонов, каждый из которых имеет собственный README и соответствующий тип CLI: React Vite (react, для фронтенд-приложений), Next.js (nextjs, full-stack), Next.js SaaS AI (nextjs-saas-ai, для SaaS и AI-приложений), NestJS (nestjs-backend, бэкенд-API), Remix / React Router v7 (remix, full-stack), Astro (astro, контентные сайты), Hono (hono, легковесные API), Turborepo (monorepo), WebdriverIO (webdriverio, сквозное тестирование) и WebExtension React Vite (webextension-react, расширения для браузеров).
Создание структуры проекта работает либо интерактивно через npx create-awesome-node-app, либо неинтерактивно путем указания шаблона и аддонов, например --template react-vite-boilerplate --addons material-ui zustand. На веб-сайте представлены каталоги шаблонов и расширений для просмотра.
Документация и авторство
Директория docs содержит обзор системы с описанием системы типов и процесса генерации, соглашения по авторству (структура файлов, переменные EJS, система package/ с эквивалентом на испанском языке), руководство по локальному тестированию и рабочему процессу CI, а также руководство по обслуживанию, описывающее операционные процедуры для шаблонов, расширений, CI, зависимостей, безопасности и релизов. Файл CONTRIBUTING.md объясняет, как добавлять новые шаблоны и расширения.
Модель верификации
Контроль качества организован в виде четырех уровней рабочих процессов GitHub Actions. L0 Integrity проверяет пути в реестре, ссылки в документации, ресурсы и профили. L1 Templates собирает каждый шаблон изолированно. L2 Extensions тестирует одно расширение на каноническом шаблоне. L3 Profiles проверяет курируемые стеки (по одному из каждой категории). Пул-реквесты должны пройти L0 и L1, при этом L2 и L3 запускаются для измененных путей; еженедельный запуск охватывает все уровни. В README прямо указано, что «зеленый» CI означает работоспособность шаблонов и реалистичных подборок, а не то, что каждое расширение можно объединить в одно общее приложение.
Репозиторий также включает многоразовый промпт для обслуживания, предназначенный для AI-ассистентов, работающих с экосистемой. Он охватывает предварительные проверки, рабочий процесс «сначала issue», одно исправление на один пул-реквест, коммиты и документацию на английском языке, локальную валидацию перед пушем и Trusted Publishing в npm через OIDC вместо ручного токена.
Проект распространяется под лицензией MIT, ориентирован на Node 22 или новее и предлагает сообщество в Discord, трекер задач и обсуждения для поддержки.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.