Skip to content

feat: standalone installer and GitHub Releases distribution#72

Merged
rhuanbarreto merged 5 commits into
mainfrom
feat/standalone-installer
Mar 18, 2026
Merged

feat: standalone installer and GitHub Releases distribution#72
rhuanbarreto merged 5 commits into
mainfrom
feat/standalone-installer

Conversation

@rhuanbarreto

Copy link
Copy Markdown
Contributor

Summary

  • Standalone installers: install.sh (macOS/Linux) and install.ps1 (Windows) download pre-built binaries from GitHub Releases — no Node.js or npm required
  • GitHub Releases assets: The release workflow now uploads .tar.gz (Unix) and .zip (Windows) archives alongside the existing npm publish
  • Documentation updated: All installation docs (EN + pt-BR), README, CI integration guides, and LLM docs now feature the standalone installer as the recommended method

This unblocks developers outside the JavaScript ecosystem (.NET, Python, Go, etc.) from using archgate without installing Node.js.

Shell installer features

  • Detects platform (macOS/Linux) and architecture (arm64/x64)
  • Detects all installed shell profiles (zsh, bash, fish, nushell, ion, csh/tcsh) and generates correct PATH syntax for each
  • Prompts for confirmation before modifying any profile files (reads from /dev/tty so it works even when piped via curl | sh)
  • Supports ARCHGATE_VERSION and ARCHGATE_INSTALL_DIR env vars for customization

Test plan

  • Verify release-binaries.yml syntax is valid (GitHub Actions linter)
  • Run bash -n install.sh to validate shell script syntax
  • Test install.sh on macOS and Linux (manual or CI)
  • Test install.ps1 on Windows (manual)
  • Verify docs render correctly on the Astro site
  • Trigger a test release to confirm binaries appear as GitHub Release assets

Allow developers outside the JavaScript ecosystem to install archgate
without npm/Node.js. Binaries are now uploaded to GitHub Releases during
the release workflow, and one-line installer scripts handle download,
extraction, and PATH setup.

- Add install.sh (macOS/Linux) with shell profile detection and
  interactive PATH configuration
- Add install.ps1 (Windows PowerShell)
- Update release-binaries.yml to upload .tar.gz/.zip assets to the
  GitHub Release
- Update all docs (EN + pt-BR) to feature standalone install as the
  recommended method
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Mar 18, 2026

Copy link
Copy Markdown

Deploying archgate-cli with  Cloudflare Pages  Cloudflare Pages

Latest commit: 09646c7
Status: ✅  Deploy successful!
Preview URL: https://9947137e.archgate-cli.pages.dev
Branch Preview URL: https://feat-standalone-installer.archgate-cli.pages.dev

View logs

Runs `bun run validate` before any `git commit` command and blocks
the commit if validation fails. Ensures lint, typecheck, format,
tests, ADR checks, and build all pass before committing.
@rhuanbarreto rhuanbarreto merged commit 09fc5dd into main Mar 18, 2026
7 checks passed
@rhuanbarreto rhuanbarreto deleted the feat/standalone-installer branch March 18, 2026 13:22
This was referenced Mar 18, 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