Skip to main content

Overview

This guide covers best practices for displaying AI-generated commentary on your platform, ensuring a great user experience while meeting licensing requirements.

Required Attribution

All displayed commentaries must include Unleeshed attribution:
Attribution example

Display Patterns

Single Persona Commentary

For displaying one persona’s take:

Multiple Personas (Debate Style)

Show different perspectives side-by-side:

Tabbed Navigation

Let users switch between personas:

Audio Player

For commentaries with audio:

Styling Guidelines

Typography

  • Use readable font sizes (16px+ for body text)
  • Maintain good contrast (4.5:1 minimum)
  • Quote styling for commentary content

Persona Avatars

  • Minimum size: 48x48px
  • Use border-radius for circular avatars
  • Include alt text for accessibility

Responsive Design

Loading States

Show meaningful loading states during generation:

Accessibility

  • Use semantic HTML (article, header, blockquote)
  • Include alt text for all images
  • Announce dynamic content changes
  • All interactive elements focusable
  • Logical tab order
  • Visible focus indicators
  • Provide text transcript (commentary text)
  • Keyboard-accessible controls
  • Visual playback indicators

Next Steps

Error Handling

Handle failures gracefully.

Rate Limits

Understand API limits.