create-strange-lil-scaffold

create-strange-lil-scaffold

User-facing CLI for Strange Lil Scaffold — generate a tiny, publish‑ready TypeScript CLI project in seconds.

Quick start

# interactive
npx create-strange-lil-scaffold@latest my-app

# non-interactive defaults (CJS)
npx create-strange-lil-scaffold@latest my-app --yes

# choose module system
npx create-strange-lil-scaffold@latest my-app --module esm
npx create-strange-lil-scaffold@latest my-app --module cjs

# add Jest or custom test script
npx create-strange-lil-scaffold@latest my-app --jest
npx create-strange-lil-scaffold@latest my-app --test "vitest run"

Flags

• -y, --yes – accept defaults (non‑interactive)
• -m, --module <cjs|esm> – module system (or --esm)
• --jest – add jest.config.cjs and set "test": "jest"
• -t, --test "<script>" – custom test script (overrides --jest)
• -d, --dir <path> / --projectDir <path> – target directory
• --owner <name> / --repo <name> – for README badges
• --ci – create .github/workflows/publish.yml
• --no-gitignore – skip writing .gitignore
• -h, --help – show help

What you get

• package.json (bin → dist/cli.js, scripts, MIT, engines)
• tsconfig.json (CJS or ESM)
• src/cli.ts (hello‑world CLI)
• .gitignore (Node/TS basics, archives ignored)
• README.md (injects badges or creates one)
• .github/workflows/publish.yml (tag‑push → npm publish with NPM_TOKEN)

Publish via GitHub Actions

• Add repo secret NPM_TOKEN (Settings → Secrets and variables → Actions).
• Bump & tag:

  npm version patch   # creates git tag vX.Y.Z
  git push --follow-tags
  

• The workflow builds and publishes to npm (with provenance if run in CI).