{
  "$type": "site.standard.document",
  "canonicalUrl": "https://standard.site/docs/lexicons/theme",
  "coverImage": {
    "$type": "blob",
    "ref": {
      "$link": "bafkreie4uur76o7r6hf5zv2gsev4torqb3vwuxp25m6f7empcn4jdogkfa"
    },
    "mimeType": "image/png",
    "size": 111344
  },
  "description": "Schema reference for the basic theme, provides a simplified theme definition for publications.",
  "path": "/docs/lexicons/theme",
  "publishedAt": "2026-02-10T00:00:00.000Z",
  "site": "at://did:plc:re3ebnp5v7ffagz6rb6xfei4/site.standard.publication/3me5vykp6lf2y",
  "textContent": "import { Table } from '@/app/components/docs'\n\nTheme Lexicon\n\nThe site.standard.theme.basic lexicon provides a simplified theme definition for publications, enabling basic color customization for content display across different platforms and applications.\n\nOverview\n\nThis lexicon ensures publications maintain their visual identity across different reading applications and platforms by defining core colors for content display.\n\nSchema\n\nRequired Properties\n\n<Table\n    headers={['Property', 'Type', 'Description']}\n    rows={[\n        ['background', 'ref', 'Color used for content background (ref → site.standard.theme.color#rgb)'],\n        ['foreground', 'ref', 'Color used for content text (ref → site.standard.theme.color#rgb)'],\n        ['accent', 'ref', 'Color used for links and button backgrounds (ref → site.standard.theme.color#rgb)'],\n        ['accentForeground', 'ref', 'Color used for button text (ref → site.standard.theme.color#rgb)'],\n    ]}\n/>\n\nColor Format\n\nColors are defined using the site.standard.theme.color#rgb type from the site.standard.theme.color lexicon.\n\nRGB Color Type\n\nEach color is an object with three required integer properties:\n\n<Table\n    headers={['Property', 'Type', 'Range', 'Description']}\n    rows={[\n        ['r', 'integer', '0-255', 'Red channel value'],\n        ['g', 'integer', '0-255', 'Green channel value'],\n        ['b', 'integer', '0-255', 'Blue channel value'],\n    ]}\n/>\n\nRGBA Color Type\n\nThe site.standard.theme.color lexicon also defines an rgba type for colors with transparency:\n\n<Table\n    headers={['Property', 'Type', 'Range', 'Description']}\n    rows={[\n        ['r', 'integer', '0-255', 'Red channel value'],\n        ['g', 'integer', '0-255', 'Green channel value'],\n        ['b', 'integer', '0-255', 'Blue channel value'],\n        ['a', 'integer', '0-100', 'Alpha (opacity) value, where 0 is transparent and 100 is opaque'],\n    ]}\n/>\n\nColor Roles\n\n- background: Main surface color for content areas\n- foreground: Default color for body text and content\n- accent: Color for interactive elements like links and button backgrounds\n- accentForeground: Text color used on accent-colored backgrounds (ex: button text)\n\nUsage in Publications\n\nInclude the basic theme in your publication record:\n\nBest Practices\n\n2. Consider readability: Ensure foreground/background combinations are legible\n3. Test button colors: Verify accent/accentForeground pairs have sufficient contrast\n5. Provide all required properties: All four color properties are required for a valid theme\n\nRelated\n\n- Publication lexicon - Publications can include basicTheme\n- Quick Start - Implementation guide\n- Implementations - See how platforms use theming",
  "title": "Basic Theme Lexicon"
}