create-packkit 2.2.0 → 2.4.0

package/package.json

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

package/src/cli/args.js

@@ -15,6 +15,7 @@ const OVERRIDE_FLAGS = {
   license: 'license',
   pm: 'packageManager',
   node: 'nodeVersion',
+  server: 'serviceFramework',
   author: 'author',
   description: 'description',
   repo: 'repo',
@@ -54,6 +55,7 @@ export function parseCliArgs(argv) {
       canary: { type: 'boolean' },
       'pkg-checks': { type: 'boolean' },
       knip: { type: 'boolean' },
+      'size-limit': { type: 'boolean' },
       jsr: { type: 'boolean' },
       help: { type: 'boolean', short: 'h' },
       version: { type: 'boolean', short: 'v' },
@@ -83,6 +85,7 @@ export function parseCliArgs(argv) {
   if (values.canary) overrides.canary = true;
   if (values['pkg-checks']) overrides.pkgChecks = true;
   if (values.knip) overrides.knip = true;
+  if (values['size-limit']) overrides.sizeLimit = true;
   if (values.jsr) overrides.jsr = true;
   for (const [flag, key] of Object.entries(NEGATABLE)) {
     if (values[flag]) overrides[key] = false;

package/src/cli/index.js

@@ -39,6 +39,7 @@ Options:
   --pm <manager>      npm | pnpm | yarn | bun
   --language <ts|js>  --module <esm|cjs|dual>  --framework <none|react|vue|svelte>
   --target <library|cli|service|app>   (repeatable)   --storybook
+  --server <hono|fastify|express>   (HTTP service framework)
   --bundler <tsup|tsdown|unbuild|rollup|none>   --minify
   --test <vitest|jest|node|none>   --e2e (Playwright, for apps)
   --env (type-safe env validation, services/CLIs)   --no-sourcemaps
@@ -47,6 +48,7 @@ Options:
   --workflows <ci|npm-publish|pages|codeql|codecov|stale>   (repeatable)
   --deps <renovate|dependabot|none>  --license <MIT|Apache-2.0|ISC|none>
   --pkg-checks (publint + are-the-types-wrong)   --knip   --jsr   --canary
+  --size-limit (bundle-size budget, libraries)
   --no-coverage  --no-community  --no-agents  --no-vscode  --no-editorconfig
   --schema            Print the full option/preset schema as JSON (for tools/agents)
   -h, --help          Show this help

package/src/cli/wizard.js

@@ -36,6 +36,9 @@ export async function runWizard(seed = {}) {
     cfg.minify = bail(await p.confirm({ message: 'Minify the build output?', initialValue: false }));
   }
   cfg.test = bail(await p.select({ message: 'Test runner', options: asOptions('test'), initialValue: OPTIONS.test.default }));
+  if (cfg.target.includes('service')) {
+    cfg.serviceFramework = bail(await p.select({ message: 'Service framework', options: asOptions('serviceFramework'), initialValue: OPTIONS.serviceFramework.default }));
+  }
   if (cfg.target.includes('app')) {
     cfg.e2e = bail(await p.confirm({ message: 'Add Playwright end-to-end tests?', initialValue: false }));
   }

package/src/core/features/index.js

@@ -15,6 +15,7 @@ import githooks from './githooks.js';
 import release from './release.js';
 import cli from './cli.js';
 import checks from './checks.js';
+import sizelimit from './sizelimit.js';
 import jsr from './jsr.js';
 import workflows from './workflows.js';
 import storybook from './storybook.js';
@@ -38,6 +39,7 @@ export default [
   release,
   cli,
   checks,
+  sizelimit,
   jsr,
   workflows,
   storybook,

package/src/core/features/service.js

@@ -1,14 +1,16 @@
-// HTTP service target (Hono). Splits the app (testable) from the server entry
-// (which listens), adds start/dev scripts, and a Dockerfile.
+// HTTP service target. Supports Hono (default), Fastify and Express. Splits the
+// app (testable) from the server entry (which listens), adds start/dev scripts,
+// and a production Dockerfile.
 
 export default {
   id: 'service',
   active: (cfg) => cfg.hasService,
   apply(cfg) {
     const ext = cfg.ext;
+    const fw = cfg.serviceFramework || 'hono';
     const files = {
-      [`src/app.${ext}`]: appFile(cfg),
-      [`src/index.${ext}`]: serverFile(cfg),
+      [`src/app.${ext}`]: appFile(cfg, fw),
+      [`src/index.${ext}`]: serverFile(cfg, fw),
       Dockerfile: dockerfile(cfg),
       '.dockerignore': ['node_modules', 'dist', 'coverage', '.git', '.github', '.env', '.env.*', '!.env.example', '*.log', 'Dockerfile', '.dockerignore', ''].join('\n'),
     };
@@ -20,15 +22,50 @@ export default {
           start: 'node dist/index.js',
           dev: cfg.isTs ? 'tsx watch src/index.ts' : 'node --watch src/index.js',
         },
-        dependencies: { hono: '^4.5.0', '@hono/node-server': '^2.0.0' },
-        ...(cfg.isTs ? { devDependencies: { tsx: '^4.0.0' } } : {}),
+        dependencies: deps(fw),
+        devDependencies: {
+          ...(cfg.isTs ? { tsx: '^4.0.0' } : {}),
+          ...(cfg.isTs ? typeDeps(fw) : {}),
+        },
       },
     };
   },
 };
 
-function appFile(cfg) {
-  const t = cfg.isTs;
+function deps(fw) {
+  if (fw === 'fastify') return { fastify: '^5.0.0' };
+  if (fw === 'express') return { express: '^5.0.0' };
+  return { hono: '^4.5.0', '@hono/node-server': '^2.0.0' };
+}
+
+function typeDeps(fw) {
+  if (fw === 'express') return { '@types/express': '^5.0.0' };
+  return {};
+}
+
+function appFile(cfg, fw) {
+  if (fw === 'fastify') {
+    return [
+      `import Fastify from 'fastify';`,
+      ``,
+      `export const app = Fastify();`,
+      ``,
+      `app.get('/', async () => ({ ok: true, service: '${cfg.name}' }));`,
+      `app.get('/health', async () => 'ok');`,
+      ``,
+    ].join('\n');
+  }
+  if (fw === 'express') {
+    return [
+      `import express from 'express';`,
+      ``,
+      `export const app = express();`,
+      ``,
+      `app.get('/', (_req, res) => res.json({ ok: true, service: '${cfg.name}' }));`,
+      `app.get('/health', (_req, res) => res.send('ok'));`,
+      ``,
+    ].join('\n');
+  }
   return [
     `import { Hono } from 'hono';`,
     ``,
@@ -40,13 +77,43 @@ function appFile(cfg) {
   ].join('\n');
 }
 
-function serverFile(cfg) {
+function serverFile(cfg, fw) {
+  const port = cfg.env ? 'env.PORT' : 'Number(process.env.PORT) || 3000';
+  const envImport = cfg.env ? `import { env } from './env.js';` : null;
+
+  if (fw === 'fastify') {
+    return [
+      `import { app } from './app.js';`,
+      envImport,
+      ``,
+      `const port = ${port};`,
+      `app.listen({ port, host: '0.0.0.0' }).then((url) => {`,
+      `\tconsole.log(\`Listening on \${url}\`);`,
+      `}).catch((err) => {`,
+      `\tapp.log.error(err);`,
+      `\tprocess.exit(1);`,
+      `});`,
+      ``,
+    ].filter((l) => l !== null).join('\n');
+  }
+  if (fw === 'express') {
+    return [
+      `import { app } from './app.js';`,
+      envImport,
+      ``,
+      `const port = ${port};`,
+      `app.listen(port, () => {`,
+      `\tconsole.log(\`Listening on http://localhost:\${port}\`);`,
+      `});`,
+      ``,
+    ].filter((l) => l !== null).join('\n');
+  }
   return [
     `import { serve } from '@hono/node-server';`,
     `import { app } from './app.js';`,
-    cfg.env ? `import { env } from './env.js';` : null,
+    envImport,
     ``,
-    `const port = ${cfg.env ? 'env.PORT' : 'Number(process.env.PORT) || 3000'};`,
+    `const port = ${port};`,
     `serve({ fetch: app.fetch, port }, (info) => {`,
     `\tconsole.log(\`Listening on http://localhost:\${info.port}\`);`,
     `});`,

package/src/core/features/sizelimit.js

@@ -0,0 +1,23 @@
+// size-limit: a bundle-size budget for published libraries. Measures the
+// brotli-compressed size of the built entry and fails when it exceeds the
+// limit — cheap insurance against a dependency silently bloating the package.
+import { toJson } from '../render.js';
+
+export default {
+  id: 'sizelimit',
+  active: (cfg) => cfg.sizeLimit,
+  apply(cfg) {
+    return {
+      files: {
+        '.size-limit.json': toJson([{ name: cfg.name, path: 'dist/index.js', limit: '10 kB' }]),
+      },
+      pkg: {
+        scripts: { size: 'size-limit' },
+        devDependencies: {
+          'size-limit': '^11.0.0',
+          '@size-limit/preset-small-lib': '^11.0.0',
+        },
+      },
+    };
+  },
+};

package/src/core/features/test.js

@@ -68,6 +68,12 @@ export default {
       files[`src/index.test.${testExt}`] = exampleTest('node', cfg);
     }
 
+    // Express services test through supertest (no built-in inject).
+    if (cfg.hasService && cfg.serviceFramework === 'express') {
+      pkg.devDependencies.supertest = '^7.0.0';
+      if (cfg.isTs) pkg.devDependencies['@types/supertest'] = '^6.0.0';
+    }
+
     return { files, pkg };
   },
 };
@@ -82,13 +88,28 @@ function exampleTest(runner, cfg) {
   const imp = importPath(runner, cfg);
   if (cfg.hasService) {
     const api = runner === 'jest' ? '' : `import { describe, it, expect } from 'vitest';\n`;
+    const fw = cfg.serviceFramework || 'hono';
+    let imports, call, statusProp;
+    if (fw === 'fastify') {
+      imports = `import { app } from './app.js';`;
+      call = `await app.inject({ method: 'GET', url: '/' })`;
+      statusProp = 'statusCode';
+    } else if (fw === 'express') {
+      imports = `import request from 'supertest';\nimport { app } from './app.js';`;
+      call = `await request(app).get('/')`;
+      statusProp = 'status';
+    } else {
+      imports = `import { app } from './app.js';`;
+      call = `await app.request('/')`;
+      statusProp = 'status';
+    }
     return [
-      api + `import { app } from './app.js';`,
+      api + imports,
       ``,
       `describe('app', () => {`,
       `\tit('responds on /', async () => {`,
-      `\t\tconst res = await app.request('/');`,
-      `\t\texpect(res.status).toBe(200);`,
+      `\t\tconst res = ${call};`,
+      `\t\texpect(res.${statusProp}).toBe(200);`,
       `\t});`,
       `});`,
       ``,

package/src/core/features/workflows.js

@@ -80,6 +80,7 @@ function ciWorkflow(cfg, codecov) {
   if (cfg.test !== 'none') jobs.push(`      - run: ${pmRun(cfg, codecov ? 'coverage' : 'test')}`);
   if (cfg.knip) jobs.push(`      - run: ${pmRun(cfg, 'knip')}`);
   if (cfg.hasBuild) jobs.push(`      - run: ${pmRun(cfg, 'build')}`);
+  if (cfg.sizeLimit) jobs.push(`      - run: ${pmRun(cfg, 'size')}`); // after build (measures dist)
   if (cfg.pkgChecks) jobs.push(`      - run: ${pmRun(cfg, 'check:pkg')}`); // after build (attw packs dist)
   const cov = codecov
     ? '\n      - uses: codecov/codecov-action@v4\n        with:\n          token: ${{ secrets.CODECOV_TOKEN }}'

package/src/core/options.js

@@ -34,6 +34,14 @@ export const OPTIONS = {
       { value: 'cjs', label: 'CommonJS only' },
     ],
   },
+  serviceFramework: {
+    group: 'core', type: 'select', label: 'Service framework (HTTP service)', default: 'hono',
+    choices: [
+      { value: 'hono', label: 'Hono (fast, web-standard)' },
+      { value: 'fastify', label: 'Fastify' },
+      { value: 'express', label: 'Express' },
+    ],
+  },
   target: {
     group: 'core', type: 'multiselect', label: 'What are you building?', default: ['library'],
     choices: [
@@ -102,6 +110,7 @@ export const OPTIONS = {
   canary: { group: 'release', type: 'boolean', label: 'Snapshot / canary release workflow (Changesets)', default: false },
   pkgChecks: { group: 'quality', type: 'boolean', label: 'Package checks (publint + are-the-types-wrong)', default: false },
   knip: { group: 'quality', type: 'boolean', label: 'Knip (unused files / deps / exports)', default: false },
+  sizeLimit: { group: 'quality', type: 'boolean', label: 'size-limit (bundle-size budget, libraries)', default: false },
 
   // ---- lint / format ----
   lint: {
@@ -260,6 +269,8 @@ export function normalizeConfig(input = {}) {
   if (!cfg.publishable) cfg.pkgChecks = false;
   // Sourcemaps + shipped source only matter for a published package.
   if (!cfg.publishable) cfg.sourcemaps = false;
+  // A bundle-size budget needs a published package with a built entry.
+  if (!(cfg.publishable && cfg.hasBuild)) cfg.sizeLimit = false;
   // Env validation is for server-side runtimes (services / CLIs), not libs/apps.
   if (!(cfg.hasService || cfg.hasCli)) cfg.env = false;
   // Canary snapshots ride on the Changesets flow.