pageColors causes white flash while scrolling

[downpogo]

Before you start - checklist

• I followed instructions in documentation written for my React-PDF version
• I have checked if this bug is not already reported
• I have checked if an issue is not listed in Known issues
• If I have a problem with PDF rendering, I checked if my PDF renders properly in PDF.js demo

Description

When using the recently added pageColors prop to override PDF text/background colors, I see intermittent white flashes while scrolling through pages.

Screen.Recording.2026-02-23.143828.mp4

Steps to reproduce

1. Go to https://zathura.downpogo.workers.dev
2. Open a PDF by pressing o
3. Scroll through the PDF

Here's the code

Expected behavior

Pages should keep the configured pageColors continuously while scrolling, without flashing white between renders.

Actual behavior

While scrolling, some pages briefly flash white before returning to the configured colors.

Additional information

No response

Environment

No response

[wojtekmaj]

Try also setting canvasBackground?

Also investigate why do you have these re-renders at all. Not saying it's not react-pdf's fault you have these flashes to begin with, but it would probably wise to check that out :)

[downpogo]

Yes, I tried setting canvasBackground as well. This is what am seeing. Colors are mixed?

One thing I noticed. Am not seeing those flashes when I only set canvasBackground. Am assuming the rerendering happens cuz of tanstack virtual. I'll have to check.