create-semaphor-app 0.1.4 → 0.1.5

package/README.md

@@ -7,8 +7,9 @@ npx create-semaphor-app@latest
 ```
 
 The CLI scaffolds the public Semaphor Data App Starter, installs local
-dependencies by default, and can optionally install the Semaphor Agent Plugin
-for detected Codex and Claude Code installations.
+dependencies by default, installs the production Semaphor shadcn registry
+components, and can optionally install the Semaphor Agent Plugin for detected
+Codex and Claude Code installations.
 
 It does not authenticate to Semaphor, write tokens, or choose a project/domain.
 The Semaphor Agent Plugin handles OAuth, project selection, runtime token
@@ -25,7 +26,7 @@ When `app-name` is omitted, the CLI creates `./semaphor-data-app`.
 Options:
 
 ```text
---no-install              Skip dependency installation.
+--no-install              Skip dependency installation. Requires --components none.
 --package-manager <name>  Use npm, pnpm, yarn, or bun. Defaults to detected npm.
 --skip-plugin             Skip Codex/Claude plugin install prompts.
 --install-codex-plugin    Install the Codex plugin without prompting.
@@ -34,7 +35,7 @@ Options:
 --template-ref <ref>      Git branch/tag for the default starter repo. Defaults to main.
 --shadcn-preset <preset>  Apply a shadcn preset before adding Semaphor components.
 --shadcn-base <base>      Pass base or radix to shadcn init when using a preset.
---components <list>       Add Semaphor registry components. Use none, query, metrics,
+--components <list>       Add Semaphor registry components. Defaults to all. Use none, query, metrics,
                           filters, card, table, matrix, recommended, all, or a comma-separated list.
 --yes                     Use noninteractive defaults; skip optional plugin installs unless explicit.
 --help                    Show help.
@@ -49,10 +50,14 @@ style, pass a shadcn preset during creation:
 npx create-semaphor-app@latest my-app --shadcn-preset <preset-id>
 ```
 
-Semaphor UI helpers can be added from the public shadcn registry at scaffold
-time:
+Semaphor UI helpers are added from the public shadcn registry at scaffold time.
+By default, `create-semaphor-app` installs all production app-building
+components. Use `--components none` when you want the starter without Semaphor
+registry components:
 
 ```bash
+npx create-semaphor-app@latest my-app
+npx create-semaphor-app@latest my-app --components none
 npx create-semaphor-app@latest my-app --components table
 npx create-semaphor-app@latest my-app --components query-state,view-card,metric-kpis,filter-controls,server-data-table,matrix-table
 ```
@@ -61,7 +66,7 @@ Component presets:
 
 | Value | Installs |
 | --- | --- |
-| `none` | No Semaphor registry components. This is the default. |
+| `none` | No Semaphor registry components. |
 | `query` | `query-state` |
 | `metrics` | `query-state-boundary`, `metric-kpis` |
 | `filters` | `filter-controls` |
@@ -69,14 +74,14 @@ Component presets:
 | `table` | `query-state`, `server-data-table` |
 | `matrix` | `query-state`, `matrix-table` |
 | `recommended` | `query-state`, `query-state-boundary`, `view-card`, `metric-kpis`, `filter-controls`, `server-data-table` |
-| `all` | `query-state`, `query-state-boundary`, `view-card`, `metric-kpis`, `filter-controls`, `server-data-table`, `matrix-table` |
+| `all` | `query-state`, `query-state-boundary`, `view-card`, `metric-kpis`, `filter-controls`, `server-data-table`, `matrix-table`. This is the default. |
 
 Registry components install as source into the generated app. They are optional
 UI accelerators and do not replace `react-semaphor/data-app-sdk`.
 
-`--shadcn-preset` and `--components` run the shadcn CLI, so they cannot be
-combined with `--no-install`. To skip installs, scaffold the app first and run
-the shadcn commands manually later.
+`--shadcn-preset` and installed registry components run the shadcn CLI. To skip
+installs, pass `--no-install --components none`, then run the shadcn commands
+manually later if needed.
 
 ## Local Validation
 

package/bin/create-semaphor-app.mjs

@@ -65,7 +65,7 @@ Usage:
   npx create-semaphor-app@latest [app-name] [options]
 
 Options:
-  --no-install              Skip dependency installation.
+  --no-install              Skip dependency installation. Requires --components none.
   --package-manager <name>  Use npm, pnpm, yarn, or bun.
   --skip-plugin             Skip Codex/Claude plugin install prompts.
   --install-codex-plugin    Install the Codex plugin without prompting.
@@ -74,7 +74,7 @@ Options:
   --template-ref <ref>      Git branch/tag for the default starter repo.
   --shadcn-preset <preset>  Apply a shadcn preset before adding Semaphor components.
   --shadcn-base <base>      Pass base or radix to shadcn init when using a preset.
-  --components <list>       Add Semaphor registry components. Use none, query, metrics,
+  --components <list>       Add Semaphor registry components. Defaults to all. Use none, query, metrics,
                             filters, card, table, matrix, recommended, all, or a comma-separated list.
   --yes, -y                 Use noninteractive defaults; skip optional plugin installs unless explicit.
   --help, -h                Show this help.
@@ -93,7 +93,7 @@ function parseArgs(argv) {
     templateRef: DEFAULT_TEMPLATE_REF,
     shadcnPreset: null,
     shadcnBase: null,
-    components: 'none',
+    components: 'all',
     yes: false,
     help: false,
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-semaphor-app",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Create a Semaphor Data App starter project.",
   "type": "module",
   "bin": {

package/scripts/smoke-test.mjs

@@ -98,6 +98,8 @@ async function main() {
         '--template',
         defaultLocalStarterPath,
         '--no-install',
+        '--components',
+        'none',
         '--skip-plugin',
         '--yes',
       ], { cwd: root });
@@ -113,6 +115,8 @@ async function main() {
         '--template',
         defaultLocalStarterPath,
         '--no-install',
+        '--components',
+        'none',
         '--skip-plugin',
         '--yes',
       ], { cwd: root });
@@ -126,6 +130,8 @@ async function main() {
       const result = runCli([
         'github-template-app',
         '--no-install',
+        '--components',
+        'none',
         '--skip-plugin',
         '--yes',
       ], { cwd: root });
@@ -146,6 +152,8 @@ async function main() {
         '--template',
         defaultLocalStarterPath,
         '--no-install',
+        '--components',
+        'none',
         '--install-codex-plugin',
       ], {
         cwd: root,
@@ -168,6 +176,52 @@ async function main() {
       console.log('✓ fake Codex plugin install path');
     }
 
+    {
+      const root = createTempRoot('default-components-');
+      const binDir = path.join(root, 'bin');
+      fs.mkdirSync(binDir, { recursive: true });
+      const shadcnLog = path.join(root, 'shadcn.log');
+      const npmLog = path.join(root, 'npm.log');
+      createFakeCommand(binDir, 'npx', shadcnLog);
+      createFakeCommand(binDir, 'npm', npmLog);
+
+      const result = runCli([
+        'default-components-app',
+        '--template',
+        defaultLocalStarterPath,
+        '--skip-plugin',
+        '--yes',
+        '--package-manager',
+        'npm',
+      ], {
+        cwd: root,
+        env: {
+          ...process.env,
+          PATH: `${binDir}${path.delimiter}${process.env.PATH || ''}`,
+        },
+      });
+      assertSuccess(result, 'default component install');
+      assertScaffold(root, 'default-components-app');
+      const npmInstallLog = fs.readFileSync(npmLog, 'utf8');
+      assert(npmInstallLog.includes('npm install'), 'expected npm install command');
+      const log = fs.readFileSync(shadcnLog, 'utf8');
+      for (const component of [
+        'query-state',
+        'query-state-boundary',
+        'view-card',
+        'metric-kpis',
+        'filter-controls',
+        'server-data-table',
+        'matrix-table',
+      ]) {
+        assert(
+          log.includes(`npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/${component}`),
+          `expected default ${component} registry add command`,
+        );
+      }
+      console.log('✓ default Semaphor registry component install');
+    }
+
     {
       const root = createTempRoot('shadcn-');
       const binDir = path.join(root, 'bin');