Keys

Key name transformation strategy. A run choice in config/settings.yaml — any value produces a correct spec, just with differently formatted keys.

Options

• Default: SAFE
• Values:
  • SAFE - Preserve structure without corrupting special characters
  • CAMEL - camelCase
  • SNAKE - snake_case
  • KEBAB - kebab-case
  • PASCAL - PascalCase
  • TRAIN - Train-Case

Comparison

Input: Background color or background-color

Format	Result
SAFE	Background color (preserved)
CAMEL	backgroundColor
SNAKE	background_color
KEBAB	background-color
PASCAL	BackgroundColor
TRAIN	Background-Color

Path

spec.keys in config/settings.yaml

Example

spec:
  keys: CAMEL  # Transform keys to camelCase

Every value other than SAFE is a lossy projection of the Figma name. Names that cannot be reconstructed from the formatted key are preserved in $extensions.com.figma.name on the definition, so the spec stays reversible into Figma.

See Also

• Figma Keys - The convention your Figma file uses, and the target keys reverse into
• Key Formatting guide - Detailed formatting behavior and edge cases