The design options concept is the most powerful feature in Captivate 12 and the key to building custom layouts. However, documentation is very limited. It is often unclear which JSON properties are actually supported for each widget, and many entries defined in the JSON are not transformed by Captivate.

Suggested improvement:
- Provide an example.json file for every widget, showing all possible properties (“grammar”) of the design options.
- Especially for more complex widgets (accordion, tabs, carousel, etc.), this would help developers understand what can be customized.
- Include notes for properties that are not yet transformed but are planned for future updates.

Benefit:
- Makes it easier to design professional, custom layouts without guesswork.
- Reduces trial-and-error when working with JSON.
- Ensures users can fully leverage the flexibility of design options.