Skip to content

docs(appearance): document the Appearance page, theme presets, and color customizer - #16087

Open
blakeaowens wants to merge 2 commits into
bugfixfrom
appearance-theme-customizer-docs
Open

blakeaowens wants to merge 2 commits into
bugfixfrom
appearance-theme-customizer-docs

Conversation

@blakeaowens

Copy link
Copy Markdown
Contributor

Description

Documents the Pro Appearance page (Settings > System > Appearance) and how reports follow it.

New page: Admin > Appearance (docs/content/admin/appearance/)

  • The per-browser Theme control (System, Light, Dark), and how it decides which mode the page edits.
  • The two theme presets, DefectDojo and Legacy, and what switching and Reset All Colors do.
  • The primary color, and how button text stays readable on a custom primary.
  • Interface colors, set separately for light and dark mode: neutral palette, surfaces, text, components, and operational status.
  • The Legibility section: the WCAG 2.1 AA checks, and when a change is previewed but not saved.
  • Metric colors (severity, risk, grade, CVSS).
  • Reports and exports: metrics and dashboard PDF exports, Report Builder charts (including scheduled and API-generated reports), reports with no theme, and new report themes all use the instance's light-mode colors.
  • Automating the settings through the ui_color_theme field of /api/v2/system_settings/{id}/.

The page includes one screenshot of the Appearance page, committed under the page's images/ folder.

Report Builder page: the theme settings table described fixed hex defaults. A new theme now starts from the instance's Appearance colors, so the Default column describes those instead, and the section links to the Appearance page.

English only. Per docs/TRANSLATIONS.md, translated pages are regenerated from English in the quarterly refresh.

The matching Pro change ships in the same release (3.3.300).

🤖 Generated with Claude Code

blakeaowens and others added 2 commits September 24, 2026 16:10
…lor customizer

Adds an Appearance section under Admin covering the theme preset choice
(DefectDojo and Legacy), the primary color, the interface colors set
separately for light and dark mode (neutral palette, surfaces, text,
components, operational status), the Legibility checks that stop an
unreadable change from saving, the metric colors, and the ui_color_theme
field on /api/v2/system_settings/ for automation.

Pairs with the Pro change that ships the customizer on the same release line.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…mes start from it

- Appearance: a Reports and exports section (metrics and dashboard PDF exports,
  Report Builder charts including scheduled reports, reports with no theme,
  and new report themes all use the instance's light-mode colors).
- Report Builder: the theme defaults table now describes the instance-derived
  starting colors instead of fixed hex values.
- Retake the Appearance screenshot with the current logo.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@blakeaowens blakeaowens added this to the 3.3.300 milestone Sep 24, 2026
@github-actions github-actions Bot added the docs label Sep 24, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant