About this project
CNA Templates is the official template and extension repository for the create-awesome-node-app CLI, published on npm. Its purpose is to give developers a curated set of scaffolding starting points and optional addons that can be combined when generating a new Node-based project.
Templates and usage
The repository ships ten starter templates, each with its own README and a corresponding CLI type: React Vite (react, for frontend apps), Next.js (nextjs, full-stack), Next.js SaaS AI (nextjs-saas-ai, for SaaS and AI applications), NestJS (nestjs-backend, backend APIs), Remix / React Router v7 (remix, full-stack), Astro (astro, content sites), Hono (hono, lightweight APIs), Turborepo (monorepo), WebdriverIO (webdriverio, end-to-end testing) and WebExtension React Vite (webextension-react, browser extensions).
Scaffolding works either interactively via npx create-awesome-node-app or non-interactively by naming a template and addons, for example --template react-vite-boilerplate --addons material-ui zustand. A website lists the browsable template and extension catalogs.
Documentation and authoring
The docs directory covers a system overview with the type system and generation flow, authoring conventions (file layout, EJS variables, the package/ system, with a Spanish-language counterpart), a local testing and CI workflow guide, and a maintenance runbook describing operational procedures for templates, extensions, CI, dependencies, security and releases. CONTRIBUTING.md explains how to add new templates and extensions.
Verification model
Quality control is organized into four stacked GitHub Actions workflows. L0 Integrity checks registry paths, documentation links, assets and profiles. L1 Templates builds every template in isolation. L2 Extensions tests one extension against a canonical template. L3 Profiles exercises curated one-per-category stacks. Pull requests must pass L0 and L1, with L2 and L3 running for touched paths; a weekly run covers all layers. The README explicitly notes that green CI means templates and realistic selections work, not that every extension can be merged into a single combined application.
The repository also includes a reusable maintenance prompt intended for AI assistants working on the ecosystem, covering pre-flight checks, issue-first workflow, one fix per pull request, English-language commits and docs, local validation before pushing, and npm Trusted Publishing via OIDC rather than a manual token.
The project is MIT licensed, targets Node 22 or newer, and offers a Discord community, issue tracker and discussions for support.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.