White screen debug
Skill swd3k/skills/agent-skills/workflows/white-screen-debug
Diagnose blank/white UI in web and desktop webview apps with a ordered checklist. Use when the window opens empty, CSS fails, or only HTML shell shows.From its SKILL.md
npx -y skills add swd3k/skills --skill white-screen-debugAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
1.0 KB, 207 tokens by cl100k_base, as published. Nobody here has run it
White Screen Debug
Ordered checks
- Process alive? window opened, no crash loop
- URL / load method — file://, https://, data, LoadRawString
- DevTools console — first exception wins
- Network/assets — CSS/JS 404 or blocked
- Path packing — works in dev, fails in publish (cwd, case, asar)
- WebView2 / browser runtime installed?
- CSP blocking inline or file scripts?
- Theme — white text on white? (not true white screen but looks empty)
Photino-specific
- file:// primary for multi-file UI
- raw string requires inlined CSS
- Log absolute path passed to Load
Fix pattern
- Minimal repro HTML (red body background) to prove paint works
- Then reintroduce CSS/JS layers
Acceptance
- Root cause named; regression note added
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.