Skip to content

Enhance installation instructions for Wails - #5834

Open
ChrisCampaDev wants to merge 1 commit into
wailsapp:masterfrom
ChrisCampaDev:patch-2
Open

Enhance installation instructions for Wails#5834
ChrisCampaDev wants to merge 1 commit into
wailsapp:masterfrom
ChrisCampaDev:patch-2

Conversation

@ChrisCampaDev

@ChrisCampaDev ChrisCampaDev commented Jul 27, 2026

Copy link
Copy Markdown

Updated installation instructions for Wails to include new commands for updating PATH in different shell environments.

Description

Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context. List any dependencies that are required for this change.

Fixes # (issue)

Type of change

Please select the option that is relevant.

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • This change requires a documentation update

How Has This Been Tested?

Please describe the tests that you ran to verify your changes. Provide instructions so we can reproduce. Please also list any relevant details for your test configuration using wails doctor.

  • Windows
  • macOS
  • Linux

If you checked Linux, please specify the distro and version.

Test Configuration

Please paste the output of wails doctor. If you are unable to run this command, please describe your environment in as much detail as possible.

Checklist:

  • (v2 only) I have updated website/src/pages/changelog.mdx with details of this PR (v3 changelog entries are added automatically)
  • My code follows the general coding style of this project
  • I have performed a self-review of my own code
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings
  • I have added tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes

Summary by CodeRabbit

  • Documentation
    • Updated Linux PATH setup instructions with separate guidance for Bash, Zsh, and Fish shells.
    • Added Fish-specific initialization steps using fish_add_path.
    • Improved clarity by presenting shell commands in dedicated tabs.

Updated installation instructions for Wails to include new commands for updating PATH in different shell environments.
@github-actions github-actions Bot added the Documentation Improvements or additions to documentation label Jul 27, 2026
@coderabbitai

coderabbitai Bot commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Walkthrough

The Linux installation guide replaces combined Bash/Zsh PATH instructions with an MDX Tabs section containing separate Bash, Zsh, and Fish commands.

Changes

Installation documentation

Layer / File(s) Summary
Shell-specific PATH instructions
website/versioned_docs/version-v2.13.0/gettingstarted/installation.mdx
Adds separate Bash, Zsh, and Fish PATH update commands, including fish_add_path for Fish.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

  • wailsapp/wails#4340: Refactors the corresponding Linux installation PATH instructions into shell-specific Tabs.

Suggested labels: Linux

Suggested reviewers: leaanthony

Poem

I’m a rabbit hopping through the shell,
Bash and Zsh now ring the bell.
Fish gets paths in tidy flight,
Tabs make every command feel right.
hop hop—installation shines bright!

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description leaves all template fields unfilled, including issue reference, testing, and checklist selections. Fill in the summary, linked issue, type of change, test details, test configuration, and complete the checklist items.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title matches the change by describing an installation documentation update for Wails.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@website/versioned_docs/version-v2.13.0/gettingstarted/installation.mdx`:
- Around line 76-84: Update the bash and zsh TabItem command blocks to remove
the “bash:” and “zsh:” prefixes, leaving only the executable source commands so
they can be copied and run directly.
- Around line 86-87: Update the Fish installation command in the fish TabItem to
derive the Go binary directory from `go env GOPATH`, matching the Bash and Zsh
instructions, so custom GOPATH configurations resolve the correct path.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 9b951afc-aa60-40a4-8296-d9bc2f8d7cda

📥 Commits

Reviewing files that changed from the base of the PR and between aa6eabe and e6c21a4.

📒 Files selected for processing (1)
  • website/versioned_docs/version-v2.13.0/gettingstarted/installation.mdx

Comment on lines +76 to +84
<TabItem value="bash">
<code>export PATH=$PATH:$(go env GOPATH)/bin</code>
<br/>
<code>source ~/.bashrc</code> or <code>source ~/.zshrc</code>
<code>bash: source ~/.bashrc</code>
</TabItem>
<TabItem value="zsh">
<code>export PATH=$PATH:$(go env GOPATH)/bin</code>
<br/>
<code>zsh: source ~/.zshrc</code>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟠 Major | ⚡ Quick win

Remove the bash: and zsh: prefixes from the commands.

Lines 79 and 84 currently render bash: source ~/.bashrc and zsh: source ~/.zshrc; copying either line literally will fail because bash:/zsh: is interpreted as the command name.

Proposed fix
-    <code>bash: source ~/.bashrc</code>
+    <code>source ~/.bashrc</code>
...
-    <code>zsh: source ~/.zshrc</code> 
+    <code>source ~/.zshrc</code>
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
<TabItem value="bash">
<code>export PATH=$PATH:$(go env GOPATH)/bin</code>
<br/>
<code>source ~/.bashrc</code> or <code>source ~/.zshrc</code>
<code>bash: source ~/.bashrc</code>
</TabItem>
<TabItem value="zsh">
<code>export PATH=$PATH:$(go env GOPATH)/bin</code>
<br/>
<code>zsh: source ~/.zshrc</code>
<TabItem value="bash">
<code>export PATH=$PATH:$(go env GOPATH)/bin</code>
<br/>
<code>source ~/.bashrc</code>
</TabItem>
<TabItem value="zsh">
<code>export PATH=$PATH:$(go env GOPATH)/bin</code>
<br/>
<code>source ~/.zshrc</code>
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@website/versioned_docs/version-v2.13.0/gettingstarted/installation.mdx`
around lines 76 - 84, Update the bash and zsh TabItem command blocks to remove
the “bash:” and “zsh:” prefixes, leaving only the executable source commands so
they can be copied and run directly.

Comment on lines +86 to +87
<TabItem value="fish">
<code>fish_add_path ~/go/bin</code>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Derive Fish’s path from GOPATH as well.

fish_add_path ~/go/bin only works with the default GOPATH, whereas the Bash and Zsh commands use go env GOPATH. Users with a custom GOPATH will add the wrong directory and may still see wails: command not found.

-    <code>fish_add_path ~/go/bin</code>
+    <code>fish_add_path (go env GOPATH)/bin</code>
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
<TabItem value="fish">
<code>fish_add_path ~/go/bin</code>
<TabItem value="fish">
<code>fish_add_path (go env GOPATH)/bin</code>
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@website/versioned_docs/version-v2.13.0/gettingstarted/installation.mdx`
around lines 86 - 87, Update the Fish installation command in the fish TabItem
to derive the Go binary directory from `go env GOPATH`, matching the Bash and
Zsh instructions, so custom GOPATH configurations resolve the correct path.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant