ForgeBot investigation brief · Generated July 03, 2026
This page intentionally imports the live ForgeFX design stylesheet on a dark brown report shell. If the title and section headings appear dark gray, the bug has reproduced.
The report imported the shared design stylesheet but did not opt into dark theme tokens. The shared stylesheet sets semantic heading colors to the default foreground token. That default token is dark gray for light-mode pages, so large headings become near-black on the warm brown background.
Recent Share Preview guidance started pushing generated artifacts toward the ForgeFX design system and the live design stylesheet. That is right for brand consistency, but dark standalone pages need one extra instruction: use dark tokens or override heading colors after the import.
The Dave report had dark body styling and readable body text, but its main title and section headings did not set their own color. The imported stylesheet’s global heading rule won the cascade.
The key chain is the design bundle’s semantic heading rules, followed by Share Preview guidance that made generated pages import the ForgeFX design system by default.
The Share Preview skill now warns that dark generated pages importing the master stylesheet must use data-theme="dark" or explicitly set heading colors to warm white after the import.
| Signal | Finding | Meaning |
|---|---|---|
| Live computed style | Heading color was rgb(19, 24, 32). | The dark gray came from the design stylesheet’s light-mode foreground token. |
| Design stylesheet | h1, h2, h3 use color: var(--fg). | Imported global heading styles override normal body inheritance. |
| Theme token | Dark foreground exists under [data-theme="dark"]. | The page had a valid fix available, but did not opt in. |
| Contrast math | Dark heading on Forge-black is about 1.06:1. | This is objectively unreadable and matches Adam’s report. |
<link rel="stylesheet" href="https://design.forgefx.dev/colors_and_type.css"> <body style="background:#261B13; color:#FFF4E2"> <h1>This heading becomes dark gray</h1> </body>
SAFE DARK-PAGE PATTERN
Set data-theme="dark" or force headings warm-white
This sample stays readable because it explicitly sets the dark-page heading color after the shared stylesheet.