cna-templates

CNA Templates est le dépôt officiel de modèles et d'extensions pour le CLI create-awesome-node-app, publié sur npm. Son objectif est de fournir aux développeurs un ensemble organisé de points de départ d'échafaudage et d'add-ons optionnels pouvant être combinés lors de la génération d'un nouveau projet basé sur Node. Modèles et utilisation Le dépôt propose dix modèles de démarrage, chacun avec son propre README et un type CLI correspondant : React Vite (react, pour les applications frontend), Next.js (nextjs, full-stack), Next.js SaaS AI (nextjs-saas-ai, pour les applications SaaS et IA), NestJS (nestjs-backend, API backend), Remix / React Router v7 (remix, full-stack), Astro (astro, sites de contenu), Hono (hono, API légères), Turborepo (monorepo), WebdriverIO (webdriverio, tests de bout en bout) et WebExtension React Vite (webextension-react, extensions de navigateur). L'échafaudage fonctionne soit de manière interactive via npx create-awesome-node-app, soit de manière non interactive en nommant un modèle et des add-ons, par exemple --template react-vite-boilerplate --addons material-ui zustand. Un site web répertorie les catalogues de modèles et d'extensions consultables. Documentation et rédaction Le répertoire docs couvre une vue d'ensemble du système avec le système de types et le flux de génération, les conventions de rédaction (disposition des fichiers, variables EJS, le système package/, avec un équivalent en espagnol), un guide du workflow de test local et de CI, ainsi qu'un guide de maintenance décrivant les procédures opérationnelles pour les modèles, les extensions, la CI, les dépendances, la sécurité et les versions. CONTRIBUTING.md explique comment ajouter de nouveaux modèles et extensions. Modèle de vérification Le contrôle qualité est organisé en quatre workflows GitHub Actions superposés. L0 Integrity vérifie les chemins du registre, les liens de documentation, les ressources et les profils. L1 Templates construit chaque modèle de manière isolée. L2 Extensions teste une extension par rapport à un modèle canonique. L3 Profiles exerce des piles organisées d'un élément par catégorie. Les pull requests doivent passer L0 et L1, L2 et L3 s'exécutant pour les chemins modifiés ; un run hebdomadaire couvre toutes les couches. Le README note explicitement qu'une CI verte signifie que les modèles et les sélections réalistes fonctionnent, et non que chaque extension peut être fusionnée dans une seule application combinée. Le dépôt inclut également un prompt de maintenance réutilisable destiné aux assistants IA travaillant sur l'écosystème, couvrant les vérifications préalables, le workflow axé sur les tickets, une correction par pull request, les commits et la documentation en anglais, la validation locale avant le push, et le Trusted Publishing npm via OIDC plutôt qu'un jeton manuel. Le projet est sous licence MIT, cible Node 22 ou plus récent, et propose une communauté Discord, un suivi des problèmes et des discussions pour le support.