[Bug]: Theme commands hitting network issues

[graygilmore]

This serves as the main issue for network-related problems that have been hindering developers using theme commands (in particular theme dev and theme push). We're going to colocate all problems here to make sure we have a single point of entry.

Known Issues

GraphQL requests fail

There are a few specific issues that we're currently tracking:

No reason:

Failed to perform the initial theme synchronization.
request to https://<shop>.myshopify.com/admin/api/2025-04/graphql.json failed, reason:

Timeout:

request to https://<shop>.myshopify.com/admin/api/unstable/themes.json failed, 
reason: read ETIMEDOUT

Error while polling for changes.  
request to https://<shop>.myshopify.com/admin/api/2025-04/graphql.json failed, reason: 
AggregateError [ETIMEDOUT]

TLS:

request to https://<shop>.myshopify.com/admin/api/2025-04/graphql.json failed,
reason: Client network socket disconnected before secure TLS connection was established  

Large themes

Some large themes are also potentially experiencing either exacerbated issues of the above or different issues altogether like hanging on theme dev due to a separate Liquid parsing issue.

How to help

If you'd like to provide a comment on this issue please make sure to include important information like:

• Verbose logs, please use the following format to keep the logs condensed:

  <details>
      <summary>Verbose output</summary>
      ```
      your logs here
      ```
  </details>
  

• (Optional) Your location, network connection, and any other additional pieces like VPN, hotspot, etc (we're trying to understand if this is a latency issue of some kind)

[mcnabsystems]

I'm glad it isn't just me, having a nightmare yesterday and today with both theme dev and theme push, tried downgrading the CLI to various past versions to no effect. My error seems to stem from a very slow connection to graphql.json;

Verbose output

` 2025-07-04T07:43:48.801Z: Request to https://performancelab-dev.myshopify.com/admin/api/2025-07/graphql.json completed in 31621 ms
With response headers:

error

Failed to perform the initial theme synchronization.

The user aborted a request. `

File changes are being successfully pushed to the theme despite the error being thrown. The commands appear to work (but slowly) the error is thrown afterwards when it fails to access graphql.json again.

Also had to use ThemeKit to upload a large theme, the CLI kept failing with The user aborted a request.

Based in UK, not using a VPN.