Basic Theme Lexicon

import { Table } from '@/app/components/docs'

Theme Lexicon

The site.standard.theme.basic lexicon provides a simplified theme definition for publications, enabling basic color customization for content display across different platforms and applications.

Overview

This lexicon ensures publications maintain their visual identity across different reading applications and platforms by defining core colors for content display.

Schema

Required Properties

Color Format

Colors are defined using the site.standard.theme.color#rgb type from the site.standard.theme.color lexicon.

RGB Color Type

Each color is an object with three required integer properties:

RGBA Color Type

The site.standard.theme.color lexicon also defines an rgba type for colors with transparency:

Color Roles

• background: Main surface color for content areas
• foreground: Default color for body text and content
• accent: Color for interactive elements like links and button backgrounds
• accentForeground: Text color used on accent-colored backgrounds (ex: button text)

Usage in Publications

Include the basic theme in your publication record:

Best Practices

1. Consider readability: Ensure foreground/background combinations are legible
2. Test button colors: Verify accent/accentForeground pairs have sufficient contrast
3. Provide all required properties: All four color properties are required for a valid theme

Related

• Publication lexicon - Publications can include basicTheme
• Quick Start - Implementation guide
• Implementations - See how platforms use theming