Repository navigation
docs: document build prerequisites and how to run the UI - #10
Open
h2m6jcm94s-eng wants to merge 1 commit into
Open
h2m6jcm94s-eng wants to merge 1 commit into
h2m6jcm94s-eng wants to merge 1 commit into
Conversation
A fresh checkout hits three errors the README never mentions:
WineBridge needs the x86_64-pc-windows-gnu target and MinGW, and the UI
and CLI fail at boot unless fvs2d is on PATH.
- rust-toolchain.toml makes rustup install the Windows target on demand.
- `just fvs2d` builds the daemon from the vendored fvs2d sources into
cargo's bin directory; `just run` starts the UI.
- The README lists the system packages for Debian/Ubuntu and Fedora,
the no-fvs fallback, and the disk space a debug build needs.
Assisted-by: Claude Code:claude-opus-5-5
AI-Scope: README prerequisites, justfile recipes and rust-toolchain.toml, from setup failures hit on a fresh Ubuntu machine ("make prs so that no one faces errors"); recipes verified locally.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Following the README on a fresh Ubuntu 26.04 machine (
git clone --recursive, thenjust build) runs into errors the README doesn't mention:can't find crate for std, because thex86_64-pc-windows-gnutarget isn't installed. With the target installed, it then fails onx86_64-w64-mingw32-dlltoolbecause MinGW is missing.Fvs(Io(NotFound))becausefvs2disn't onPATH. Nothing in the repo says how to get it.This PR adds:
rust-toolchain.toml: rustup installs the Windows target, clippy and rustfmt automatically on first use. The channel staysstable, matching the flake.just fvs2d: builds the daemon from the vendoredcrates/fvs2-rs/upstreamsources into$CARGO_HOME/bin, so it's onPATHfor rustup users.just run: runs the UI. Arguments are forwarded, sojust run --no-default-featuresruns it without Virgo.Related: bottlesdevs/next-core#58 makes the missing-
fvs2derror name the daemon. bottlesdevs/next-ui#6 and #9 fix thenext-uicompile errors onmain.Testing
just fvs2dbuilds and installs the daemon with Go 1.27.bottles-cli profiles listboots andnext-uistarts.rust-toolchain.toml.Generative AI assistance
AI assistance: disclosed
🤖 Generated with Claude Code