Ditto Specs are .ditto.md files that live in your codebase alongside your components. Each one declares the text surfaces a component renders — the specific pieces of user-facing copy like a headline, a button label, helper text, a tooltip — and carries the style guide rules that apply to those surfaces, synced from the Ditto platform.
Specs work at every level of your codebase.
- A
workspace.ditto.mdat the repo root sets the floor: universal voice, tone, and brand rules that apply everywhere. - Component-level specs layer on specifics. An agent working on a deeply nested UI component references the right rules for the specific surface it's touching.


