Why does Shopify CLI get stuck at 99% when syncing theme?

Technical Q&A

Topic summary

A user encountered an issue where Shopify CLI freezes at 99% during theme syncing when running the shopify theme serve command.

Resolution for macOS: The original poster resolved the problem by running brew upgrade to update their Homebrew packages.

Windows 11 workaround: Another user on Windows 11 (without Homebrew access) reported the same issue with Shopify CLI version 3.0. They found success by using the shopify theme dev command instead of shopify theme serve.

The thread suggests this may be related to outdated CLI versions or dependencies, with different solutions needed depending on the operating system.

Summarized with AI on November 25. AI used: claude-sonnet-4-5-20250929.
1

Hello,

I am having an issue where Shopify CLI gets stuck at 99% while Syncing Theme when running “shopify theme serve.”

Screen Shot 2022-08-24 at 11.25.24 AM.png
Screen Shot 2022-08-24 at 11.25.24 AM.png1607×239 15.7 KB

2

solved this issue by running ‘brew upgrade’

3

Hi Sir,

Same problem here and unfortunatelly I don’t have brew because I’m on win11.

I use shopify-cli version 3.0 so i run the command ‘shopify theme dev’, instead of ‘shopify theme serve’.

Any suggestion?

Many thanks!

1 Like