simple-node-starter

Minimal template for a publishable Node.js + TypeScript package.

Includes

• TypeScript library build: source in lib/, output to dist/, ESM ("type": "module")
• oxlint: fast linting with JSDoc + import-sort rules
• oxfmt: fast formatting
• Vitest: unit + integration test targets
• Changesets: versioning + changelog-friendly releases

Requirements

• Node: >= 22
• Package manager: pnpm

Setup

pnpm install

Daily commands

pnpm check        # lint + format check + typecheck + tests
pnpm check:fix    # lint:fix + format:fix + typecheck + tests
pnpm build        # emits to dist/

Individual commands

pnpm lint         # or pnpm lint:fix
pnpm format       # or pnpm format:fix
pnpm typecheck
pnpm test
pnpm test:unit
pnpm test:integration

Releasing (Changesets)

pnpm ci:add       # add a changeset
pnpm ci:version   # bump versions + update changelog
pnpm ci:publish   # publish + push tags