feat(node): add CLI and library templates

Author: bentruyman

.github/workflows/template-smoke.yml

@@ -16,23 +16,46 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        template:
-          - bun/cli
-          - bun/lib
+        include:
+          - template: bun/cli
+            runtime: bun
+            install: bun install
+            verify: bun run verify
+          - template: bun/lib
+            runtime: bun
+            install: bun install
+            verify: bun run verify
+          - template: node/cli
+            runtime: node
+            install: npm ci
+            verify: npm run verify
+          - template: node/lib
+            runtime: node
+            install: npm ci
+            verify: npm run verify
 
     steps:
       - name: Checkout
         uses: actions/checkout@v6
 
+      - name: Setup Node.js
+        if: matrix.runtime == 'node'
+        uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          cache: npm
+          cache-dependency-path: ${{ matrix.template }}/package-lock.json
+
       - name: Setup Bun
+        if: matrix.runtime == 'bun'
         uses: oven-sh/setup-bun@v2
         with:
           bun-version: "1.3.11"
 
       - name: Install dependencies
         working-directory: ${{ matrix.template }}
-        run: bun install
+        run: ${{ matrix.install }}
 
       - name: Verify template
         working-directory: ${{ matrix.template }}
-        run: bun run verify
+        run: ${{ matrix.verify }}

README.md

@@ -10,11 +10,15 @@ Use [giget](https://github.com/unjs/giget) to scaffold a new project:
 npx giget gh:bentruyman/templates/<template> <project-name>
 ```
 
+The Node templates require Node.js 24 or newer.
+
 ## Available Templates
 
 | Template             | Description                                    | Command                                            |
 | -------------------- | ---------------------------------------------- | -------------------------------------------------- |
 | [bun/cli](./bun/cli) | Bun CLI with TypeScript, Husky, and release-it | `npx giget gh:bentruyman/templates/bun/cli my-cli` |
 | [bun/lib](./bun/lib) | Bun library with TypeScript, Husky, and release-it | `npx giget gh:bentruyman/templates/bun/lib my-lib` |
+| [node/cli](./node/cli) | Node.js CLI with TypeScript, Vitest, Husky, and release-it | `npx giget gh:bentruyman/templates/node/cli my-cli` |
+| [node/lib](./node/lib) | Node.js library with TypeScript, Vitest, Husky, and release-it | `npx giget gh:bentruyman/templates/node/lib my-lib` |
 
 See each template's README for detailed usage instructions.

node/cli/.gitignore

@@ -0,0 +1,2 @@
+dist/
+node_modules/

node/cli/.husky/pre-commit

@@ -0,0 +1,3 @@
+npm exec lint-staged
+npm run typecheck
+npm test

node/cli/.oxfmtrc.jsonc

@@ -0,0 +1,10 @@
+{
+  "$schema": "./node_modules/oxfmt/configuration_schema.json",
+  "ignorePatterns": [".agents"],
+  "printWidth": 80,
+  "proseWrap": "always",
+  "sortImports": true,
+  "sortPackageJson": {
+    "sortScripts": true,
+  },
+}

node/cli/.release-it.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://unpkg.com/release-it/schema/release-it.json",
+  "git": {
+    "commitMessage": "chore: release v${version}"
+  },
+  "github": {
+    "release": true
+  },
+  "npm": {
+    "publish": true
+  },
+  "hooks": {
+    "before:init": ["npm run typecheck", "npm test"],
+    "after:bump": "npm run build"
+  }
+}

node/cli/README.md

@@ -0,0 +1,48 @@
+# node/cli
+
+A TypeScript CLI template using Node.js.
+
+## Requirements
+
+- Node.js 24 or newer
+
+## Getting Started
+
+```bash
+npx giget gh:bentruyman/templates/node/cli my-cli
+cd my-cli
+npm install
+```
+
+## Customize
+
+Update `package.json` with your project details:
+
+- `name` - Your CLI package name
+- `description` - What your CLI does
+- `bin` - Rename the command users will type
+
+## Scripts
+
+| Script              | Description                                   |
+| ------------------- | --------------------------------------------- |
+| `npm run build`     | Compile the CLI to `dist/`                    |
+| `npm run format`    | Format code with oxfmt and apply oxlint fixes |
+| `npm run lint`      | Check formatting and lint the template        |
+| `npm test`          | Run tests with Vitest                         |
+| `npm run typecheck` | Type-check with TypeScript                    |
+| `npm run verify`    | Run lint, typecheck, test, and build          |
+| `npm run release`   | Publish a new version with release-it         |
+
+## Development
+
+Run your CLI locally with Node's native TypeScript support:
+
+```bash
+node src/index.ts --help
+```
+
+## Publishing
+
+1. Update `package.json` name and bin fields
+2. Run `npm run release` to build, tag, and publish to npm