@bluecadet/create-launchpad

Scaffolding CLI for Launchpad projects.

Usage

Use Node.js 24.x or 26 and newer (^24 || >=26). Generated package.json files declare this requirement. When updating an existing project, the scaffolder adds it if missing and preserves any explicit Node engine declaration; make sure your project's range matches the supported runtime.

npm create @bluecadet/launchpad

The tool will interactively ask which plugins, sources, and transforms you need, then generate or update a config with explicit workflow orchestration. Observability is opt-in and is not selected by default:

• launchpad.config.ts
• package.json (created or merged)
• tsconfig.json (created or validated)
• .gitignore (optional)

After running, install the added dependencies:

npm install

If you scaffold the monitor plugin, the generated config includes both workflows.start and workflows.stop so PM2 apps connect, start, stop, and disconnect in the expected order.

If you select observability, the generated plugin remains disabled until LAUNCHPAD_OBSERVABILITY_ENDPOINT is present. LAUNCHPAD_OBSERVABILITY_TOKEN is optional: missing, empty, or whitespace-only values send requests without authentication. Nonblank tokens are passed through unchanged. No client, project, installation, environment, organization, or other resource field is required.

The scaffolder does not generate an endpoint, token, or other credential. Enabling the plugin sends Launchpad logs and metrics only to the OTLP endpoint you configure. To identify the generated service, uncomment and edit the optional resource example in launchpad.config.ts:

resource: { 'service.name': 'my-launchpad-service' },

You can add other flat primitive resource attributes when your deployment policy requires them.

Once the endpoint is set, logs use the controller's retained canonical JSONL and per-destination checkpoints by default. The generated block includes a commented logStorage: { type: 'memory' } opt-out for ephemeral delivery. New destinations backfill from the oldest retained record, which can increase ingestion costs or encounter backend timestamp limits; see the delivery reference. The plugin is still omitted unless LAUNCHPAD_OBSERVABILITY_ENDPOINT is set.

Docs

See Creating a Project for full documentation.

License

Bluecadet-authored code in this package is licensed under ISC. Third-party dependencies retain their own licenses.