Skip to content

Add changelog and docs for Homebrew-native CLI binaries#2881

Open
atharvadeosthale wants to merge 1 commit intomainfrom
devrel/cli-homebrew-native-binaries
Open

Add changelog and docs for Homebrew-native CLI binaries#2881
atharvadeosthale wants to merge 1 commit intomainfrom
devrel/cli-homebrew-native-binaries

Conversation

@atharvadeosthale
Copy link
Copy Markdown
Member

Summary

  • Changelog entry: Announces that the Appwrite CLI now ships native compiled binaries via Homebrew for macOS and Linux (arm64 and x64), with faster startup and no runtime dependencies.
  • Install docs update: Restructures the CLI installation page to make Homebrew the recommended install path on macOS/Linux, adds Linux Homebrew support, and clarifies the distinction between native binaries (Homebrew), npm, and script-based installs across install/update/uninstall sections.

Context

The sdk-generator repo recently merged native binary distribution via Homebrew (appwrite/sdk-generator#1431). The CLI formula now delivers platform-specific compiled binaries built with Bun instead of a Node.js-based package. This PR updates the website so users can discover and understand the change.

Test plan

  • Verify the changelog entry renders correctly at /changelog
  • Verify the install docs page renders correctly at /docs/tooling/command-line/installation
  • Confirm all tabs (Homebrew, npm, script, Windows, Linux) display properly in install/update/uninstall sections
  • Check that the arrow_link in the changelog points to the correct install docs URL

🤖 Generated with Claude Code

The Appwrite CLI now ships native compiled binaries via Homebrew for
macOS and Linux. Update the install docs to make Homebrew the
recommended install path, add Linux Homebrew support, and add a
changelog entry announcing the change.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@appwrite
Copy link
Copy Markdown

appwrite bot commented Apr 10, 2026

Appwrite Website

Project ID: 69d7efb00023389e8d27

Sites (1)
Site Status Logs Preview QR
 website
69d7f2670014e24571ca
Failed Failed View Logs Preview URL QR Code

Website (appwrite/website)

Project ID: 684969cb000a2f6c0a02

Sites (1)
Site Status Logs Preview QR
 website
68496a17000f03d62013
Processing Processing View Logs Preview URL QR Code


Tip

Teams feature lets you group users with membership management and role permissions

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps bot commented Apr 10, 2026

Greptile Summary

This PR adds a changelog entry announcing native Homebrew CLI binaries and restructures the CLI installation docs to promote Homebrew as the recommended install path on macOS and Linux, while preserving npm and script-based install options. The changes are accurate and well-organized; the only minor rough edge is that the "Install with script" section labels its macOS and Linux tabs as \"macOS\" / \"Linux\" instead of \"macOS (script)\" / \"Linux (script)\", which is inconsistent with how the same tabs are labeled in the update and uninstall sections.

Confidence Score: 5/5

Safe to merge — all findings are cosmetic P2 label inconsistencies that don't affect functionality.

Both files contain only documentation/content changes. The commands are correct (brew install, brew upgrade, brew uninstall), the changelog entry is accurate, and the restructuring is coherent. The only issues are minor tab label inconsistencies, which are P2 suggestions and do not block merge.

No files require special attention.

Important Files Changed

Filename Overview
src/routes/changelog/(entries)/2026-04-10.markdoc New changelog entry for native Homebrew CLI binaries — well-structured, accurate commands, and correct link to install docs.
src/routes/docs/tooling/command-line/installation/+page.markdoc Restructures install/update/uninstall sections to promote Homebrew as the recommended path; minor inconsistency in script-install tab labels ("macOS"/"Linux" vs. "macOS (script)"/"Linux (script)") between the install and update/uninstall sections.

Comments Outside Diff (1)

  1. src/routes/docs/tooling/command-line/installation/+page.markdoc, line 72 (link)

    P2 Same inconsistency for Linux tab

    Same label inconsistency as the macOS tab above — the Linux script tab here should match the "Linux (script)" label used in the update and uninstall sections.

Reviews (1): Last reviewed commit: "Add changelog and update install docs fo..." | Re-trigger Greptile

The CLI also ships with installation scripts for platforms where Homebrew is not available.

{% tabs %}
{% tabsitem #macos title="macOS" %}
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.

P2 Inconsistent tab titles in "Install with script" section

The macOS and Linux tabs in the "Install with script" section are labeled "macOS" and "Linux" (lines 51, 72), but the analogous tabs in the Update and Uninstall sections are labeled "macOS (script)" and "Linux (script)" (lines 95, 107, 226, 247). A user skimming only the install section won't see the (script) qualifier that distinguishes them from the Homebrew tabs above. Making the labels consistent would reduce ambiguity.

Suggested change
{% tabsitem #macos title="macOS" %}
{% tabsitem #macos title="macOS (script)" %}

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

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