browser/openspec/changes/polish-ai-provider-onboarding/specs/platform-web-theme/spec.md

MODIFIED Requirements

Requirement: Uploaded backgrounds remain readable and restrained

The platform_web theme system SHALL preserve uploaded background visibility while keeping operational surfaces readable and avoiding harsh high-saturation overlays.

Scenario: Magical-girl theme uses a custom background

• WHEN data-custom-background="true" and data-theme-palette="magical-girl" are active
• THEN shared operational surfaces MUST use restrained translucent materials, muted frame accessories, and reduced glow so the background does not become visually harsh

Scenario: Custom background theme styling changes

• WHEN custom-background shared CSS is modified
• THEN CSS contract tests or theme documentation MUST cover the intended restraint so future changes do not reintroduce excessive pink/gold gradients