spinup-ts

Scaffold a production-ready TypeScript project with opinionated tooling — the TypeScript sibling of spinup-py and the TypeScript equivalent of cookiecutter-uv.

spinup-ts ⇄ spinup-py share the same CLI schema, so remembering one gives you the other.

Usage

# New project (interactive)
npx spinup-ts my-project
# or: pnpm dlx spinup-ts my-project
# or: bunx spinup-ts my-project

# New project (defaults only, no prompts)
npx spinup-ts my-project --non-interactive

# Retrofit an existing repo with template tooling
npx spinup-ts update .

Install globally if you scaffold often:

npm i -g spinup-ts
spinup-ts my-project

CLI

spinup-ts [new] <project-name>     Scaffold a new TypeScript project
spinup-ts update [dir]             Retrofit an existing repo with template tooling
spinup-ts --update [dir]           Alias for `update`

  -y, --yes, --non-interactive     Scaffold with defaults only, no prompts (needs <project-name>)
  -v, --version                    Print version
  -h, --help                       Show this help

Non-interactive defaults resolve from ~/.spinup-tsrc.json, then local git config (author name/email), then built-in fallbacks.

What's Included

| Python (cookiecutter-uv) | TypeScript equivalent | |---|---| | uv | pnpm | | ruff | Biome | | wemake-python-styleguide | ESLint strict (unicorn + sonarjs + import-x) | | mypy --strict | tsc --noEmit + @typescript-eslint/strictTypeChecked | | pytest + coverage | Vitest + @vitest/coverage-v8 | | mkdocs-material | Docusaurus | | deptry | depcheck | | pre-commit | Husky + lint-staged + commitlint | | Makefile | justfile | | tox (multi-version) | CI matrix over Node 20/22 | | release-please | release-please (release-type: node) |

Prompt Options

• Project name — kebab-case slug
• Description — one-liner
• Author / Email / GitHub handle
• Node version — 20, 22, 23
• Package manager — pnpm (default), bun, npm
• Project type — library, cli, server, mcp-server
• GitHub Actions — CI + release workflows
• Publish to npm — with provenance
• Docusaurus docs — deployed to GitHub Pages on release
• Codecov — coverage reporting
• Dockerfile — multi-stage Node build
• Devcontainer — full Claude Code-optimized environment
• License — MIT, Apache 2.0, BSD, ISC, GPL-3, None

Development

pnpm install
pnpm build
pnpm test