Skip to content

Conversation

@rfay
Copy link
Member

@rfay rfay commented Dec 2, 2025

The Issue

This change addresses the confusion users face when installing DDEV on ARM64 Windows devices (like Microsoft Surface Pro laptops with Snapdragon processors). Previously, only the AMD64/Intel installer was shown, leading users to download the wrong architecture and experience installation failures.

How This PR Solves The Issue

Changes:

  • Added new /download page with all artifacts and static URL links
  • Added separate download buttons for both AMD64/Intel and ARM64/Snapdragon architectures
  • Updated button layout to display side-by-side on larger screens and stacked on mobile
  • Clarified architecture in button text to help users choose the correct installer
  • Fixed fallback version in api.ts for local development without GitHub token

Review

🤖 Developed with assistance from Claude Code

This change addresses the confusion users face when installing DDEV on ARM64 Windows devices (like Microsoft Surface Pro laptops with Snapdragon processors). Previously, only the AMD64/Intel installer was shown, leading users to download the wrong architecture and experience installation failures.

Changes:
- Added separate download buttons for both AMD64/Intel and ARM64/Snapdragon architectures
- Updated button layout to display side-by-side on larger screens and stacked on mobile
- Clarified architecture in button text to help users choose the correct installer
- Fixed fallback version in api.ts for local development without GitHub token

Fixes ddev/ddev#7900

🤖 Developed with assistance from [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
@github-actions
Copy link

github-actions bot commented Dec 2, 2025

🌐 Fork Preview for PR #483

https://pr-483.ddev-com-fork-previews.pages.dev

This preview updates automatically when you push changes to your fork.

Forked PR previews now have access to GitHub API through the read-only GITHUB_TOKEN, allowing the build to fetch the latest DDEV release version instead of using the fallback version.

This ensures the Windows installer download buttons on the quickstart page show the current release version in forked PR previews.

🤖 Developed with assistance from [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
Comment on lines 32 to 33
# GitHub token for API access (read-only, safe for forked PRs)
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
Copy link
Member

Choose a reason for hiding this comment

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

It changed nothing, GITHUB_TOKEN won't be passed here.

Copy link
Member

@stasadev stasadev left a comment

Choose a reason for hiding this comment

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

I changed the buttons, before:

image

After (centered text, equal width, details on hover):

image

@stasadev stasadev force-pushed the 20251202_get_started_windows branch from aa777dc to 4260513 Compare December 3, 2025 11:37
@stasadev stasadev force-pushed the 20251202_get_started_windows branch from d988639 to b26d00f Compare December 3, 2025 13:54
@stasadev
Copy link
Member

stasadev commented Dec 3, 2025

@stasadev stasadev changed the title Add ARM64 Windows installer option to quickstart, for ddev/ddev#7900 Add Download page, add ARM64 Windows installer option to quickstart, for ddev/ddev#7524 Dec 3, 2025
@rfay
Copy link
Member Author

rfay commented Dec 3, 2025

This is absolutely fantastic, a huge step forward that we should have taken long ago. I'll let you push forward.

  • Please make current release a link and say "release notes" instead of just the version.
  • At the top, link to ddev.com/get-started (quick instructions) and install docs (full instructions)
  • Windows installer section should say "WSL2 and Traditional Windows"
  • Please say "most (except on Windows) should use package managers like Homebrew (macOS) and apt (Ubuntu)"
  • macOS should come first in the list, maybe Windows second? But definitely macOS first.
  • I guess we should add links to the WIndows PowerShell scripts in /scripts (raw links?)

This is huge, thank you!

@stasadev
Copy link
Member

stasadev commented Dec 3, 2025

All comments have been addressed, and I made it more compact.

@stasadev
Copy link
Member

stasadev commented Dec 3, 2025

I added the "Download" link to the header as well.

These days, it is very common to look for a "Download" button on any product page, and DDEV was missing that.

Copy link
Member Author

@rfay rfay left a comment

Choose a reason for hiding this comment

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

Fantastic, thanks. Not entirely sure my suggested edit for direct link to install is correct, that's complex territory.

@rfay
Copy link
Member Author

rfay commented Dec 3, 2025

Please pull when ready, thanks!

@stasadev stasadev merged commit 6daf72c into ddev:main Dec 3, 2025
4 checks passed
@github-actions
Copy link

github-actions bot commented Dec 3, 2025

PR closed. The Cloudflare Pages preview is no longer updated.

@stasadev stasadev deleted the 20251202_get_started_windows branch December 19, 2025 17:35
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.

2 participants