Sobre o projeto
CNA Templates é o repositório oficial de templates e extensões para a CLI create-awesome-node-app, publicado no npm. Seu propósito é fornecer aos desenvolvedores um conjunto curado de pontos de partida de scaffolding e addons opcionais que podem ser combinados ao gerar um novo projeto baseado em Node.
Templates e uso
O repositório fornece dez templates iniciais, cada um com seu próprio README e um tipo de CLI correspondente: React Vite (react, para apps frontend), Next.js (nextjs, full-stack), Next.js SaaS AI (nextjs-saas-ai, para aplicações SaaS e AI), NestJS (nestjs-backend, APIs de backend), Remix / React Router v7 (remix, full-stack), Astro (astro, sites de conteúdo), Hono (hono, APIs leves), Turborepo (monorepo), WebdriverIO (webdriverio, testes end-to-end) e WebExtension React Vite (webextension-react, extensões de navegador).
O scaffolding funciona de forma interativa via npx create-awesome-node-app ou de forma não interativa ao nomear um template e addons, por exemplo --template react-vite-boilerplate --addons material-ui zustand. Um website lista os catálogos de templates e extensões navegáveis.
Documentação e autoria
O diretório docs abrange uma visão geral do sistema com o sistema de tipos e o fluxo de geração, convenções de autoria (layout de arquivos, variáveis EJS, o sistema package/, com uma contraparte em espanhol), um guia de fluxo de trabalho de testes locais e CI, e um runbook de manutenção descrevendo procedimentos operacionais para templates, extensões, CI, dependências, segurança e releases. O CONTRIBUTING.md explica como adicionar novos templates e extensões.
Modelo de verificação
O controle de qualidade é organizado em quatro fluxos de trabalho de GitHub Actions empilhados. L0 Integrity verifica caminhos de registro, links de documentação, assets e perfis. L1 Templates compila cada template isoladamente. L2 Extensions testa uma extensão contra um template canônico. L3 Profiles exercita stacks curadas de um por categoria. Pull requests devem passar em L0 e L1, com L2 e L3 executando para caminhos alterados; uma execução semanal cobre todas as camadas. O README observa explicitamente que CI verde significa que os templates e seleções realistas funcionam, não que cada extensão possa ser mesclada em uma única aplicação combinada.
O repositório também inclui um prompt de manutenção reutilizável destinado a assistentes de IA que trabalham no ecossistema, cobrindo verificações prévias, fluxo de trabalho priorizando issues, uma correção por pull request, commits e docs em inglês, validação local antes do push, e npm Trusted Publishing via OIDC em vez de um token manual.
O projeto possui licença MIT, visa o Node 22 ou superior e oferece uma comunidade no Discord, rastreador de issues e discussões para suporte.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.