Skip to main content
Design System gives you complete control over the visual branding and behavior of widgets built in Widget Studio. Instead of manually styling each widget you create, Design System lets you establish brand-consistent colors, typography, and generation rules once—then automatically apply them across all your widgets. This ensures every widget you build feels native to your product, maintains visual consistency, and follows your preferred interaction patterns without requiring repetitive configuration or design work.

Key Features

Design System includes two powerful components that work together:

Key Features

Design System includes two powerful components that work together:

Design System

Visual BrandingControl colors, typography, and appearance across all widgets using Material 3 design principles.
  • Auto-generated color palettes
  • Light and dark mode support
  • Typography customization
  • Real-time preview

Widget Guidelines

Generation RulesDefine how widgets are structured and behave when the AI generates them.
  • Data visualization patterns
  • Interaction flows
  • Content structure rules
  • Accessibility standards

Design System: Visual Branding

What You Can Customize

  • Primary color (automatically generates complementary palette using Material 3)
  • Individual color overrides for any generated color
  • Light mode and dark mode variants
  • Real-time preview of how colors appear across components
  • Font families
  • Font weights
  • Text sizes and hierarchies
  • See how your design system affects existing widgets
  • Preview components in light mode and dark mode
  • Test design changes before publishing

How It Works

1

Select your primary brand color

Material 3 automatically generates a complete color palette from your primary color
2

Customize individual colors

Override any generated color to match your exact brand guidelines
3

Set typography

Define font families, weights, and sizes
4

Preview changes

See how your design system looks across different widgets and in both light and dark modes
5

Publish

Make your design system available for use in Widget Studio
Once published, your design system becomes available as a selection option when building new widgets in Widget Studio.

Applying Design System to Widgets

When you create a new widget in Widget Studio, you can select which design system to apply. The widget editor automatically uses your selected design system’s colors and typography, so widgets match your brand from the moment they’re generated. You can:
  • Apply one design system across all widgets for consistency
  • Create multiple design systems for different customer tenants
  • Switch between design systems to see how widgets look with different branding

Widget Guidelines: Generation Rules

What Widget Guidelines Control

Widget Guidelines define the rules and patterns that guide widget generation. Think of them as instructions for the AI about how your widgets should behave and what they should include. Guidelines can cover:
  • Data visualization approaches (charts, tables, cards)
  • Progressive disclosure patterns
  • User interaction flows
  • Content structure and organization
  • Accessibility requirements
  • Specific component preferences

Why Widget Guidelines Matter

Without guidelines, every widget generation starts from scratch. The AI might visualize data differently each time, use inconsistent interaction patterns, or structure content in ways that don’t match your product’s conventions. With Widget Guidelines, you define your preferences once—like “always use progressive visualization for complex data” or “prioritize accessibility in all interactions”—and every widget respects those rules automatically.

How Widget Guidelines Work

Widget Guidelines function as system prompts that guide the AI agent responsible for widget generation. When you generate a new widget, the AI automatically follows your established guidelines to ensure consistency.
Example guideline: “Use progressive visualization - start with summary views and let users drill down into details”When applied, every widget the AI generates will follow this pattern, creating a consistent user experience across your entire widget library.

Creating Widget Guidelines

1

Access Widget Guidelines

Navigate to Widget Guidelines in your Agent Management Studio
2

Define your rules

Write clear instructions about how widgets should be structured and how they should behave
3

Add specific requirements

Include any accessibility needs, data visualization preferences, or interaction patterns
4

Save and apply

Make guidelines available for selection in Widget Studio

Applying Widget Guidelines

Like Design Systems, Widget Guidelines are selected when building widgets in Widget Studio. You can:
  • Apply one set of guidelines across all widgets
  • Create different guidelines for different customer segments
  • Combine different design systems with different widget guidelines as needed
Widget Guidelines are applied at the agent level within Widget Studio, not globally across all agents.

Design System + Widget Guidelines: Better Together

While each component works independently, they’re most powerful when used together:
  • Design System ensures visual consistency (colors, fonts, appearance)
  • Widget Guidelines ensure behavioral consistency (structure, interactions, patterns)
Together, they let you define once and apply everywhere—saving time while ensuring every widget feels like a natural part of your product.

Use Cases

Create one design system and one set of widget guidelines. Every widget you build automatically follows your brand standards and preferred patterns.

Getting Started

Prerequisites

Widget Studio access (available to all SDK 3.0 customers)
Agent Management Studio access

Next Steps

Ready to create your first design system? Check out the Widget Studio documentation to learn how to build widgets that use your design system.