Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getpara.com/llms.txt

Use this file to discover all available pages before exploring further.

v3.0.0
April 2026
Simplified the modal theming system with a new OKLCH-based color generation approach that replaces granular palette configuration.

Breaking Changes

  • Theme type simplified: ParaTheme reduced from 13 properties to 8. Removed darkForegroundColor, darkBackgroundColor, darkAccentColor, overlayBackground, oAuthLogoVariant, customPalette, customFontSizes, customBorderRadii
  • foregroundColor now drives the entire palette: Buttons, accents, rings, and primary colors are generated from it via OKLCH color space
  • accentColor deprecated: If provided, maps to foregroundColor for backward compatibility
  • customPalette replaced by cssOverrides: Use Record<string, string> for raw CSS variable overrides

New Features

  • foregroundMixRatio: Control how much the foreground color mixes into UI surfaces (default 0.04)
  • cssOverrides: Advanced escape hatch for setting raw CSS custom properties
  • Automatic dark mode detection: The system auto-detects dark/light mode from your background color lightness — just provide dark colors directly, no more separate dark mode color properties. Use mode only to override if auto-detection misclassifies your background
See the v2.x to v3.0 Migration Guide for detailed upgrade instructions.
For changelog entries prior to v3.0, switch to the 2.0 (LTS) docs from the version selector.