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:
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-radiusfor circular avatars - Include alt text for accessibility
Responsive Design
Loading States
Show meaningful loading states during generation:Accessibility
Screen readers
Screen readers
- Use semantic HTML (
article,header,blockquote) - Include
alttext for all images - Announce dynamic content changes
Keyboard navigation
Keyboard navigation
Audio content
Audio content
- Provide text transcript (commentary text)
- Keyboard-accessible controls
- Visual playback indicators