Skip to content

Upgrade to Wails v3, mobile clients, and docs overhaul - #1

Merged
SihanTeng merged 6 commits into
mainfrom
upgrade/wails-v3
Jul 30, 2026
Merged

Upgrade to Wails v3, mobile clients, and docs overhaul#1
SihanTeng merged 6 commits into
mainfrom
upgrade/wails-v3

Conversation

@SihanTeng

Copy link
Copy Markdown
Owner

Summary

  • Upgrade desktop app from Wails v2 → v3 (v3.0.0-alpha2.119), with gtk3/webkit2gtk 4.1 on Linux for CI/distro parity
  • Expanded backend tests before/after the cutover; settings/history one-shot migrate from croc-gui.*croc-desktop.*
  • Responsive UI (bottom tabs ≤720px) plus iOS / Android Wails v3 scaffolds under build/ios and build/android
  • User-facing README, Contributor Covenant Code of Conduct, packaging/CI paths updated (bin/, wails3)

Test plan

  • go test -tags gtk3 .
  • Frontend typecheck / lint / vitest
  • wails3 build -tags gtk3 (local)
  • CI green on this PR
  • Spot-check desktop install artifacts after merge (optional release dry-run)

Notes

This fully replaces the v2-based main tip. Mobile is experimental (build-from-source); desktop remains the published release path.

Migrate the desktop app to Wails v3 (application services, Event.Emit,
dialog API, data-file-drop-target) and keep Linux on gtk3/webkit2gtk 4.1.
Add App API integration tests before the upgrade so transfers, settings,
and event wiring keep working across the cutover.
wails3 dev builds with DEV=true and expects npm run build:dev for
unminified frontend assets during hot reload.
Switch the chrome to a bottom tab bar below 720px with safe-area insets
and larger touch targets so the same React UI works on phones and Wails
mobile webviews. Scaffold build/ios and build/android (bundle id
com.schollz.croc-desktop), platform option hooks, and Taskfile mobile
tasks for simulator/emulator builds.
Honest post-upgrade cleanup: document gtk3 tags and data-path
compatibility, one-shot migrate legacy croc-gui settings/history onto
croc-desktop filenames, fix MSIX config and Android applicationId,
drop dead iOS option stubs and leftover wailsjs, and align README,
design.md, and e2e docs with the responsive mobile shell.
Lead with install, how-to, features, and FAQ; tuck developer setup behind
a collapsible section. Add Contributor Covenant 2.1 for community norms.
Call out that this tree is Wails v3 (not v2), and give mobile iOS/Android
a first-class section with paths, status, and build commands so they are
not buried in the FAQ.
@SihanTeng
SihanTeng merged commit 333681d into main Jul 30, 2026
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.

1 participant