create-packkit 1.1.0 → 1.3.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.
 
@@ -64,6 +65,12 @@ npx create-packkit my-lib ts-lib --no-install --no-git   # deterministic scaffol
 
 There's also an [`llms.txt`](llms.txt) (served at [danmat.github.io/create-packkit/llms.txt](https://danmat.github.io/create-packkit/llms.txt)) describing the commands for LLMs.
 
+**MCP server** — [`packkit-mcp`](mcp) exposes Packkit as a native [Model Context Protocol](https://modelcontextprotocol.io) tool (schema / preview / scaffold). Add to your agent's MCP config:
+
+```json
+{ "mcpServers": { "packkit": { "command": "npx", "args": ["-y", "packkit-mcp"] } } }
+```
+
 ## How it works
 
 Packkit is a pure `config → { files }` **core** that runs in both Node and the browser:

package/llms.txt

@@ -37,6 +37,10 @@ npx create-packkit lib my-lib --no-install --no-git
 
 `--language ts|js` · `--framework none|react|vue|svelte` · `--target library|cli|service|app` (repeatable) · `--module esm|cjs|dual` · `--bundler tsup|tsdown|unbuild|rollup|none` · `--minify` · `--test vitest|jest|node|none` · `--lint eslint-prettier|biome|oxlint|none` · `--hooks ...` · `--release changesets|release-it|np|none` · `--workflows ci|npm-publish|pages|codeql|codecov|stale` (repeatable) · `--pkg-checks` (publint + are-the-types-wrong) · `--knip` · `--jsr` · `--deps renovate|dependabot|none` · `--license MIT|Apache-2.0|ISC|none` · `--pm npm|pnpm|yarn|bun` · `--from <file>` (load a JSON profile) · `--no-install` · `--no-git`
 
+## MCP server
+
+`packkit-mcp` exposes Packkit as Model Context Protocol tools (`packkit_schema`, `packkit_preview`, `packkit_scaffold`). MCP config: `{ "mcpServers": { "packkit": { "command": "npx", "args": ["-y", "packkit-mcp"] } } }`.
+
 ## Links
 - Web configurator: https://danmat.github.io/create-packkit/
 - Repo: https://github.com/DanMat/create-packkit

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-packkit",
-  "version": "1.1.0",
+  "version": "1.3.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": {

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.',