create-packkit 1.2.0 → 1.4.0

package/README.md

@@ -45,11 +45,12 @@ No install needed: **[danmat.github.io/create-packkit](https://danmat.github.io/
 | **GitHub Actions** | CI · npm publish (provenance) · Pages · CodeQL · Codecov · stale bot |
 | **Deps** | Renovate · Dependabot · none |
 | **Repo** | LICENSE · community files · **AGENTS.md + CLAUDE.md** · VS Code · `.editorconfig` |
+| **Monorepo** | optional pnpm/npm/yarn workspace with **Turborepo** + Changesets + example packages |
 | **Package manager** | npm · pnpm · yarn · bun |
 
 ## Presets
 
-`ts-lib` · `js-lib` · `ts-cli` / `cli` · `react-lib` · `react-lib-js` · `react-app` · `vue-lib` · `vue-app` · `svelte-lib` · `svelte-app` · `node-service` · `oss` · `minimal` · `full` — named bundles of the options above. See the [roadmap](ROADMAP.md) for what's next.
+`ts-lib` · `js-lib` · `ts-cli` / `cli` · `react-lib` · `react-lib-js` · `react-app` · `vue-lib` · `vue-app` · `svelte-lib` · `svelte-app` · `node-service` · `monorepo` · `oss` · `minimal` · `full` — named bundles of the options above. See the [roadmap](ROADMAP.md) for what's next.
 
 **Team profiles:** save a partial config as `packkit.config.json` (or any file) and reuse it with `npx create-packkit my-lib --from ./packkit.config.json` — flags still override the file.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-packkit",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Highly configurable scaffolder for modern npm packages and CLIs — pick your stack (TS/JS, bundler, tests, linter, CI, releases) from a CLI or a web configurator.",
   "type": "module",
   "bin": {
@@ -24,6 +24,7 @@
   "scripts": {
     "start": "node bin/cli.js",
     "test": "node --test",
+    "check:deps": "node scripts/check-template-deps.mjs",
     "build:web": "esbuild src/core/index.js --bundle --format=esm --outfile=docs/packkit-core.js"
   },
   "repository": {

package/src/cli/args.js

@@ -38,6 +38,7 @@ export function parseCliArgs(argv) {
       from: { type: 'string' },
       name: { type: 'string' },
       yes: { type: 'boolean', short: 'y' },
+      recommended: { type: 'boolean' },
       here: { type: 'boolean' },
       'no-install': { type: 'boolean' },
       'no-git': { type: 'boolean' },
@@ -45,6 +46,7 @@ export function parseCliArgs(argv) {
       target: { type: 'string', multiple: true },
       workflows: { type: 'string', multiple: true },
       minify: { type: 'boolean' },
+      monorepo: { type: 'boolean' },
       storybook: { type: 'boolean' },
       'pkg-checks': { type: 'boolean' },
       knip: { type: 'boolean' },
@@ -70,6 +72,7 @@ export function parseCliArgs(argv) {
   if (values.target) overrides.target = values.target;
   if (values.workflows) overrides.workflows = values.workflows;
   if (values.minify) overrides.minify = true;
+  if (values.monorepo) overrides.monorepo = true;
   if (values.storybook) overrides.storybook = true;
   if (values['pkg-checks']) overrides.pkgChecks = true;
   if (values.knip) overrides.knip = true;
@@ -79,12 +82,17 @@ export function parseCliArgs(argv) {
   }
   if (name) overrides.name = name;
 
+  // Config flags provided (anything beyond the name) → the user knows what they
+  // want, so we can skip the wizard.
+  const hasConfigFlags = Object.keys(overrides).some((k) => k !== 'name');
+
   return {
     preset,
     from: values.from,
     name,
     here: !!values.here,
-    yes: !!values.yes,
+    yes: !!values.yes || !!values.recommended,
+    hasConfigFlags,
     install: !values['no-install'],
     git: !values['no-git'],
     help: !!values.help,

package/src/cli/index.js

@@ -30,7 +30,9 @@ Options:
   --from <file>       Load defaults from a JSON profile (or packkit.config.json)
   --name <name>       Package name
   --here              Scaffold into the current directory
-  -y, --yes           Accept defaults / preset, no prompts
+  -y, --yes           Accept defaults / preset, no prompts (one-shot)
+  --recommended       Alias for --yes — recommended defaults in one command
+  --monorepo          Generate a pnpm/Turborepo workspace
   --no-install        Skip dependency install
   --no-git            Skip git init
   --pm <manager>      npm | pnpm | yarn | bun
@@ -64,7 +66,9 @@ export async function run(argv = process.argv.slice(2)) {
     return void console.log(JSON.stringify({ version: pkgVersion(), options: OPTIONS, presets: PRESET_INFO, aliases: PRESET_ALIASES }, null, 2));
   }
 
-  const interactive = !args.preset && !args.yes && !args.from && process.stdout.isTTY;
+  // Only prompt when the user gave nothing to go on — a preset, --yes, a
+  // profile, or any config flag makes it a one-shot.
+  const interactive = !args.preset && !args.yes && !args.from && !args.hasConfigFlags && process.stdout.isTTY;
 
   // Precedence: preset < profile file < CLI flags.
   const profile = loadProfile(args);

package/src/core/features/frameworks.js

@@ -40,7 +40,7 @@ function react(cfg, files, pkg, forApp) {
       `}`,
       ``,
     ].join('\n');
-    pkg.dependencies = { react: '^18.3.0', 'react-dom': '^18.3.0' };
+    pkg.dependencies = { react: '^19.0.0', 'react-dom': '^19.0.0' };
   } else {
     files[`src/index.${x}`] = cfg.isTs
       ? [
@@ -56,12 +56,12 @@ function react(cfg, files, pkg, forApp) {
         ].join('\n')
       : [`export function Button({ label, onClick }) {`, `\treturn <button onClick={onClick}>{label}</button>;`, `}`, ``].join('\n');
     pkg.peerDependencies = { react: '>=18', 'react-dom': '>=18' };
-    pkg.devDependencies.react = '^18.3.0';
-    pkg.devDependencies['react-dom'] = '^18.3.0';
+    pkg.devDependencies.react = '^19.0.0';
+    pkg.devDependencies['react-dom'] = '^19.0.0';
   }
   if (cfg.isTs) {
-    pkg.devDependencies['@types/react'] = '^18.3.0';
-    pkg.devDependencies['@types/react-dom'] = '^18.3.0';
+    pkg.devDependencies['@types/react'] = '^19.0.0';
+    pkg.devDependencies['@types/react-dom'] = '^19.0.0';
   }
 }
 

package/src/core/index.js

@@ -6,6 +6,7 @@ import { normalizeConfig, OPTIONS, GROUPS, defaultConfig } from './options.js';
 import { deepMerge, toJson } from './render.js';
 import { finalizePackageJson } from './pkg.js';
 import features from './features/index.js';
+import { buildMonorepo } from './monorepo.js';
 import { PRESETS, PRESET_NAMES, PRESET_INFO, PRESET_ALIASES, resolvePreset } from './presets.js';
 
 export { OPTIONS, GROUPS, defaultConfig, normalizeConfig, PRESETS, PRESET_NAMES, PRESET_INFO, PRESET_ALIASES, resolvePreset };
@@ -20,6 +21,8 @@ export function fromPreset(name, overrides = {}) {
 /** Turn a config into a complete set of files. */
 export function generate(input) {
   const cfg = normalizeConfig(input);
+  if (cfg.monorepo) return buildMonorepo(cfg);
+
   const files = {};
   let pkg = {};
 

package/src/core/monorepo.js

@@ -0,0 +1,236 @@
+// Monorepo generation — a pnpm/Turborepo (or npm/yarn workspaces) workspace
+// with Changesets and two example packages (one depending on the other).
+// This is a distinct shape from a single package, so generate() delegates here.
+
+import { toJson } from './render.js';
+import community from './features/community.js';
+import agents from './features/agents.js';
+import gitfiles from './features/gitfiles.js';
+
+export function buildMonorepo(cfg) {
+  const files = {};
+  const pm = cfg.packageManager;
+  const scope = cfg.name.replace(/^@/, '').split('/')[0];
+  const core = `@${scope}/core`;
+  const utils = `@${scope}/utils`;
+  const wsProto = pm === 'pnpm' ? 'workspace:*' : '*';
+
+  // Reuse the package-agnostic root files (LICENSE, community, AGENTS.md, gitignore).
+  for (const feat of [community, agents, gitfiles]) {
+    if (feat.active(cfg)) Object.assign(files, feat.apply(cfg).files);
+  }
+
+  // ---- root ----
+  const rootPkg = {
+    name: cfg.name,
+    version: '0.0.0',
+    private: true,
+    type: 'module',
+    ...(cfg.license !== 'none' ? { license: cfg.license } : {}),
+    ...(pm === 'pnpm' ? { packageManager: 'pnpm@9.10.0' } : { workspaces: ['packages/*'] }),
+    scripts: {
+      build: 'turbo build',
+      test: 'turbo test',
+      lint: 'turbo lint',
+      typecheck: 'turbo typecheck',
+      dev: 'turbo dev',
+      changeset: 'changeset',
+      version: 'changeset version',
+      release: 'turbo build && changeset publish',
+    },
+    devDependencies: {
+      turbo: '^2.0.0',
+      typescript: '^5.5.0',
+      tsup: '^8.0.0',
+      vitest: '^2.0.0',
+      eslint: '^9.0.0',
+      '@eslint/js': '^9.0.0',
+      'typescript-eslint': '^8.0.0',
+      prettier: '^3.3.0',
+      '@changesets/cli': '^2.27.0',
+      '@types/node': `^${cfg.nodeVersion}.0.0`,
+    },
+  };
+  files['package.json'] = toJson(rootPkg);
+
+  if (pm === 'pnpm') files['pnpm-workspace.yaml'] = 'packages:\n  - "packages/*"\n';
+
+  files['turbo.json'] = toJson({
+    $schema: 'https://turbo.build/schema.json',
+    tasks: {
+      build: { dependsOn: ['^build'], outputs: ['dist/**'] },
+      test: { dependsOn: ['^build'] },
+      typecheck: { dependsOn: ['^build'] },
+      lint: {},
+      dev: { cache: false, persistent: true },
+    },
+  });
+
+  files['tsconfig.base.json'] = toJson({
+    $schema: 'https://json.schemastore.org/tsconfig',
+    compilerOptions: {
+      target: 'ES2022',
+      module: 'ESNext',
+      moduleResolution: 'Bundler',
+      lib: ['ES2022'],
+      strict: true,
+      esModuleInterop: true,
+      skipLibCheck: true,
+      declaration: true,
+      noEmit: true,
+    },
+  });
+
+  files['.changeset/config.json'] = toJson({
+    $schema: 'https://unpkg.com/@changesets/config@3.0.0/schema.json',
+    changelog: '@changesets/cli/changelog',
+    commit: false,
+    access: 'public',
+    baseBranch: 'main',
+  });
+  files['.changeset/README.md'] = '# Changesets\n\nRun `npx changeset` to record a version bump for your next release.\n';
+
+  files['eslint.config.js'] = [
+    `import js from '@eslint/js';`,
+    `import tseslint from 'typescript-eslint';`,
+    ``,
+    `export default tseslint.config(`,
+    `\tjs.configs.recommended,`,
+    `\t...tseslint.configs.recommended,`,
+    `\t{ ignores: ['**/dist'] },`,
+    `);`,
+    ``,
+  ].join('\n');
+  files['.prettierrc.json'] = toJson({ useTabs: true, singleQuote: true, semi: true, printWidth: 100, trailingComma: 'all' });
+
+  files['README.md'] = rootReadme(cfg, pm, core, utils);
+  files['.github/workflows/ci.yml'] = ciWorkflow(cfg, pm);
+
+  // ---- packages ----
+  addPackage(files, {
+    name: core,
+    dir: 'packages/core',
+    src: [
+      `/** Greet someone by name. */`,
+      `export function greet(name: string): string {`,
+      `\treturn \`Hello, \${name}!\`;`,
+      `}`,
+      ``,
+    ].join('\n'),
+    test: exampleTest(`import { greet } from './index.js';`, `expect(greet('world')).toBe('Hello, world!')`),
+    deps: {},
+  });
+
+  addPackage(files, {
+    name: utils,
+    dir: 'packages/utils',
+    src: [
+      `import { greet } from '${core}';`,
+      ``,
+      `/** Greet someone, loudly. */`,
+      `export function shout(name: string): string {`,
+      `\treturn greet(name).toUpperCase();`,
+      `}`,
+      ``,
+    ].join('\n'),
+    test: exampleTest(`import { shout } from './index.js';`, `expect(shout('world')).toBe('HELLO, WORLD!')`),
+    deps: { [core]: wsProto },
+  });
+
+  const install = pm === 'npm' ? 'npm install' : `${pm} install`;
+  return {
+    config: cfg,
+    files,
+    postCommands: cfg.gitInit ? ['git init', 'git add -A', 'git commit -m "Initial commit from Packkit"'] : [],
+    summary: {
+      name: cfg.name,
+      fileCount: Object.keys(files).length,
+      stack: ['monorepo', `${pm}+turbo`, 'TypeScript', 'tsup', 'vitest', 'changesets'],
+      workflows: ['ci'],
+    },
+  };
+}
+
+function addPackage(files, { name, dir, src, test, deps }) {
+  const pkg = {
+    name,
+    version: '0.0.0',
+    type: 'module',
+    main: './dist/index.js',
+    types: './dist/index.d.ts',
+    exports: { '.': { types: './dist/index.d.ts', default: './dist/index.js' } },
+    files: ['dist'],
+    scripts: {
+      build: 'tsup src/index.ts --format esm --dts --clean',
+      dev: 'tsup src/index.ts --format esm --dts --watch',
+      test: 'vitest run',
+      typecheck: 'tsc --noEmit',
+      lint: 'eslint .',
+    },
+    ...(Object.keys(deps).length ? { dependencies: deps } : {}),
+  };
+  files[`${dir}/package.json`] = toJson(pkg);
+  files[`${dir}/tsconfig.json`] = toJson({ extends: '../../tsconfig.base.json', include: ['src'] });
+  files[`${dir}/src/index.ts`] = src;
+  files[`${dir}/src/index.test.ts`] = test;
+}
+
+function exampleTest(importLine, assertion) {
+  return [`import { describe, it, expect } from 'vitest';`, importLine, ``, `describe('example', () => {`, `\tit('works', () => {`, `\t\t${assertion};`, `\t});`, `});`, ``].join('\n');
+}
+
+function ciWorkflow(cfg, pm) {
+  const setup = ['      - uses: actions/checkout@v4'];
+  if (pm === 'pnpm') setup.push('      - uses: pnpm/action-setup@v4');
+  setup.push(
+    '      - uses: actions/setup-node@v4',
+    '        with:',
+    `          node-version: '${cfg.nodeVersion}'`,
+    `          cache: '${pm === 'yarn' ? 'yarn' : pm === 'pnpm' ? 'pnpm' : 'npm'}'`,
+  );
+  const install = pm === 'npm' ? 'npm ci' : pm === 'pnpm' ? 'pnpm install --frozen-lockfile' : `${pm} install --frozen-lockfile`;
+  const run = (s) => (pm === 'npm' ? `npm run ${s}` : `${pm} ${s}`);
+  return [
+    'name: CI',
+    'on:',
+    '  push:',
+    '    branches: [main]',
+    '  pull_request:',
+    'jobs:',
+    '  ci:',
+    '    runs-on: ubuntu-latest',
+    '    steps:',
+    setup.join('\n'),
+    `      - run: ${install}`,
+    `      - run: ${run('typecheck')}`,
+    `      - run: ${run('lint')}`,
+    `      - run: ${run('test')}`,
+    `      - run: ${run('build')}`,
+    '',
+  ].join('\n');
+}
+
+function rootReadme(cfg, pm, core, utils) {
+  const install = pm === 'npm' ? 'npm install' : `${pm} install`;
+  const run = (s) => (pm === 'npm' ? `npm run ${s}` : `${pm} ${s}`);
+  return [
+    `# ${cfg.name}`,
+    '',
+    cfg.description || '_A monorepo scaffolded with [Packkit](https://danmat.github.io/create-packkit/)._',
+    '',
+    '## Packages',
+    '',
+    `- \`${core}\` — the core library`,
+    `- \`${utils}\` — utilities built on \`${core}\``,
+    '',
+    '## Develop',
+    '',
+    '```sh',
+    install,
+    run('build') + '     # build all packages (Turborepo)',
+    run('test'),
+    '```',
+    '',
+    cfg.license !== 'none' ? `## License\n\n${cfg.license}${cfg.author ? ' © ' + cfg.author : ''}\n` : '',
+  ].join('\n');
+}

package/src/core/options.js

@@ -37,6 +37,9 @@ export const OPTIONS = {
       { value: 'app', label: 'App (Vite SPA)' },
     ],
   },
+  monorepo: {
+    group: 'core', type: 'boolean', label: 'Monorepo (pnpm/Turborepo workspace)', default: false,
+  },
   framework: {
     group: 'core', type: 'select', label: 'Framework', default: 'none',
     choices: [
@@ -240,6 +243,9 @@ export function normalizeConfig(input = {}) {
   // Storybook only applies to component libraries.
   if (!cfg.hasFramework || cfg.hasApp || !cfg.hasLibrary) cfg.storybook = false;
 
+  // A monorepo is its own generation path (see buildMonorepo); it has a build.
+  if (cfg.monorepo) cfg.hasBuild = true;
+
   cfg.publishable = (cfg.hasLibrary || cfg.hasCli) && !cfg.hasApp && !cfg.hasService;
   // Package-correctness checks only make sense for a publishable package.
   if (!cfg.publishable) cfg.pkgChecks = false;

package/src/core/presets.js

@@ -18,6 +18,7 @@ export const PRESETS = {
     test: 'vitest', lint: 'eslint-prettier', gitHooks: 'simple-git-hooks',
     release: 'none', workflows: ['ci'], deps: 'renovate', agents: true, vscode: true,
   },
+  monorepo: { monorepo: true, language: 'ts', packageManager: 'pnpm' },
   oss: {
     language: 'ts', target: ['library'], moduleFormat: 'dual', bundler: 'tsup',
     test: 'vitest', coverage: true, lint: 'eslint-prettier', gitHooks: 'simple-git-hooks',
@@ -76,6 +77,7 @@ export const PRESET_INFO = {
   'svelte-lib': 'Svelte component library — ships source, peer svelte, jsdom tests.',
   'svelte-app': 'Svelte SPA — Vite dev server, build, Testing Library.',
   'node-service': 'Node HTTP service (Hono) — tsx dev, tsup build, Dockerfile.',
+  monorepo: 'pnpm + Turborepo workspace — two example packages, Changesets, CI.',
   oss: 'Full open-source library — coverage, CodeQL, Codecov, Renovate, Changesets.',
   minimal: 'Bare TS library — tsup only, no tests/lint/CI.',
   full: 'Everything on — library + CLI, all workflows and extras.',