generate

opentp generate

Exports your tracking plan to various output formats.

Usage

opentp generate <target> [options]

Targets

Target	Description	Output
json	JSON export	opentp.events.json
yaml	YAML export	opentp.events.yaml
template	Custom template	Configured output

Options

Option	Description
--root <path>	Project root directory
--output <path>	Output file path
--external-generators <path>	Load custom generators

Examples

Export to JSON

opentp generate json

Creates opentp.events.json with all events.

Export to YAML

opentp generate yaml

Creates opentp.events.yaml with all events.

Custom output path

opentp generate json --output ./dist/events.json

Using custom generators

opentp generate my-format --external-generators ./my-generators

Output Format

JSON Output

{
  "version": "2025-06",
  "generated": "2025-01-10T12:00:00Z",
  "events": [
    {
      "key": "auth::login_click",
      "taxonomy": {
        "area": "auth",
        "event": "login_click",
        "action": "User clicks the login button"
      },
      "payload": {
        "platforms": {
          "all": {
            "active": "1.0.0",
            "schema": {
              "event_name": { "value": "login_click" }
            }
          }
        }
      }
    }
  ]
}

YAML Output

version: 2025-06
generated: 2025-01-10T12:00:00Z
events:
  - key: auth::login_click
    taxonomy:
      area: auth
      event: login_click
      action: User clicks the login button
    payload:
      platforms:
        all:
          active: 1.0.0
          schema:
            event_name:
              value: login_click

Custom Generators

Create custom generators for any output format:

my-generators/typescript/index.js

module.exports = {
  name: 'typescript',
  generate: async (events, config) => {
    // Generate TypeScript SDK
    return {
      files: [
        { path: 'events.ts', content: '...' }
      ]
    };
  }
};

See Custom Generators for details.