Skip to content

docs: document the WebView2 runtime requirement on Windows - #328

Open
hiro-nikaitou wants to merge 1 commit into
tonyantony300:mainfrom
hiro-nikaitou:fix/troubleshooting-webview2
Open

hiro-nikaitou wants to merge 1 commit into
tonyantony300:mainfrom
hiro-nikaitou:fix/troubleshooting-webview2

Conversation

@hiro-nikaitou

Copy link
Copy Markdown

Description

The Windows paragraph under The app won't open covers SmartScreen but not the other common reason a Windows launch looks like nothing happened: a missing or damaged Microsoft Edge WebView2 Runtime. In that case double-clicking the app produces no window and no process in Task Manager, so it reads as a crash even though the app never started. This adds that case to the existing Windows entry, with the link to Microsoft's runtime download.

Fixes #197

Checklist

  • PR title follows Conventional Commits (type(scope): description)
  • I have run pnpm lint before raising this PR
  • I have run pnpm format before raising this PR

Docs-only change: no code, lockfile, or dependency touched.

Launching DashBeam on Windows with a missing or damaged Edge WebView2 Runtime
does nothing at all: no window appears and no process shows in Task Manager.
The installer and the portable build are both affected, so the failure looks
like a crash even though the app never started.

Add it to the Windows entry under 'The app won't open', next to the existing
SmartScreen note, with the link to Microsoft's runtime download.

Signed-off-by: hiro-nikaitou <vieteviete@proton.me>
@coderabbitai

coderabbitai Bot commented Sep 23, 2026

Copy link
Copy Markdown
Contributor

Review in Change Stack →

Navigate logical layers of code changes, visualize relationships, and explore their blast radius.

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Advanced

Run ID: 294e1385-609e-4bb4-b886-d9bf375bc49f

📥 Commits

Reviewing files that changed from the base of the PR and between ccc1eb8 and e075314.

📒 Files selected for processing (1)
  • docs/troubleshooting.md

Included review availability: Your plan provides up to 8 included reviews per hour; 6 remain after this review.


📝 Walkthrough

Walkthrough

The troubleshooting guide adds a Windows launch-failure case. It identifies a missing or damaged Microsoft Edge WebView2 Runtime as the cause and tells users to install it from Microsoft and launch the app again.

Changes

Windows launch troubleshooting

Layer / File(s) Summary
Document the WebView2 fix
docs/troubleshooting.md
Adds guidance for the no-window, no-process symptom and instructs users to install the WebView2 Runtime from Microsoft, then relaunch.

Assessment against linked issues

Objective Addressed Explanation
Explain the Windows launch symptom and provide the WebView2 installation-and-relaunch fix [#197]

Suggested reviewers: tonyantony300

Priority: ➖ Normal

Change: Other · Severity of issue fixed: Medium

Merge Risk: ⚪ Minimal · up to e0753

This adds a WebView2 recovery step for affected Windows launches without changing app behavior. The available evidence shows no material reason to hold this documentation change.

🚥 Pre-merge checks | ✅ 1
✅ Passed checks (1 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create a new PR

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@CLAassistant

CLAassistant commented Sep 23, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

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

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

AltSendme Won't Launch on Windows (Missing Edge WebView2 Runtime)

2 participants