wails icon indicating copy to clipboard operation
wails copied to clipboard

Update installation.mdx

Open alexiej opened this issue 7 months ago • 3 comments

Resolving zsh: command not found for Wails on macOS

Description

This PR addresses the issue of the zsh: command not found error that occurs when running the wails command on macOS. This error is typically caused by the Wails binary being located in the ~/go/bin directory, which is not included in the system's PATH.

The changes include instructions on how to resolve this issue by either copying the wails binary to a directory that is in the PATH or updating the ~/.zshrc file to include an alias for the wails command.

Fixes # 2046 https://github.com/wailsapp/wails/issues/2046

Type of change

Please delete options that are not relevant.

  • [X ] This change requires a documentation update

How Has This Been Tested?

  • [X ] macOS

Test Configuration

Wails

Version | v2.9.1

System

┌────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ | OS | MacOS | | Version | 14.3 | | ID | 23D56 | | Go Version | go1.22.5 | | Platform | darwin | | Architecture | amd64 | | CPU | Intel(R) Core(TM) i5-8259U CPU @ 2.30GHz | | GPU | Chipset Model: Intel Iris Plus Graphics 655 Type: GPU Bus: Built-In VRAM (Dynamic, Max): 1536 MB Vendor: Intel Device ID: 0x3ea5 Revision ID: 0x0001 Metal Support: Metal 3 | | Memory | 16GB | └────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

Dependencies

┌──────────────────────────────────────────────────────────────────────┐ | Dependency | Package Name | Status | Version | | Xcode command line tools | N/A | Installed | 2405 | | Nodejs | N/A | Installed | 21.3.0 | | npm | N/A | Installed | 10.2.4 | | *Xcode | N/A | Installed | 15.4 (15F31d) | | *upx | N/A | Available | | | *nsis | N/A | Available | | └────────────────────── * - Optional Dependency ───────────────────────┘

Diagnosis

Optional package(s) installation details:

  • upx : Available at https://upx.github.io/
  • nsis : More info at https://wails.io/docs/guides/windows-installer/

SUCCESS Your system is ready for Wails development!

♥ If Wails is useful to you or your company, please consider sponsoring the project:

Checklist:

  • [X ] I have made corresponding changes to the documentation
  • [X ] My changes generate no new warnings

Summary by CodeRabbit

  • New Features
    • Enhanced installation instructions for macOS users to resolve the zsh: command not found error related to the wails command.
      • Added solutions for updating the PATH and creating an alias in the ~/.zshrc file.

alexiej avatar Jul 30 '24 13:07 alexiej