@lightdash/cli 2.153.0 → 2.154.0

package/dist/handlers/apps/appsDownload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appsDownload.d.ts","sourceRoot":"","sources":["../../../src/handlers/apps/appsDownload.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"appsDownload.d.ts","sourceRoot":"","sources":["../../../src/handlers/apps/appsDownload.ts"],"names":[],"mappings":"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"}

package/dist/handlers/apps/appsDownload.js

@@ -274,6 +274,11 @@ const downloadAppsToDir = async (args) => {
             await (0, appCodeFiles_1.writeFilesToDir)(appDir, (0, scaffolding_1.buildStaticAuthoringFiles)({
                 appName: code.manifest.name,
                 sdkVersion: cliVersion,
+                // Downloaded chart types get the viz authoring docs, not
+                // the app SDK skills a viz must not use.
+                flavor: code.manifest.template === common_1.DATA_APP_VIZ_TEMPLATE
+                    ? 'chart-type'
+                    : 'app',
             }));
             // Server-provided deps override the scaffold's
             // template package.json so re-uploads round-trip.

package/dist/handlers/apps/appsDownload.test.js

@@ -507,6 +507,28 @@ describe('downloadAppsToDir', () => {
         });
         expect(fs.existsSync(path.join(appsDir, 'revenue-explorer', 'lightdash-app.yml'))).toBe(true);
     });
+    it('gives downloaded chart types the chart-type authoring flavor', async () => {
+        const appsDir = tmpDir();
+        const vizCode = codeFor('my-chart-type');
+        vizCode.manifest.template = 'data_app_viz';
+        const outcome = await (0, appsDownload_1.downloadAppsToDir)({
+            appRefs: ['my-chart-type'],
+            projectId: 'project-uuid',
+            appsDir,
+            takenFolders: new Set(),
+            cliVersion: '0.0.0-test',
+            fetchApp: async () => vizCode,
+        });
+        expect(outcome.successCount).toBe(1);
+        const skillsDir = path.join(appsDir, 'my-chart-type', '.claude/skills');
+        expect(fs.existsSync(path.join(skillsDir, 'developing-chart-types-locally/SKILL.md'))).toBe(true);
+        // The app SDK skills would only mislead — a viz must not query.
+        expect(fs.existsSync(path.join(skillsDir, 'lightdash-data-app/SKILL.md'))).toBe(false);
+        expect(fs.existsSync(path.join(skillsDir, 'developing-data-apps-locally/SKILL.md'))).toBe(false);
+        expect(fs
+            .readFileSync(path.join(appsDir, 'my-chart-type', 'AGENTS.md'), 'utf8')
+            .toString()).toContain('custom chart type');
+    });
     it('skips bundles the skipBundle guard rejects without writing them', async () => {
         const appsDir = tmpDir();
         const vizCode = codeFor('my-chart-type');

package/dist/handlers/apps/createApp.d.ts

@@ -1,12 +1,14 @@
-import { type DataAppManifest } from '@lightdash/common';
+import { type DataAppManifest, type DataAppVizSchema } from '@lightdash/common';
 export type CreateAppHandlerOptions = {
     assumeYes?: boolean;
+    chartType?: boolean;
     description?: string;
     path?: string;
     project?: string;
     slug?: string;
     verbose: boolean;
 };
+export declare const CHART_TYPE_STARTER_VIZ_SCHEMA: DataAppVizSchema;
 export declare const SHADCN_VERSION = "2.3.0";
 export declare const SHADCN_COMPONENTS: readonly ['button', 'badge', 'card', 'table', 'dialog', 'tabs', 'select', 'input', 'label', 'popover', 'tooltip', 'separator', 'skeleton', 'dropdown-menu', 'sheet', 'scroll-area', 'switch', 'checkbox', 'avatar', 'alert', 'progress', 'resizable'];
 export declare const resolveLocalAppSlug: (name: string, explicitSlug?: string) => string;
@@ -16,6 +18,7 @@ export declare const buildLocalAppManifest: (args: {
     projectUuid: string;
     slug: string;
     now: Date;
+    chartType?: boolean;
 }) => DataAppManifest;
 export declare const createAppHandler: (name: string, options: CreateAppHandlerOptions) => Promise<void>;
 //# sourceMappingURL=createApp.d.ts.map

package/dist/handlers/apps/createApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createApp.d.ts","sourceRoot":"","sources":["../../../src/handlers/apps/createApp.ts"],"names":[],"mappings":"AAAA,OAAO,EAOH,KAAK,eAAe,EACvB,MAAM,mBAAmB,CAAC;AAuB3B,MAAM,MAAM,uBAAuB,GAAG;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC,eAAO,MAAM,iBAAiB,YAC1B,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,OAAO,EACP,OAAO,EACP,SAAS,EACT,SAAS,EACT,WAAW,EACX,UAAU,EACV,eAAe,EACf,OAAO,EACP,aAAa,EACb,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,OAAO,EACP,UAAU,EACV,WAAW,CACL,CAAC;AAEX,eAAO,MAAM,mBAAmB,SACtB,MAAM,iBACG,MAAM,KACtB,MAWF,CAAC;AAEF,eAAO,MAAM,qBAAqB,SAAU;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,IAAI,CAAC;CACb,KAAG,eAUF,CAAC;AAiKH,eAAO,MAAM,gBAAgB,SACnB,MAAM,WACH,uBAAuB,KACjC,OAAO,CAAC,IAAI,CA2Gd,CAAC"}
+{"version":3,"file":"createApp.d.ts","sourceRoot":"","sources":["../../../src/handlers/apps/createApp.ts"],"names":[],"mappings":"AAAA,OAAO,EAQH,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACxB,MAAM,mBAAmB,CAAC;AAwB3B,MAAM,MAAM,uBAAuB,GAAG;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CACpB,CAAC;AAKF,eAAO,MAAM,6BAA6B,EAAE,gBA4B3C,CAAC;AAEF,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC,eAAO,MAAM,iBAAiB,YAC1B,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,OAAO,EACP,OAAO,EACP,SAAS,EACT,SAAS,EACT,WAAW,EACX,UAAU,EACV,eAAe,EACf,OAAO,EACP,aAAa,EACb,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,OAAO,EACP,UAAU,EACV,WAAW,CACL,CAAC;AAEX,eAAO,MAAM,mBAAmB,SACtB,MAAM,iBACG,MAAM,KACtB,MAWF,CAAC;AAEF,eAAO,MAAM,qBAAqB,SAAU;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,IAAI,CAAC;IACV,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB,KAAG,eAaF,CAAC;AAqLH,eAAO,MAAM,gBAAgB,SACnB,MAAM,WACH,uBAAuB,KACjC,OAAO,CAAC,IAAI,CAoId,CAAC"}

package/dist/handlers/apps/createApp.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createAppHandler = exports.buildLocalAppManifest = exports.resolveLocalAppSlug = exports.SHADCN_COMPONENTS = exports.SHADCN_VERSION = void 0;
+exports.createAppHandler = exports.buildLocalAppManifest = exports.resolveLocalAppSlug = exports.SHADCN_COMPONENTS = exports.SHADCN_VERSION = exports.CHART_TYPE_STARTER_VIZ_SCHEMA = void 0;
 const tslib_1 = require("tslib");
 const common_1 = require("@lightdash/common");
 const execa_1 = tslib_1.__importDefault(require("execa"));
@@ -17,6 +17,38 @@ const apiClient_1 = require("../dbt/apiClient");
 const selectProject_1 = require("../selectProject");
 const appCodeFiles_1 = require("./appCodeFiles");
 const scaffolding_1 = require("./scaffolding");
+// Declaration matching the starter component in authoring/chart-type/App.jsx —
+// the two must stay in lockstep (every key the component reads from
+// fieldMapping/options is declared here, and everything declared is read).
+exports.CHART_TYPE_STARTER_VIZ_SCHEMA = {
+    fields: [
+        {
+            name: 'category',
+            label: 'Category',
+            type: 'dimension',
+            required: true,
+        },
+        { name: 'value', label: 'Value', type: 'metric', required: true },
+    ],
+    configOptions: [
+        {
+            type: 'boolean',
+            name: 'showLabels',
+            label: 'Show value labels',
+            group: 'Labels',
+            default: true,
+        },
+        {
+            type: 'number',
+            name: 'maxBars',
+            label: 'Max bars',
+            default: 10,
+            min: 1,
+            max: 50,
+        },
+    ],
+    colorPalette: {},
+};
 exports.SHADCN_VERSION = '2.3.0';
 exports.SHADCN_COMPONENTS = [
     'button',
@@ -60,7 +92,10 @@ const buildLocalAppManifest = (args) => ({
     version: 1,
     name: args.name,
     description: args.description,
-    template: null,
+    template: args.chartType ? common_1.DATA_APP_VIZ_TEMPLATE : null,
+    // vizSchema round-trips through upload — without it the uploaded chart
+    // type never appears in the explorer's chart type picker.
+    ...(args.chartType ? { vizSchema: exports.CHART_TYPE_STARTER_VIZ_SCHEMA } : {}),
     downloadedAt: args.now.toISOString(),
     scaffoldingVersion: env_1.CLI_VERSION,
 });
@@ -98,17 +133,19 @@ const assertNpmAvailable = async () => {
         throw new common_1.ParameterError('npm is required to create a data app because Lightdash generates its shadcn UI locally. Install Node.js (which includes npm), then run this command again.');
     }
 };
-const confirmLocalPackageTooling = async (assumeYes) => {
+const confirmLocalPackageTooling = async (assumeYes, entityLabel, withShadcn) => {
     globalState_1.default.log(styles.warning([
         '⚠ Local package installation',
-        `Creating a data app downloads third-party packages through npm into the new app folder and runs shadcn@${exports.SHADCN_VERSION} to generate UI files.`,
-        'Dependency lifecycle scripts are disabled, but npm and shadcn will access the network and write files on this machine.',
+        `Creating a ${entityLabel} downloads third-party packages through npm into the new folder${withShadcn
+            ? ` and runs shadcn@${exports.SHADCN_VERSION} to generate UI files`
+            : ''}.`,
+        `Dependency lifecycle scripts are disabled, but ${withShadcn ? 'npm and shadcn' : 'npm'} will access the network and write files on this machine.`,
         'Only continue if you trust these package sources and are comfortable running this tooling locally.',
     ].join('\n')));
     if (assumeYes)
         return;
     if (globalState_1.default.isNonInteractive()) {
-        throw new common_1.ParameterError('Creating a data app requires approval to download and install npm packages. Rerun with --assume-yes to approve in non-interactive mode.');
+        throw new common_1.ParameterError(`Creating a ${entityLabel} requires approval to download and install npm packages. Rerun with --assume-yes to approve in non-interactive mode.`);
     }
     const { confirmed } = await inquirer_1.default.prompt([
         {
@@ -122,24 +159,28 @@ const confirmLocalPackageTooling = async (assumeYes) => {
         throw new common_1.ParameterError('Data app creation cancelled.');
     }
 };
-const confirmDependencyInstall = async (directPackages, assumeYes) => {
+const confirmDependencyInstall = async (directPackages, assumeYes, entityLabel, withShadcn) => {
     globalState_1.default.log([
-        'Creating this data app will install these direct npm packages:',
+        `Creating this ${entityLabel} will install these direct npm packages:`,
         ...directPackages.map((packageSpec) => `  - ${packageSpec}`),
-        `\nIt will also run shadcn@${exports.SHADCN_VERSION} to generate:`,
-        `  ${exports.SHADCN_COMPONENTS.join(', ')}`,
+        ...(withShadcn
+            ? [
+                `\nIt will also run shadcn@${exports.SHADCN_VERSION} to generate:`,
+                `  ${exports.SHADCN_COMPONENTS.join(', ')}`,
+            ]
+            : []),
         "\nDependency lifecycle scripts will be disabled. React 19 peer dependencies will use npm's legacy-peer-deps mode.",
     ].join('\n'));
     if (assumeYes)
         return;
     if (globalState_1.default.isNonInteractive()) {
-        throw new common_1.ParameterError('Creating a data app requires approval to install npm packages. Rerun with --assume-yes to approve in non-interactive mode.');
+        throw new common_1.ParameterError(`Creating a ${entityLabel} requires approval to install npm packages. Rerun with --assume-yes to approve in non-interactive mode.`);
     }
     const { confirmed } = await inquirer_1.default.prompt([
         {
             type: 'confirm',
             name: 'confirmed',
-            message: 'Install these packages and create the app?',
+            message: `Install these packages and create the ${entityLabel}?`,
             default: false,
         },
     ]);
@@ -147,7 +188,7 @@ const confirmDependencyInstall = async (directPackages, assumeYes) => {
         throw new common_1.ParameterError('Data app creation cancelled.');
     }
 };
-const installDependenciesAndShadcn = async (appDir) => {
+const installDependenciesAndShadcn = async (appDir, withShadcn) => {
     const npmEnv = {
         ...process.env,
         npm_config_ignore_scripts: 'true',
@@ -167,6 +208,10 @@ const installDependenciesAndShadcn = async (appDir) => {
         stderr: 'inherit',
     };
     await (0, execa_1.default)('npm', ['install', '--include=dev', '--ignore-scripts', '--no-package-lock'], subprocessOptions);
+    // Chart types are single chart components (recharts/d3/SVG) — the shadcn
+    // UI kit would only be dead weight shipped in their published source.
+    if (!withShadcn)
+        return;
     await (0, execa_1.default)('npx', ['--yes', `shadcn@${exports.SHADCN_VERSION}`, 'init', '--defaults', '--force'], shadcnOptions);
     await (0, execa_1.default)('npx', [
         '--yes',
@@ -181,6 +226,8 @@ const createAppHandler = async (name, options) => {
     const startTime = Date.now();
     let success = false;
     globalState_1.default.setVerbose(options.verbose);
+    const isChartType = options.chartType ?? false;
+    const entityLabel = isChartType ? 'custom chart type' : 'data app';
     try {
         const slug = (0, exports.resolveLocalAppSlug)(name, options.slug);
         const appDir = path.join((0, contentAsCodePaths_1.getDownloadFolder)(options.path), 'apps', slug);
@@ -209,18 +256,20 @@ const createAppHandler = async (name, options) => {
             url: `/api/v1/ee/projects/${projectUuid}/apps/authoring-context?slug=${encodeURIComponent(slug)}`,
             body: undefined,
         });
-        await confirmLocalPackageTooling(options.assumeYes ?? false);
+        await confirmLocalPackageTooling(options.assumeYes ?? false, entityLabel, !isChartType);
         const staticFiles = (0, scaffolding_1.buildStaticAuthoringFiles)({
             appName: name,
             sdkVersion: env_1.CLI_VERSION,
+            flavor: isChartType ? 'chart-type' : 'app',
         });
-        await confirmDependencyInstall(parseDirectPackages(staticFiles), options.assumeYes ?? false);
+        await confirmDependencyInstall(parseDirectPackages(staticFiles), options.assumeYes ?? false, entityLabel, !isChartType);
         const manifest = (0, exports.buildLocalAppManifest)({
             name,
             description: options.description ?? '',
             projectUuid,
             slug,
             now: new Date(),
+            chartType: isChartType,
         });
         const appsDir = path.dirname(appDir);
         await fs_1.promises.mkdir(appsDir, { recursive: true });
@@ -230,30 +279,41 @@ const createAppHandler = async (name, options) => {
                 manifest,
                 files: (0, scaffolding_1.loadVendoredStarterSource)(),
             });
+            if (isChartType) {
+                // Swap the app placeholder for the viz starter matching the
+                // manifest's CHART_TYPE_STARTER_VIZ_SCHEMA declaration.
+                await (0, appCodeFiles_1.writeFilesToDir)(temporaryAppDir, [
+                    (0, scaffolding_1.loadChartTypeStarterApp)(),
+                ]);
+            }
             await (0, appCodeFiles_1.writeFilesToDir)(temporaryAppDir, staticFiles);
             await (0, appCodeFiles_1.writeContextToDir)(temporaryAppDir, context);
-            await installDependenciesAndShadcn(temporaryAppDir);
+            await installDependenciesAndShadcn(temporaryAppDir, !isChartType);
             // shadcn rewrites package versions and tailwind colors while it
             // generates source. Restore the reviewed template declarations so
             // the approval list stays exact and uploads do not mistake the
             // generated app for one with custom dependencies.
-            await (0, appCodeFiles_1.writeFilesToDir)(temporaryAppDir, staticFiles.filter((file) => file.path === 'package.json' ||
-                file.path === 'tailwind.config.js'));
+            if (!isChartType) {
+                await (0, appCodeFiles_1.writeFilesToDir)(temporaryAppDir, staticFiles.filter((file) => file.path === 'package.json' ||
+                    file.path === 'tailwind.config.js'));
+            }
             await fs_1.promises.rename(temporaryAppDir, appDir);
         }
         catch (error) {
             await fs_1.promises.rm(temporaryAppDir, { recursive: true, force: true });
             throw error;
         }
-        globalState_1.default.log(styles.success(`Created data app "${name}" at ${appDir}`));
-        globalState_1.default.log(`\nNext:\n  cd ${JSON.stringify(appDir)}\n  npm run build\n  lightdash upload --apps ${slug}`);
+        globalState_1.default.log(styles.success(`Created ${entityLabel} "${name}" at ${appDir}`));
+        globalState_1.default.log(isChartType
+            ? `\nNext:\n  cd ${JSON.stringify(appDir)}\n  lightdash apps validate --build\n  lightdash upload --chart-types ${slug}\n\nThen open any explore in Lightdash and pick "${name}" in the chart type picker.`
+            : `\nNext:\n  cd ${JSON.stringify(appDir)}\n  npm run build\n  lightdash upload --apps ${slug}`);
         success = true;
     }
     finally {
         await analytics_1.LightdashAnalytics.track({
             event: 'command.executed',
             properties: {
-                command: 'create-app',
+                command: isChartType ? 'create-chart-type' : 'create-app',
                 durationMs: Date.now() - startTime,
                 success,
             },

package/dist/handlers/apps/createApp.test.js

@@ -56,6 +56,18 @@ describe('resolveLocalAppSlug', () => {
     });
 });
 describe('buildLocalAppManifest', () => {
+    it('marks chart types as data_app_viz with the starter vizSchema', () => {
+        const manifest = (0, createApp_1.buildLocalAppManifest)({
+            name: 'Radial Gauge',
+            description: '',
+            projectUuid: PROJECT_UUID,
+            slug: 'radial-gauge',
+            now: new Date('2026-01-01T00:00:00.000Z'),
+            chartType: true,
+        });
+        expect(manifest.template).toBe('data_app_viz');
+        expect(manifest.vizSchema).toEqual(createApp_1.CHART_TYPE_STARTER_VIZ_SCHEMA);
+    });
     it('builds a slug-identified manifest without an app uuid', () => {
         const manifest = (0, createApp_1.buildLocalAppManifest)({
             name: 'Revenue Explorer',
@@ -160,7 +172,7 @@ describe('createAppHandler', () => {
             expect.objectContaining({
                 type: 'confirm',
                 name: 'confirmed',
-                message: 'Install these packages and create the app?',
+                message: 'Install these packages and create the data app?',
                 default: false,
             }),
         ]);
@@ -183,6 +195,39 @@ describe('createAppHandler', () => {
             input: '\u001B[B\n',
         }));
     });
+    it('creates a custom chart type scaffold with the viz starter and no shadcn', async () => {
+        const root = await fs_1.promises.mkdtemp(path.join(os.tmpdir(), 'ld-create-app-'));
+        await (0, createApp_1.createAppHandler)('Radial Gauge', {
+            description: 'A gauge with a needle',
+            path: root,
+            chartType: true,
+            verbose: false,
+        });
+        const appDir = path.join(root, 'apps', 'radial-gauge');
+        const bundle = await (0, appCodeFiles_1.readBundleFromDir)(appDir);
+        expect(bundle.manifest.template).toBe('data_app_viz');
+        expect(bundle.manifest.vizSchema).toEqual(createApp_1.CHART_TYPE_STARTER_VIZ_SCHEMA);
+        const appSource = await fs_1.promises.readFile(path.join(appDir, 'src/App.jsx'), 'utf8');
+        expect(appSource).toContain('useVizContext');
+        // No shadcn generation: chart types ship no UI-kit source.
+        expect(execaMock).not.toHaveBeenCalledWith('npx', expect.anything(), expect.anything());
+        // The viz contract + local workflow skills ship; the app-only skills
+        // do not.
+        await expect(fs_1.promises.access(path.join(appDir, '.claude/skills/reusable-visualization/SKILL.md'))).resolves.toBeUndefined();
+        await expect(fs_1.promises.access(path.join(appDir, '.claude/skills/developing-chart-types-locally/SKILL.md'))).resolves.toBeUndefined();
+        await expect(fs_1.promises.access(path.join(appDir, '.claude/skills/lightdash-data-app/SKILL.md'))).rejects.toThrow();
+        await expect(fs_1.promises.access(path.join(appDir, '.claude/skills/developing-data-apps-locally/SKILL.md'))).rejects.toThrow();
+        expect(await fs_1.promises.readFile(path.join(appDir, 'AGENTS.md'), 'utf8')).toContain('custom chart type');
+        expect(await fs_1.promises.readFile(path.join(appDir, 'README.md'), 'utf8')).toContain('Radial Gauge');
+        expect(globalState_1.default.log).toHaveBeenCalledWith(expect.stringContaining('upload --chart-types radial-gauge'));
+        expect(analytics_1.LightdashAnalytics.track).toHaveBeenCalledWith({
+            event: 'command.executed',
+            properties: expect.objectContaining({
+                command: 'create-chart-type',
+                success: true,
+            }),
+        });
+    });
     it('requires npm before requesting app context', async () => {
         const root = await fs_1.promises.mkdtemp(path.join(os.tmpdir(), 'ld-create-app-'));
         execaMock.mockRejectedValueOnce(new Error('npm not found'));

package/dist/handlers/apps/scaffolding.d.ts

@@ -16,11 +16,21 @@ export declare const rewriteWorkspaceDeps: (packageJson: string, version: string
 export declare const loadTemplateDependencies: (sdkVersion: string) => Record<string, string>;
 export declare const loadVendoredBuildScaffold: (sdkVersion: string) => DataAppCodeFile[];
 export declare const loadVendoredStarterSource: () => DataAppCodeFile[];
+/**
+ * The chart-type starter component: replaces the template's src/App.jsx when
+ * scaffolding a custom chart type (data_app_viz). The rest of the starter
+ * source (main.jsx already mounts VizContextProvider, lib/, css) is shared
+ * with data apps.
+ */
+export declare const loadChartTypeStarterApp: () => DataAppCodeFile;
+/** Which scaffold is being assembled: a data app or a custom chart type. */
+export type AuthoringFlavor = 'app' | 'chart-type';
 /**
  * Assembles static authoring files (configs, skills, templates) to deploy alongside a data app.
  */
 export declare const buildStaticAuthoringFiles: (args: {
     appName: string;
     sdkVersion: string;
+    flavor?: AuthoringFlavor;
 }) => DataAppCodeFile[];
 //# sourceMappingURL=scaffolding.d.ts.map

package/dist/handlers/apps/scaffolding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffolding.d.ts","sourceRoot":"","sources":["../../../src/handlers/apps/scaffolding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMzD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAKpE;AA6DD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,gBAChB,MAAM,WACV,MAAM,KAChB,MAAmE,CAAC;AAEvE;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,eACrB,MAAM,KACnB,MAAM,CAAC,MAAM,EAAE,MAAM,CAevB,CAAC;AAWF,eAAO,MAAM,yBAAyB,eACtB,MAAM,KACnB,eAAe,EAeb,CAAC;AAEN,eAAO,MAAM,yBAAyB,QAAO,eAAe,EAG3D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,SAAU;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACtB,KAAG,eAAe,EAuDlB,CAAC"}
+{"version":3,"file":"scaffolding.d.ts","sourceRoot":"","sources":["../../../src/handlers/apps/scaffolding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMzD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAKpE;AA6DD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,gBAChB,MAAM,WACV,MAAM,KAChB,MAAmE,CAAC;AAEvE;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,eACrB,MAAM,KACnB,MAAM,CAAC,MAAM,EAAE,MAAM,CAevB,CAAC;AAWF,eAAO,MAAM,yBAAyB,eACtB,MAAM,KACnB,eAAe,EAeb,CAAC;AAEN,eAAO,MAAM,yBAAyB,QAAO,eAAe,EAG3D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,QAAO,eAQ1C,CAAC;AAEF,4EAA4E;AAC5E,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,YAAY,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,yBAAyB,SAAU;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,eAAe,CAAC;CAC5B,KAAG,eAAe,EAkFlB,CAAC"}

package/dist/handlers/apps/scaffolding.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildStaticAuthoringFiles = exports.loadVendoredStarterSource = exports.loadVendoredBuildScaffold = exports.loadTemplateDependencies = exports.rewriteWorkspaceDeps = void 0;
+exports.buildStaticAuthoringFiles = exports.loadChartTypeStarterApp = exports.loadVendoredStarterSource = exports.loadVendoredBuildScaffold = exports.loadTemplateDependencies = exports.rewriteWorkspaceDeps = void 0;
 exports.firstExistingDir = firstExistingDir;
 const tslib_1 = require("tslib");
 const fs_1 = require("fs");
@@ -100,35 +100,65 @@ const loadVendoredStarterSource = () => {
     return walkDir(path.join(templateDir, 'src'), templateDir, new Set());
 };
 exports.loadVendoredStarterSource = loadVendoredStarterSource;
+/**
+ * The chart-type starter component: replaces the template's src/App.jsx when
+ * scaffolding a custom chart type (data_app_viz). The rest of the starter
+ * source (main.jsx already mounts VizContextProvider, lib/, css) is shared
+ * with data apps.
+ */
+const loadChartTypeStarterApp = () => {
+    const { authoringDir } = resolveVendorDirs();
+    return {
+        path: 'src/App.jsx',
+        contentBase64: (0, fs_1.readFileSync)(path.join(authoringDir, 'chart-type', 'App.jsx')).toString('base64'),
+    };
+};
+exports.loadChartTypeStarterApp = loadChartTypeStarterApp;
 /**
  * Assembles static authoring files (configs, skills, templates) to deploy alongside a data app.
  */
 const buildStaticAuthoringFiles = (args) => {
-    const { appName, sdkVersion } = args;
+    const { appName, sdkVersion, flavor = 'app' } = args;
     const { templateDir, authoringDir } = resolveVendorDirs();
+    const isChartType = flavor === 'chart-type';
     const files = [];
     // 1. Template scaffold files (src/, scripts/, skill.md excluded)
     for (const file of (0, exports.loadVendoredBuildScaffold)(sdkVersion)) {
         files.push(file);
     }
-    // 2. skill.md → .claude/skills/lightdash-data-app/SKILL.md
-    files.push({
-        path: '.claude/skills/lightdash-data-app/SKILL.md',
-        contentBase64: (0, fs_1.readFileSync)(path.join(templateDir, 'skill.md')).toString('base64'),
-    });
-    // 3. authoring/developing-data-apps-locally/SKILL.md
-    //    → .claude/skills/developing-data-apps-locally/SKILL.md
-    files.push({
-        path: '.claude/skills/developing-data-apps-locally/SKILL.md',
-        contentBase64: (0, fs_1.readFileSync)(path.join(authoringDir, 'developing-data-apps-locally', 'SKILL.md')).toString('base64'),
-    });
+    // 2+3. Flavor-specific skills. A chart type must not query through the
+    // SDK, so the app-building skills would only mislead — it gets the local
+    // chart-type workflow skill instead, with the viz contract shipping via
+    // the template's .claude/skills/reusable-visualization (step 1).
+    if (isChartType) {
+        files.push({
+            path: '.claude/skills/developing-chart-types-locally/SKILL.md',
+            contentBase64: (0, fs_1.readFileSync)(path.join(authoringDir, 'developing-chart-types-locally', 'SKILL.md')).toString('base64'),
+        });
+    }
+    if (!isChartType) {
+        // skill.md → .claude/skills/lightdash-data-app/SKILL.md
+        files.push({
+            path: '.claude/skills/lightdash-data-app/SKILL.md',
+            contentBase64: (0, fs_1.readFileSync)(path.join(templateDir, 'skill.md')).toString('base64'),
+        });
+        // authoring/developing-data-apps-locally/SKILL.md
+        //    → .claude/skills/developing-data-apps-locally/SKILL.md
+        files.push({
+            path: '.claude/skills/developing-data-apps-locally/SKILL.md',
+            contentBase64: (0, fs_1.readFileSync)(path.join(authoringDir, 'developing-data-apps-locally', 'SKILL.md')).toString('base64'),
+        });
+    }
+    const flavorDir = isChartType
+        ? path.join(authoringDir, 'chart-type')
+        : authoringDir;
     // 4. AGENTS.md.tmpl → AGENTS.md
     files.push({
         path: 'AGENTS.md',
-        contentBase64: (0, fs_1.readFileSync)(path.join(authoringDir, 'AGENTS.md.tmpl')).toString('base64'),
+        contentBase64: (0, fs_1.readFileSync)(path.join(flavorDir, 'AGENTS.md.tmpl')).toString('base64'),
     });
     // 5. README.md.tmpl → README.md  (substitute {{APP_NAME}})
-    const readme = (0, fs_1.readFileSync)(path.join(authoringDir, 'README.md.tmpl'), 'utf-8').replace(/\{\{APP_NAME\}\}/g, appName);
+    const readme = (0, fs_1.readFileSync)(path.join(flavorDir, 'README.md.tmpl'), 'utf-8').replace(/\{\{APP_NAME\}\}/g, appName);
     files.push({
         path: 'README.md',
         contentBase64: Buffer.from(readme).toString('base64'),

package/dist/index.js

@@ -445,14 +445,15 @@ const appsProgram = commander_1.program
     .description('Work with data apps (enterprise)');
 appsProgram
     .command('create <name>')
-    .description('Creates a new data app locally')
+    .description('Creates a new data app or custom chart type locally')
+    .option('--chart-type', 'Create a custom chart type (a reusable visualization the explorer chart type picker offers) instead of a data app', false)
     .option('--description <text>', 'Set the app description', '')
     .option('--slug <slug>', 'Override the app slug')
     .option('-p, --path <path>', 'Specify the Lightdash content root (default: ./lightdash)')
     .option('--project <project uuid>', 'Specify the project the app will use', parseProjectArgument, undefined)
     .option('-y, --assume-yes', 'approve npm package installation', false)
     .option('--verbose', undefined, false)
-    .addHelpText('after', `\n${styles.bold('Example:')}\n  ${styles.title('⚡')}️lightdash ${styles.bold('apps create "Revenue explorer"')} ${styles.secondary('-- creates ./lightdash/apps/revenue-explorer')}\n`)
+    .addHelpText('after', `\n${styles.bold('Examples:')}\n  ${styles.title('⚡')}️lightdash ${styles.bold('apps create "Revenue explorer"')} ${styles.secondary('-- creates ./lightdash/apps/revenue-explorer')}\n  ${styles.title('⚡')}️lightdash ${styles.bold('apps create "Radial gauge" --chart-type')} ${styles.secondary('-- creates a custom chart type at ./lightdash/apps/radial-gauge')}\n`)
     .action(createApp_1.createAppHandler);
 appsProgram
     .command('preview [path]')

package/dist/vendor/authoring/chart-type/AGENTS.md.tmpl

@@ -0,0 +1,24 @@
+# Working on this Lightdash custom chart type
+
+This folder is a **custom chart type** (a reusable visualization, the `data_app_viz` template) — ONE chart component that receives its data and settings from Lightdash, not a data app. It runs no query, owns no explore, and must not fetch anything itself.
+
+Two skills in `.claude/skills/` describe how to edit it:
+- `reusable-visualization` — the contract: the `useVizContext()` hook, the field/option declaration, resolved series colours, pivoted results.
+- `developing-chart-types-locally` — the local workflow: the vizSchema lockstep rule, validate/upload/verify loop, and the path to the official registry.
+
+The one difference from that skill here: the declaration is not emitted as structured output. It lives in this folder's `lightdash-app.yml` under `vizSchema`, and **must stay in lockstep with the component** — every key `src/App.jsx` reads from `fieldMapping` or `options` is declared there, and everything declared there is read. When you change what the component reads, update `vizSchema` in the same edit.
+
+Edit only `src/`. Root config files are read-only reference — the server rebuilds against a trusted template.
+
+## The loop
+
+1. Edit `src/` (and `vizSchema` in `lightdash-app.yml` when the declaration changes).
+2. `lightdash apps validate --build` — Cloud-parity Vite build; a failure is a validation error with the Vite output.
+3. `lightdash upload --chart-types <slug>` — the server rebuilds; the chart type then appears in the explorer's chart type picker for that project.
+4. Verify in Lightdash: open any explore, run a query, pick this chart type, and map its fields.
+
+There is no local preview for a chart type: `useVizContext()` waits for the Lightdash host, so the component renders nothing standalone (`lightdash apps preview` and `npm run dev` show a blank page). Upload and verify in the explorer instead.
+
+Build with the template's preinstalled dependency set (see `package.json` — React, Recharts, d3, and more). Do not add npm packages or vendor library source into `src/`; chart types published to the official registry must stay template-deps-only.
+
+`.npmrc` sets `ignore-scripts=true` — never remove it or run installs with scripts enabled.

package/dist/vendor/authoring/chart-type/App.jsx

@@ -0,0 +1,95 @@
+import {
+    getFormatted,
+    getRaw,
+    resolveValueColor,
+    useVizContext,
+} from '@lightdash/query-sdk';
+import {
+    Bar,
+    BarChart,
+    Cell,
+    LabelList,
+    ResponsiveContainer,
+    Tooltip,
+    XAxis,
+    YAxis,
+} from 'recharts';
+
+// Starter custom chart type: a bar chart wired to the host the way every viz
+// must be. It runs no query — Lightdash runs the query and pushes rows plus a
+// mapping from the field names declared in lightdash-app.yml's vizSchema to
+// the query's columns. Everything read here (`category`/`value` fields,
+// `showLabels`/`maxBars` options) is declared there; keep the two in lockstep
+// (see .claude/skills/reusable-visualization).
+function App() {
+    const context = useVizContext();
+    const { fieldMapping, rows, options, ready } = context;
+    if (!ready) {
+        return <div style={{ height: '100vh' }} />;
+    }
+
+    const catField = fieldMapping.category;
+    const valField = fieldMapping.value;
+    if (!catField || !valField) {
+        return (
+            <div
+                style={{
+                    height: '100vh',
+                    display: 'flex',
+                    alignItems: 'center',
+                    justifyContent: 'center',
+                }}
+            >
+                Map the Category and Value fields to see the chart.
+            </div>
+        );
+    }
+
+    const { showLabels, maxBars } = options;
+    const fallbackColors = ['#7162FF', '#1A1B1E'];
+    const data = rows.slice(0, maxBars).map((row) => ({
+        label: getFormatted(row, catField),
+        category: getRaw(row, catField),
+        value: Number(getRaw(row, valField) ?? 0),
+    }));
+
+    return (
+        // The root fills the viewport, so ResponsiveContainer has a height to
+        // measure.
+        <div style={{ height: '100vh' }}>
+            <ResponsiveContainer width="100%" height="100%">
+                <BarChart data={data}>
+                    <XAxis
+                        dataKey="label"
+                        tickFormatter={(v) =>
+                            v.length > 12 ? `${v.slice(0, 11)}…` : v
+                        }
+                    />
+                    <YAxis tickFormatter={(v) => v.toLocaleString()} />
+                    <Tooltip />
+                    <Bar dataKey="value">
+                        {data.map((d, i) => (
+                            <Cell
+                                key={`${d.label}-${i}`}
+                                fill={
+                                    resolveValueColor(
+                                        context,
+                                        catField,
+                                        d.category,
+                                        i,
+                                    ) ??
+                                    fallbackColors[i % fallbackColors.length]
+                                }
+                            />
+                        ))}
+                        {showLabels && (
+                            <LabelList dataKey="value" position="top" />
+                        )}
+                    </Bar>
+                </BarChart>
+            </ResponsiveContainer>
+        </div>
+    );
+}
+
+export default App;