Fix check and upload failures
Start with the first check error
One malformed source file can cause later references to fail. Repair the earliest root error, run theme check again and continue until the authored package passes.
Forbidden file or folder
Only supported authored paths belong in theme/. Move tests and development tooling outside it. Generated output belongs under .upstorr-theme/. Do not add src/, node_modules/ or server code to the theme source.
Forbidden import or platform request
Import only @upstorr/theme-sdk/v1 from Upstorr. Replace direct platform calls with a documented SDK action. A missing SDK feature requires a shared platform addition.
Upload connection failure
Reconnect with a current permitted development secret, run the check again and retry the upload.
Upload succeeded but nothing changed live
This is expected. Upload creates a draft theme or an available update. The merchant must review and publish it in Admin.
Visual bug after a passing check
The checker proves structure, not design quality. Return to Workbench and test the affected route on mobile and desktop with real development-store data.