Skip to content

Fix broken manual installation instructions#171

Merged
kcmartin merged 2 commits intomainfrom
fix/installation-instructions
Apr 21, 2026
Merged

Fix broken manual installation instructions#171
kcmartin merged 2 commits intomainfrom
fix/installation-instructions

Conversation

@kcmartin
Copy link
Copy Markdown
Collaborator

@kcmartin kcmartin commented Apr 20, 2026

Summary

  • Fix checksum verification failing because .sha256 file references a subfolder path (sprite-darwin-arm64/sprite-darwin-arm64.tar.gz) while the user downloads the file to the current directory
  • Add line continuations (\) to long curl commands to prevent copy-paste issues from visual line wrapping
  • Add error handling to the CLI version fetch (check response status, trim whitespace, validate non-empty)

Closes #162

Testing

Verify on the preview deployment that /cli/installation/ renders code blocks without unintended wrapping and that the commands copy cleanly. The checksum verification command can be validated by running it against a real download.

Testing done.

@kcmartin kcmartin force-pushed the fix/installation-instructions branch from 1253e48 to 9911503 Compare April 20, 2026 23:59
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 21, 2026

Preview Deployment

Name URL
Preview https://pr-171-superfly-sprites-docs.fly.dev

Commit: 9540f27

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 21, 2026

Lighthouse Results

URL Performance Accessibility Best Practices SEO
/ 🟠 87 🟢 100 🟢 96 🟢 100

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 21, 2026

E2E Test Results

✅ Tests success

Ran against: https://pr-171-superfly-sprites-docs.fly.dev

The checksum verification commands failed because the .sha256 file
references a subfolder path (e.g. sprite-darwin-arm64/sprite-darwin-arm64.tar.gz)
while the downloaded file is in the current directory. Fixed by piping through
awk to extract the hash and pair it with the correct local filename.

Also added line continuations to long curl commands to prevent copy-paste
issues from visual wrapping, and added error handling to the version fetch.

Closes #162
@kcmartin kcmartin force-pushed the fix/installation-instructions branch from a63492d to 42561a4 Compare April 21, 2026 00:14
@kcmartin kcmartin merged commit da55c74 into main Apr 21, 2026
5 checks passed
@kcmartin kcmartin deleted the fix/installation-instructions branch April 21, 2026 00:20
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.

Installation instruction problems

1 participant