@theholocron/node-template

A modern NodeJS template with pre-configured tools, best practices, and CI/CD setup for rapid project development.

Use the Holocron CLI to scaffold a new repo. It clones the template, renames all placeholder references, and runs holocron setup in one step:

npx @theholocron/cli new node my-library \
 --description "My library description" \
 --homepage "https://my-library.example.com" \
 --agent claude

This will:

1. Create theholocron/my-library from this template on GitHub
2. Replace all node-template references with my-library throughout the repo
3. Run pnpm install
4. Run holocron setup to configure branch protection, labels, workflows, and repo settings

pnpm install --save-dev @theholocron/node-template

import { doSomething, type SomethingOptions } from "@theholocron/node-template";
function App(options: SomethingOptions) {
 return doSomething(options);
}

This repo uses pnpm workspaces.

pnpm install # install all deps
pnpm build # build all packages
pnpm test # test all packages
pnpm typecheck # typecheck all packages
pnpm lint # lint all packages

Releases are automated via semantic-release on push to main. All packages are versioned and published in lockstep. See CHANGELOG.md for the release history.