프로젝트 소개
CNA Templates는 npm에 게시된 create-awesome-node-app CLI의 공식 템플릿 및 확장 저장소입니다. 이 저장소의 목적은 개발자가 새로운 Node 기반 프로젝트를 생성할 때 조합하여 사용할 수 있는 엄선된 스캐폴딩 시작점과 선택적 애드온 세트를 제공하는 것입니다.
템플릿 및 사용법
이 저장소는 10개의 스타터 템플릿을 제공하며, 각 템플릿은 자체 README와 대응하는 CLI 타입을 가집니다: React Vite (react, 프론트엔드 앱), Next.js (nextjs, 풀스택), Next.js SaaS AI (nextjs-saas-ai, SaaS 및 AI 애플리케이션), NestJS (nestjs-backend, 백엔드 API), Remix / React Router v7 (remix, 풀스택), Astro (astro, 콘텐츠 사이트), Hono (hono, 경량 API), Turborepo (monorepo), WebdriverIO (webdriverio, E2E 테스트) 및 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는 새로운 템플릿과 확장을 추가하는 방법을 설명합니다.
검증 모델
품질 관리는 4단계의 계층형 GitHub Actions 워크플로우로 구성됩니다. L0는 레지스트리 경로, 문서 링크, 에셋 및 프로필의 무결성을 확인합니다. L1은 모든 템플릿을 개별적으로 빌드합니다. L2는 하나의 확장을 표준 템플릿에 대해 테스트합니다. L3는 카테고리당 하나씩 엄선된 스택을 실행합니다. 풀 리퀘스트는 L0와 L1을 통과해야 하며, 변경된 경로에 대해 L2와 L3가 실행됩니다. 매주 모든 계층에 대한 실행이 이루어집니다. README에는 CI가 통과했다는 것이 템플릿과 현실적인 선택 조합이 작동함을 의미하는 것이지, 모든 확장을 하나의 결합된 애플리케이션으로 병합할 수 있음을 의미하는 것은 아니라고 명시되어 있습니다.
또한 이 저장소에는 에코시스템에서 작업하는 AI 어시스턴트를 위한 재사용 가능한 유지관리 프롬프트가 포함되어 있습니다. 여기에는 사전 점검, 이슈 우선 워크플로우, 풀 리퀘스트당 하나의 수정, 영어 커밋 및 문서 작성, 푸시 전 로컬 검증, 그리고 수동 토큰 대신 OIDC를 통한 npm Trusted Publishing 사용 등이 포함됩니다.
이 프로젝트는 MIT 라이선스를 따르며, Node 22 이상을 대상으로 합니다. 지원을 위해 Discord 커뮤니티, 이슈 트래커 및 토론 공간을 제공합니다.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.