OpenCut-app / OpenCut-app/OpenCut

docs(desktop): Windows README says "no extra dependencies" but MSVC linker is required

Open Beginner friendly
#892 2 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
89.8k
Forks
8.9k
PR merge metrics
No merged PRs in 30d

Description

When running moon run desktop:dev on Windows without Visual Studio / Build Tools installed, the build fails with:

`error: linker `link.exe` not found`
`note: the msvc targets depend on the msvc linker but `link.exe` was not found`

apps/desktop/README.md currently states under "Platform requirements":

Windows: no extra dependencies (Win32 + DirectWrite).

This isn't accurate - the MSVC linker (from Visual Studio Build Tools, "Desktop development with C++" workload) is required to compile Rust crates on Windows. Installing it via:

`winget install --id Microsoft.VisualStudio.2022.BuildTools --override "--quiet --wait --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended"`

resolves the build.

I have a one-line doc fix ready on my fork (branch docs/desktop-windows-msvc-prereq) clarifying this requirement, happy to open a PR if that's welcome given the current contribution policy.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start in apps/desktop/README.md under “Platform requirements” and review the Windows prerequisite wording. Update it to mention the MSVC linker, Visual Studio Build Tools, and the Desktop development with C++ workload, then verify the documented requirement against moon run desktop:dev on Windows.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
desktop, documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
92/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.