Tools

Tools are the action buttons in the editor — how users start an ad, find assets, generate variations, and polish a script. Each is a standalone feature you switch on or off, so the surface matches your use case: everything for a full creative tool, a single button for a one-shot generator.

The tools

Each links to its own page — what it does, when to use it, how to enable it, and what it returns.

How to configure

Every tool lives under tools.options, keyed by name. Set a key to true to enable it with defaults, or to an object to customise its button title and description.

tools: {
  position: 'top',
  options: {
    byLandingPage:  { title: 'Webpage',  description: 'Generate an audio ad from a landing-page URL' },
    byProductPitch: { title: 'Product Brief', description: 'Generate an audio ad from a product name + description' },
    variations: true,   // alternative scripts
    enhance: true,      // Script Enrichment
  },
}

The button order follows the order you list the tools in.

Tools that appear automatically

Two tools you don't list — they surface based on context:

• Recommend is added whenever at least one tool is enabled. It finds voices and music for the current script — see Recommend.
• Criteria appears on its own when you turn on Vocal → Dynamic content or Music → Dynamic; it's where users configure per-audience personalization. Opt out with tools.options.criteria: false.

Icon defaults

Visual tuning for every tool button's icon — use it to make the toolbar feel native to your brand. Leave the fields unset to keep the defaults; per-tool icon settings always win over these.

• Show icons — render an icon next to each tool button. With icons off, the size, weight, and colour below have no effect.
• Icon size — tools.defaults.icon.size. Numbers are pixels (22) or any CSS length (1.4rem). Default 22.
• Icon weight — tools.defaults.icon.weight. How bold the icons appear (Material Symbols 100–700, and Font Awesome). Default 300.
• Icon color — tools.defaults.icon.color. Any CSS colour — usually your brand colour. Default #595959. (Raster image icons can't be recoloured.)

tools: {
  defaults: {
    icon: { size: 22, weight: 300, color: '#595959' },
  },
  options: { /* … */ },
}

Position

Tools render at the top of the editor (tools.position: 'top') — the only placement available for now. An Import tool (bring in an existing audio file as a starting point) is planned but not yet configurable.