Sobre el proyecto
CNA Templates es el repositorio oficial de plantillas y extensiones para la CLI create-awesome-node-app, publicado en npm. Su propósito es brindar a los desarrolladores un conjunto curado de puntos de partida de andamiaje y complementos opcionales que pueden combinarse al generar un nuevo proyecto basado en Node.
Plantillas y uso
El repositorio incluye diez plantillas iniciales, cada una con su propio README y un tipo de CLI correspondiente: React Vite (react, para aplicaciones frontend), Next.js (nextjs, full-stack), Next.js SaaS AI (nextjs-saas-ai, para aplicaciones SaaS e IA), NestJS (nestjs-backend, APIs de backend), Remix / React Router v7 (remix, full-stack), Astro (astro, sitios de contenido), Hono (hono, APIs ligeras), Turborepo (monorepo), WebdriverIO (webdriverio, pruebas end-to-end) y WebExtension React Vite (webextension-react, extensiones de navegador).
El andamiaje funciona de manera interactiva a través de npx create-awesome-node-app o de forma no interactiva nombrando una plantilla y complementos, por ejemplo --template react-vite-boilerplate --addons material-ui zustand. Un sitio web enumera los catálogos de plantillas y extensiones navegables.
Documentación y autoría
El directorio docs cubre una descripción general del sistema con el sistema de tipos y el flujo de generación, convenciones de autoría (diseño de archivos, variables EJS, el sistema package/, con una contraparte en español), una guía de flujo de trabajo de pruebas locales y CI, y un manual de mantenimiento que describe los procedimientos operativos para plantillas, extensiones, CI, dependencias, seguridad y lanzamientos. CONTRIBUTING.md explica cómo agregar nuevas plantillas y extensiones.
Modelo de verificación
El control de calidad se organiza en cuatro flujos de trabajo de GitHub Actions apilados. L0 Integrity verifica rutas del registro, enlaces de documentación, activos y perfiles. L1 Templates compila cada plantilla de forma aislada. L2 Extensions prueba una extensión contra una plantilla canónica. L3 Profiles ejercita pilas curadas de una por categoría. Las solicitudes de extracción (pull requests) deben pasar L0 y L1, con L2 y L3 ejecutándose para las rutas afectadas; una ejecución semanal cubre todas las capas. El README señala explícitamente que un CI en verde significa que las plantillas y las selecciones realistas funcionan, no que cada extensión pueda fusionarse en una sola aplicación combinada.
El repositorio también incluye un prompt de mantenimiento reutilizable destinado a asistentes de IA que trabajen en el ecosistema, que cubre verificaciones previas, flujo de trabajo basado en problemas, una corrección por solicitud de extracción, commits y documentación en inglés, validación local antes de subir y Trusted Publishing de npm a través de OIDC en lugar de un token manual.
El proyecto tiene licencia MIT, está dirigido a Node 22 o posterior y ofrece una comunidad de Discord, un rastreador de problemas y discusiones para soporte.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.