Cratebug is an open-source, Windows-first mod manager for Marvel Rivals.
The project is a fresh implementation built with Go, Wails, React, and TypeScript. It aims to preserve useful workflows and compatibility with existing mod libraries while making filesystem operations safe, predictable, and recoverable.
Cratebug has completed its Phase 0 repository and toolchain foundation, Phase 1 read-only discovery scanner, and Phase 2 read-only library UI. The application can scan a selected mod root, report empty and inaccessible directories, browse the discovered folder hierarchy, search locally, and switch between compact, large, and list catalog views.
Phase 3 will add the first safe filesystem mutations: enabling and disabling discovered mods while preserving sidecars and enforcing backend safety checks.
See:
Development currently targets 64-bit Windows 10 version 1909 or newer and Windows 11. Install:
- Git
mise- Microsoft WebView2 Runtime
- NSIS 3 when building the installer
Install mise and NSIS with Windows Package Manager:
winget install jdx.mise
winget install NSIS.NSIS --silentRestart the terminal after installing system tools so their updated paths are available.
Clone the repository:
git clone https://github.com/Kuusouu/Cratebug.git
Set-Location CratebugInstall the pinned Go and Bun versions through mise:
mise installInstall the pinned Wails CLI:
mise exec -c "go install github.com/wailsapp/wails/v2/cmd/wails@v2.13.0"
$env:Path = "$(mise exec -c "go env GOPATH")\bin;$env:Path"Install frontend dependencies from the committed Bun lockfile:
Push-Location frontend
mise exec -c "bun install --frozen-lockfile"
Pop-LocationVerify the installed versions:
mise exec -c "go version"
mise exec -c "bun --version"
mise exec -c "wails version"See the toolchain decision for exact versions and the upgrade policy.
Start the Wails development application from the repository root:
mise exec -c "wails dev"Wails installs frontend dependencies from frontend/bun.lock, starts Vite through Bun, generates typed application bindings, and launches the desktop window.
Run every required frontend and Go check from the repository root:
.\check.ps1The frontend scripts are run from frontend:
| Command | Purpose |
|---|---|
mise exec -c "bun run dev" |
Start the Vite development server |
mise exec -c "bun run build" |
Type-check and build the frontend |
mise exec -c "bun run format" |
Apply Biome formatting |
mise exec -c "bun run format:check" |
Check Biome formatting without changes |
mise exec -c "bun run lint" |
Run Biome lint rules |
mise exec -c "bun run typecheck" |
Run TypeScript without emitting files |
mise exec -c "bun run check" |
Run all frontend checks and the build |
Canonical Go commands are run from the repository root:
mise exec -c "go fmt ./..."
mise exec -c "go vet ./..."
mise exec -c "go test ./..."Build the production Windows AMD64 application from the repository root:
mise exec -c "wails build -clean -platform windows/amd64 -nopackage -nocolour"The production executable is written to build/bin/Cratebug.exe. The generated build directory is intentionally ignored by Git.
After installing NSIS, build the per-user Windows AMD64 installer:
mise exec -c "wails build -clean -platform windows/amd64 -nsis -installscope user -nocolour"The installer is written to build/bin/Cratebug-amd64-installer.exe. A default installation uses %LOCALAPPDATA%\Programs\Cratebug, creates Start menu and desktop shortcuts, and can be removed from Windows Settings or with the installed uninstall.exe.
Phase 0 packages are unsigned, so Windows may display an unrecognized-app warning. Signing, upgrades, and release publishing are deferred to release hardening.
GitHub Actions runs the canonical checks and a clean Windows application build on Blacksmith for pushes and pull requests to master. CI verifies the application without publishing packages or build artifacts.
Cratebug is licensed under the GNU General Public License version 3. See LICENSE.